org.apache.fop.render.afp.fonts
Class CharacterSet
java.lang.Object
org.apache.fop.render.afp.fonts.CharacterSet
public class CharacterSet
extends java.lang.Object
The IBM Font Object Content Architecture (FOCA) supports presentation
of character shapes by defining their characteristics, which include
font description information for identifying the characters, font metric
information for positioning the characters, and character shape information
for presenting the character images.
Presenting a graphic character on a presentation surface requires
information on the rotation and position of character on the physical
or logical page.
This class proivdes font metric information for a particular font
as identified by the character set name. This information is obtained
directly from the AFP font files which must be installed in the path
specified in the afp-fonts xml definition file.
protected String | _codePage - The code page to which the character set relates
|
protected String | _encoding - The encoding used for the code page
|
protected String | _name - The character set relating to the font
|
protected String | _path - The path to the installed fonts
|
protected static Log | log - Static logging instance
|
CharacterSet(String codePage, String encoding, String name, String path) - Constructor for the CharacterSetMetric object, the character set is used
to load the font information from the actual AFP font.
|
void | addCharacterSetOrientation(CharacterSetOrientation cso) - Add character set metric information for the different orientations
|
int | getAscender() - Ascender height is the distance from the character baseline to the
top of the character box.
|
int | getCapHeight() - Cap height is the average height of the uppercase characters in
a font.
|
String | getCodePage() - Returns the AFP code page identifier
|
int | getDescender() - Descender depth is the distance from the character baseline to
the bottom of a character box.
|
String | getEncoding() - Returns the AFP code page encoding
|
int | getFirstChar() - The first character in the character set
|
int | getLastChar() - The last character in the character set
|
String | getName() - Returns the AFP character set identifier
|
byte[] | getNameBytes() - Returns the AFP character set identifier
|
String | getPath()
|
int[] | getWidths() - Get the width (in 1/1000ths of a point size) of all characters
|
int | getXHeight() - XHeight refers to the height of the lower case letters above the baseline.
|
char | mapChar(char c) - Map a Unicode character to a code point in the font.
|
int | width(int character) - Get the width (in 1/1000ths of a point size) of the character
identified by the parameter passed.
|
_codePage
protected String _codePage
The code page to which the character set relates
_encoding
protected String _encoding
The encoding used for the code page
_name
protected String _name
The character set relating to the font
_path
protected String _path
The path to the installed fonts
log
protected static final Log log
Static logging instance
CharacterSet
public CharacterSet(String codePage,
String encoding,
String name,
String path)
Constructor for the CharacterSetMetric object, the character set is used
to load the font information from the actual AFP font.
codePage
- the code page identifierencoding
- the encoding of the fontname
- the character set namepath
- the path to the installed afp fonts
addCharacterSetOrientation
public void addCharacterSetOrientation(CharacterSetOrientation cso)
Add character set metric information for the different orientations
cso
- the metrics for the orientation
getAscender
public int getAscender()
Ascender height is the distance from the character baseline to the
top of the character box. A negative ascender height signifies that
all of the graphic character is below the character baseline. For
a character rotation other than 0, ascender height loses its
meaning when the character is lying on its side or is upside down
with respect to normal viewing orientation. For the general case,
Ascender Height is the character???s most positive y-axis value.
For bounded character boxes, for a given character having an
ascender, ascender height and baseline offset are equal.
- the ascender value in millipoints
getCapHeight
public int getCapHeight()
Cap height is the average height of the uppercase characters in
a font. This value is specified by the designer of a font and is
usually the height of the uppercase M.
- the cap height value in millipoints
getCodePage
public String getCodePage()
Returns the AFP code page identifier
getDescender
public int getDescender()
Descender depth is the distance from the character baseline to
the bottom of a character box. A negative descender depth signifies
that all of the graphic character is above the character baseline.
- the descender value in millipoints
getEncoding
public String getEncoding()
Returns the AFP code page encoding
getFirstChar
public int getFirstChar()
The first character in the character set
getLastChar
public int getLastChar()
The last character in the character set
getName
public String getName()
Returns the AFP character set identifier
getNameBytes
public byte[] getNameBytes()
Returns the AFP character set identifier
getPath
public String getPath()
- the path where the font resources are installed
getWidths
public int[] getWidths()
Get the width (in 1/1000ths of a point size) of all characters
- the widths of all characters
getXHeight
public int getXHeight()
XHeight refers to the height of the lower case letters above the baseline.
- the typical height of characters
mapChar
public char mapChar(char c)
Map a Unicode character to a code point in the font.
The code tables are already converted to Unicode therefore
we can use the identity mapping.
width
public int width(int character)
Get the width (in 1/1000ths of a point size) of the character
identified by the parameter passed.
character
- the character from which the width will be calculated
- the width of the character
Copyright 1999-2007 The Apache Software Foundation. All Rights Reserved.