The Font class represents fonts, which are used to render text in a visible way. A font provides the information needed to map sequences of characters to sequences of glyphs and to render sequences of glyphs on Graphics and Component objects.

Characters and Glyphs

A character is a symbol that represents an item such as a letter, a digit, or punctuation in an abstract way. For example, 'g' , LATIN SMALL LETTER G, is a character. A glyph is a shape used to render a character or a sequence of characters. In simple writing systems, such as Latin, typically one glyph represents one character. In general, however, characters and glyphs do not have one-to-one correspondence. For example, the character 'á' LATIN SMALL LETTER A WITH ACUTE, can be represented by two glyphs: one for 'a' and one for '´'. On the other hand, the two-character string "fi" can be represented by a single glyph, an "fi" ligature. In complex writing systems, such as Arabic or the South and South-East Asian writing systems, the relationship between characters and glyphs can be more complicated and involve context-dependent selection of glyphs as well as glyph reordering. A font encapsulates the collection of glyphs needed to render a selected set of characters as well as the tables needed to map sequences of characters to corresponding sequences of glyphs.

Physical and Logical Fonts

The Java Platform distinguishes between two kinds of fonts: physical fonts and logical fonts. Physical fonts are the actual font libraries containing glyph data and tables to map from character sequences to glyph sequences, using a font technology such as TrueType or PostScript Type 1. All implementations of the Java Platform must support TrueType fonts; support for other font technologies is implementation dependent. Physical fonts may use names such as Helvetica, Palatino, HonMincho, or any number of other font names. Typically, each physical font supports only a limited set of writing systems, for example, only Latin characters or only Japanese and Basic Latin. The set of available physical fonts varies between configurations. Applications that require specific fonts can bundle them and instantiate them using the createFont method. Logical fonts are the five font families defined by the Java platform which must be supported by any Java runtime environment: Serif, SansSerif, Monospaced, Dialog, and DialogInput. These logical fonts are not actual font libraries. Instead, the logical font names are mapped to physical fonts by the Java runtime environment. The mapping is implementation and usually locale dependent, so the look and the metrics provided by them vary. Typically, each logical font name maps to several physical fonts in order to cover a large range of characters. Peered AWT components, such as Label and TextField , can only use logical fonts. For a discussion of the relative advantages and disadvantages of using physical or logical fonts, see the Internationalization FAQ document.

Font Faces and Names

A Font can have many faces, such as heavy, medium, oblique, gothic and regular. All of these faces have similar typographic design. There are three different names that you can get from a Font object. The logical font name is simply the name that was used to construct the font. The font face name , or just font name for short, is the name of a particular font face, like Helvetica Bold. The family name is the name of the font family that determines the typographic design across several faces, like Helvetica. The Font class represents an instance of a font face from a collection of font faces that are present in the system resources of the host system. As examples, Arial Bold and Courier Bold Italic are font faces. There can be several Font objects associated with a font face, each differing in size, style, transform and font features. The getAllFonts method of the GraphicsEnvironment class returns an array of all font faces available in the system. These font faces are returned as Font objects with a size of 1, identity transform and default font features. These base fonts can then be used to derive new Font objects with varying sizes, styles, transforms and font features via the deriveFont methods in this class.

Font and TextAttribute

Font supports most TextAttribute s. This makes some operations, such as rendering underlined text, convenient since it is not necessary to explicitly construct a TextLayout object. Attributes can be set on a Font by constructing or deriving it using a Map of TextAttribute values.

The values of some TextAttributes are not serializable, and therefore attempting to serialize an instance of Font that has such values will not serialize them. This means a Font deserialized from such a stream will not compare equal to the original Font that contained the non-serializable attributes. This should very rarely pose a problem since these attributes are typically used only in special circumstances and are unlikely to be serialized.

FOREGROUND and BACKGROUND use Paint values. The subclass Color is serializable, while GradientPaint and TexturePaint are not.

CHAR_REPLACEMENT uses GraphicAttribute values. The subclasses ShapeGraphicAttribute and ImageGraphicAttribute are not serializable.

INPUT_METHOD_HIGHLIGHT uses InputMethodHighlight values, which are not serializable. See InputMethodHighlight .

Clients who create custom subclasses of Paint and GraphicAttribute can make them serializable and avoid this problem. Clients who use input method highlights can convert these to the platform-specific attributes for that highlight on the current platform and set them on the Font as a workaround.

The Map -based constructor and deriveFont APIs ignore the FONT attribute, and it is not retained by the Font; the static getFont(java.util.Map<? extends java.text.AttributedCharacterIterator.Attribute, ?>) method should be used if the FONT attribute might be present. See TextAttribute.FONT for more information.

Several attributes will cause additional rendering overhead and potentially invoke layout. If a Font has such attributes, the hasLayoutAttributes() method will return true.

Note: Font rotations can cause text baselines to be rotated. In order to account for this (rare) possibility, font APIs are specified to return metrics and take parameters 'in baseline-relative coordinates'. This maps the 'x' coordinate to the advance along the baseline, (positive x is forward along the baseline), and the 'y' coordinate to a distance along the perpendicular to the baseline at 'x' (positive y is 90 degrees clockwise from the baseline vector). APIs for which this is especially important are called out as having 'baseline-relative coordinates.'

The baseline used in ideographic scripts like Chinese, Japanese, and Korean when laying out text.

A String constant for the canonical family name of the logical font "Dialog".

A String constant for the canonical family name of the logical font "DialogInput".

The baseline used in Devanigiri and similar scripts when laying out text.

The italicized style constant.

A flag to layoutGlyphVector indicating that text is left-to-right as determined by Bidi analysis.

A flag to layoutGlyphVector indicating that text in the char array after the indicated limit should not be examined.

A flag to layoutGlyphVector indicating that text in the char array before the indicated start should not be examined.

A flag to layoutGlyphVector indicating that text is right-to-left as determined by Bidi analysis.

A String constant for the canonical family name of the logical font "Monospaced".

The logical name of this Font , as passed to the constructor.

The plain style constant.

The point size of this Font in float .

The baseline used in most Roman scripts when laying out text.

A String constant for the canonical family name of the logical font "SansSerif".

A String constant for the canonical family name of the logical font "Serif".

The point size of this Font , rounded to integer.

The style of this Font , as passed to the constructor.

Identify a font resource of type TRUETYPE.

Identify a font resource of type TYPE1.

Checks if this Font has a glyph for the specified character.

Checks if this Font has a glyph for the specified character.

Indicates whether or not this Font can display the characters in the specified text starting at start and ending at limit .

Indicates whether or not this Font can display the text specified by the iter starting at start and ending at limit .

Indicates whether or not this Font can display a specified String .

Returns a new Font using the specified font type and the specified font file.

Returns a new Font using the specified font type and input data.

Creates a GlyphVector by mapping characters to glyphs one-to-one based on the Unicode cmap in this Font .

Creates a GlyphVector by mapping the specified characters to glyphs one-to-one based on the Unicode cmap in this Font .

Creates a GlyphVector by mapping characters to glyphs one-to-one based on the Unicode cmap in this Font .

Creates a GlyphVector by mapping characters to glyphs one-to-one based on the Unicode cmap in this Font .

Returns the Font that the str argument describes.

Creates a new Font object by replicating the current Font object and applying a new transform to it.

Creates a new Font object by replicating the current Font object and applying a new size to it.

Creates a new Font object by replicating the current Font object and applying a new style to it.

Creates a new Font object by replicating this Font object and applying a new style and transform.

Creates a new Font object by replicating this Font object and applying a new style and size.

Creates a new Font object by replicating the current Font object and applying a new set of font attributes to it.

Compares this Font object to the specified Object .

Returns a map of font attributes available in this Font .

Returns the keys of all the attributes supported by this Font .

Returns the baseline appropriate for displaying this character.

Returns the family name of this Font .

Returns the family name of this Font , localized for the specified locale.

Returns a Font appropriate to the attributes.

Returns a Font object from the system properties list.

Gets the specified Font from the system properties list.

Returns the font face name of this Font .

Returns the font face name of the Font , localized for the specified locale.

Returns the italic angle of this Font .

Returns a LineMetrics object created with the specified arguments.

Returns a LineMetrics object created with the specified arguments.

Returns a LineMetrics object created with the specified String and FontRenderContext .

Returns a LineMetrics object created with the specified arguments.

Returns the bounds for the character with the maximum bounds as defined in the specified FontRenderContext .

Returns the glyphCode which is used when this Font does not have a glyph for a specified unicode code point.

Returns the logical name of this Font .

Returns the number of glyphs in this Font .

Deprecated. int limit, FontRenderContext frc) Rectangle2D getStringBounds ( CharacterIterator ci, int beginIndex, int limit, FontRenderContext frc) Rectangle2D getStringBounds ( String str, FontRenderContext frc) Rectangle2D getStringBounds ( String str, int beginIndex, int limit, FontRenderContext frc) getStyle () AffineTransform getTransform () hashCode () boolean hasLayoutAttributes () boolean hasUniformLineMetrics () boolean isBold () boolean isItalic () boolean isPlain () boolean isTransformed () GlyphVector layoutGlyphVector ( FontRenderContext frc, char[] text, int start, int limit, int flags) String toString ()

DIALOG

public static final String DIALOG

Since:

See Also:

Constant Field Values

DIALOG_INPUT

public static final String DIALOG_INPUT

Since:

See Also:

Constant Field Values

SANS_SERIF

public static final String SANS_SERIF

Since:

See Also:

Constant Field Values

SERIF

public static final String SERIF

Since:

See Also:

Constant Field Values

MONOSPACED

public static final String MONOSPACED

Since:

See Also:

Constant Field Values

public static final int BOLD

See Also:

Constant Field Values

ITALIC

public static final int ITALIC

See Also:

Constant Field Values

ROMAN_BASELINE

public static final int ROMAN_BASELINE

See Also:

Constant Field Values

CENTER_BASELINE

public static final int CENTER_BASELINE

See Also:

Constant Field Values

HANGING_BASELINE

public static final int HANGING_BASELINE

See Also:

Constant Field Values

TRUETYPE_FONT

public static final int TRUETYPE_FONT

Since:

See Also:

Constant Field Values

public static final int TYPE1_FONT

Since:

See Also:

Constant Field Values

protected int style

Since:

JDK1.0

See Also:

getStyle()

LAYOUT_LEFT_TO_RIGHT

public static final int LAYOUT_LEFT_TO_RIGHT

See Also:

Constant Field Values

LAYOUT_RIGHT_TO_LEFT

public static final int LAYOUT_RIGHT_TO_LEFT

See Also:

Constant Field Values

LAYOUT_NO_START_CONTEXT

public static final int LAYOUT_NO_START_CONTEXT

See Also:

Constant Field Values

LAYOUT_NO_LIMIT_CONTEXT

public static final int LAYOUT_NO_LIMIT_CONTEXT

See Also:

Constant Field Values

The font name can be a font face name or a font family name. It is used together with the style to find an appropriate font face. When a font family name is specified, the style argument is used to select the most appropriate face from the family. When a font face name is specified, the face's style and the style argument are merged to locate the best matching font from the same family. For example if face name "Arial Bold" is specified with style Font.ITALIC , the font system looks for a face in the "Arial" family that is bold and italic, and may associate the font instance with the physical font face "Arial Bold Italic". The style argument is merged with the specified face's style, not added or subtracted. This means, specifying a bold face and a bold style does not double-embolden the font, and specifying a bold face and a plain style does not lighten the font. If no face for the requested style can be found, the font system may apply algorithmic styling to achieve the desired style. For example, if ITALIC is requested, but no italic face is available, glyphs from the plain face may be algorithmically obliqued (slanted). Font name lookup is case insensitive, using the case folding rules of the US locale. If the name parameter represents something other than a logical font, i.e. is interpreted as a physical font face or family, and this cannot be mapped by the implementation to a physical font or a compatible alternative, then the font system will map the Font instance to "Dialog", such that for example, the family as reported by getFamily will be "Dialog".

Parameters:

name - the font name. This can be a font face name or a font family name, and may represent either a logical font or a physical font found in this GraphicsEnvironment . The family names for logical fonts are: Dialog, DialogInput, Monospaced, Serif, or SansSerif. Pre-defined String constants exist for all of these names, for example, DIALOG . If name is null , the logical font name of the new Font as returned by getName() is set to the name "Default".

style - the style constant for the Font The style argument is an integer bitmask that may be PLAIN , or a bitwise union of BOLD and/or ITALIC (for example, ITALIC or BOLD|ITALIC ). If the style argument does not conform to one of the expected integer bitmasks then the style is set to PLAIN .

size - the point size of the Font

Since:

JDK1.0

See Also:

GraphicsEnvironment.getAllFonts() , GraphicsEnvironment.getAvailableFontFamilyNames()

public Font(Map<? extends AttributedCharacterIterator.Attribute,?> attributes)

Parameters:

attributes - the attributes to assign to the new Font , or null

See Also:

TextAttribute

protected Font(Font font)

Parameters:

font - from which to create this Font .

Throws:

NullPointerException - if font is null

Since:

@Deprecated
public java.awt.peer.FontPeer getPeer()

Returns:

the peer of the Font .

Since:

JDK1.1

getFont

public static Font getFont(Map<? extends AttributedCharacterIterator.Attribute,?> attributes)

Parameters:

attributes - the attributes to assign to the new

Returns:

a new Font created with the specified attributes

Throws:

NullPointerException - if attributes is null.

Since:

See Also:

TextAttribute

public static Font createFont(int fontFormat,
                              InputStream fontStream)
                       throws FontFormatException,
                              IOException

Parameters:

fontFormat - the type of the Font , which is TRUETYPE_FONT if a TrueType resource is specified. or TYPE1_FONT if a Type 1 resource is specified.

fontStream - an InputStream object representing the input data for the font.

Returns:

a new Font created with the specified font type.

Throws:

IllegalArgumentException - if fontFormat is not TRUETYPE_FONT or TYPE1_FONT .

FontFormatException - if the fontStream data does not contain the required font tables for the specified format.

IOException - if the fontStream cannot be completely read.

Since:

See Also:

GraphicsEnvironment.registerFont(Font)

public static Font createFont(int fontFormat,
                              File fontFile)
                       throws FontFormatException,
                              IOException

Parameters:

fontFormat - the type of the Font , which is TRUETYPE_FONT if a TrueType resource is specified or TYPE1_FONT if a Type 1 resource is specified. So long as the returned font, or its derived fonts are referenced the implementation may continue to access fontFile to retrieve font data. Thus the results are undefined if the file is changed, or becomes inaccessible. To make the Font available to Font constructors the returned Font must be registered in the GraphicsEnviroment by calling registerFont(Font) .

fontFile - a File object representing the input data for the font.

Returns:

a new Font created with the specified font type.

Throws:

IllegalArgumentException - if fontFormat is not TRUETYPE_FONT or TYPE1_FONT .

NullPointerException - if fontFile is null.

IOException - if the fontFile cannot be read.

FontFormatException - if fontFile does not contain the required font tables for the specified format.

SecurityException - if the executing code does not have permission to read from the file.

Since:

See Also:

GraphicsEnvironment.registerFont(Font)

getTransform

public AffineTransform getTransform()

Returns:

an AffineTransform object representing the transform attribute of this Font object.

Returns:

a String that is the family name of this Font .

Since:

JDK1.1

See Also:

getName() , getFontName()

getFamily

public String getFamily(Locale l)

Parameters:

l - locale for which to get the family name

Returns:

a String representing the family name of the font, localized for the specified locale.

Since:

See Also:

getFontName() , Locale

public String getPSName()

Returns:

a String representing the postscript name of this Font .

Since:

public String getName()

Returns:

a String representing the logical name of this Font .

Since:

JDK1.0

See Also:

getFamily() , getFontName()

getFontName

public String getFontName()

Returns:

a String representing the font face name of this Font .

Since:

See Also:

getFamily() , getName()

getFontName

public String getFontName(Locale l)

Parameters:

l - a locale for which to get the font face name

Returns:

a String representing the font face name, localized for the specified locale.

See Also:

getFamily() , Locale

public int getStyle()

Returns:

the style of this Font

Since:

JDK1.0

See Also:

isPlain() , isBold() , isItalic()

Returns:

the point size of this Font in 1/72 of an inch units.

Since:

JDK1.0

See Also:

getSize2D() , GraphicsConfiguration.getDefaultTransform() , GraphicsConfiguration.getNormalizingTransform()

isTransformed

public boolean isTransformed()

Returns:

true if this Font object has a non-identity AffineTransform attribute. false otherwise.

Since:

See Also:

getTransform()

hasLayoutAttributes

public boolean hasLayoutAttributes()

Returns:

true if the font has layout attributes

Since:

getFont

public static Font getFont(String nm)

Parameters:

nm - the property name

Returns:

a Font object that the property name describes, or null if no such property exists.

Throws:

NullPointerException - if nm is null.

Since:

See Also:

decode(String)

public static Font decode(String str)

Parameters:

str - the name of the font, or null

Returns:

the Font object that str describes, or a new default Font if str is null .

Since:

JDK1.1

See Also:

getFamily()

public static Font getFont(String nm,
                           Font font)

Parameters:

nm - the case-insensitive property name

font - a default Font to return if property nm is not defined

Returns:

the Font value of the property.

Throws:

NullPointerException - if nm is null.

See Also:

decode(String)

true if the objects are the same or if the argument is a Font object describing the same font as this object; false otherwise.

Since:

JDK1.0

See Also:

Object.hashCode() , HashMap

getNumGlyphs

public int getNumGlyphs()

Returns:

the number of glyphs in this Font .

Since:

getMissingGlyphCode

public int getMissingGlyphCode()

Returns:

the glyphCode of this Font .

Since:

getBaselineFor

public byte getBaselineFor(char c)

Parameters:

c - a character used to identify the writing system

Returns:

the baseline appropriate for the specified character.

Since:

See Also:

LineMetrics.getBaselineOffsets() , ROMAN_BASELINE , CENTER_BASELINE , HANGING_BASELINE

getAttributes

public Map<TextAttribute,?> getAttributes()

Returns:

the attributes map of this Font .

getAvailableAttributes

public AttributedCharacterIterator.Attribute[] getAvailableAttributes()

Returns:

an array containing the keys of all the attributes supported by this Font .

Since:

public Font deriveFont(int style,
                       float size)

Parameters:

style - the style for the new Font

size - the size for the new Font

Returns:

a new Font object.

Since:

public Font deriveFont(int style,
                       AffineTransform trans)

Parameters:

style - the style for the new Font

trans - the AffineTransform associated with the new Font

Returns:

a new Font object.

Throws:

IllegalArgumentException - if trans is

Since:

deriveFont

public Font deriveFont(float size)

Parameters:

size - the size for the new Font .

Returns:

a new Font object.

Since:

deriveFont

public Font deriveFont(AffineTransform trans)

Parameters:

trans - the AffineTransform associated with the new Font

Returns:

a new Font object.

Throws:

IllegalArgumentException - if trans is

Since:

deriveFont

public Font deriveFont(int style)

Parameters:

style - the style for the new Font

Returns:

a new Font object.

Since:

deriveFont

public Font deriveFont(Map<? extends AttributedCharacterIterator.Attribute,?> attributes)

Parameters:

attributes - a map of attributes enabled for the new

Returns:

a new Font object.

Since:

canDisplay

public boolean canDisplay(char c)

Parameters:

c - the character for which a glyph is needed

Returns:

true if this Font has a glyph for this character; false otherwise.

Since:

canDisplay

public boolean canDisplay(int codePoint)

Parameters:

codePoint - the character (Unicode code point) for which a glyph is needed.

Returns:

true if this Font has a glyph for the character; false otherwise.

Throws:

IllegalArgumentException - if the code point is not a valid Unicode code point.

Since:

See Also:

Character.isValidCodePoint(int)

canDisplayUpTo

public int canDisplayUpTo(String str)

Parameters:

str - a String object

Returns:

an offset into str that points to the first character in str that this Font cannot display; or -1 if this Font can display all characters in str .

Since:

int limit)

Parameters:

text - the specified array of char values

start - the specified starting offset (in char s) into the specified array of char values

limit - the specified ending offset (in char s) into the specified array of char values

Returns:

an offset into text that points to the first character in text that this Font cannot display; or -1 if this Font can display all characters in text .

Since:

int limit)

Parameters:

iter - a CharacterIterator object

start - the specified starting offset into the specified CharacterIterator .

limit - the specified ending offset into the specified CharacterIterator .

Returns:

an offset into iter that points to the first character in iter that this Font cannot display; or -1 if this Font can display all characters in iter .

Since:

getItalicAngle

public float getItalicAngle()

Returns:

the angle of the ITALIC style of this Font .

See Also:

TextAttribute.POSTURE

hasUniformLineMetrics

public boolean hasUniformLineMetrics()

Returns:

true if this Font has uniform line metrics; false otherwise.

public LineMetrics getLineMetrics(String str,
                                  FontRenderContext frc)

Parameters:

str - the specified String

frc - the specified FontRenderContext

Returns:

a LineMetrics object created with the specified String and FontRenderContext .

str - the specified String

beginIndex - the initial offset of str

limit - the end offset of str

frc - the specified FontRenderContext

Returns:

a LineMetrics object created with the specified arguments.

chars - an array of characters

beginIndex - the initial offset of chars

limit - the end offset of chars

frc - the specified FontRenderContext

Returns:

a LineMetrics object created with the specified arguments.

ci - the specified CharacterIterator

beginIndex - the initial offset in ci

limit - the end offset of ci

frc - the specified FontRenderContext

Returns:

a LineMetrics object created with the specified arguments.

public Rectangle2D getStringBounds(String str,
                                   FontRenderContext frc)

Parameters:

str - the specified String

frc - the specified FontRenderContext

Returns:

a Rectangle2D that is the bounding box of the specified String in the specified FontRenderContext .

Since:

See Also:

FontRenderContext , createGlyphVector(java.awt.font.FontRenderContext, java.lang.String)

FontRenderContext frc)

Parameters:

str - the specified String

beginIndex - the initial offset of str

limit - the end offset of str

frc - the specified FontRenderContext

Returns:

a Rectangle2D that is the bounding box of the specified String in the specified FontRenderContext .

Throws:

IndexOutOfBoundsException - if beginIndex is less than zero, or limit is greater than the length of str , or beginIndex is greater than limit .

Since:

See Also:

FontRenderContext , createGlyphVector(java.awt.font.FontRenderContext, java.lang.String)

int limit, FontRenderContext frc)

Parameters:

chars - an array of characters

beginIndex - the initial offset in the array of characters

limit - the end offset in the array of characters

frc - the specified FontRenderContext

Returns:

a Rectangle2D that is the bounding box of the specified array of characters in the specified FontRenderContext .

Throws:

IndexOutOfBoundsException - if beginIndex is less than zero, or limit is greater than the length of chars , or beginIndex is greater than limit .

Since:

See Also:

FontRenderContext , createGlyphVector(java.awt.font.FontRenderContext, java.lang.String)

getStringBounds

public Rectangle2D getStringBounds(CharacterIterator ci,
                                   int beginIndex,
                                   int limit,
                                   FontRenderContext frc)

Parameters:

ci - the specified CharacterIterator

beginIndex - the initial offset in ci

limit - the end offset in ci

frc - the specified FontRenderContext

Returns:

a Rectangle2D that is the bounding box of the characters indexed in the specified CharacterIterator in the specified FontRenderContext .

Throws:

IndexOutOfBoundsException - if beginIndex is less than the start index of ci , or limit is greater than the end index of ci , or beginIndex is greater than limit

Since:

See Also:

FontRenderContext , createGlyphVector(java.awt.font.FontRenderContext, java.lang.String)

getMaxCharBounds

public Rectangle2D getMaxCharBounds(FontRenderContext frc)

Parameters:

frc - the specified FontRenderContext

Returns:

a Rectangle2D that is the bounding box for the character with the maximum bounds.

createGlyphVector

public GlyphVector createGlyphVector(FontRenderContext frc,
                                     String str)

Parameters:

frc - the specified FontRenderContext

str - the specified String

Returns:

a new GlyphVector created with the specified String and the specified FontRenderContext .

createGlyphVector

public GlyphVector createGlyphVector(FontRenderContext frc,
                                     char[] chars)

Parameters:

frc - the specified FontRenderContext

chars - the specified array of characters

Returns:

a new GlyphVector created with the specified array of characters and the specified FontRenderContext .

createGlyphVector

public GlyphVector createGlyphVector(FontRenderContext frc,
                                     CharacterIterator ci)

Parameters:

frc - the specified FontRenderContext

ci - the specified CharacterIterator

Returns:

a new GlyphVector created with the specified CharacterIterator and the specified FontRenderContext .

createGlyphVector

public GlyphVector createGlyphVector(FontRenderContext frc,
                                     int[] glyphCodes)

Parameters:

frc - the specified FontRenderContext

glyphCodes - the specified integer array

Returns:

a new GlyphVector created with the specified integer array and the specified FontRenderContext .

layoutGlyphVector

public GlyphVector layoutGlyphVector(FontRenderContext frc,
                                     char[] text,
                                     int start,
                                     int limit,
                                     int flags)

Parameters:

frc - the specified FontRenderContext

text - the text to layout

start - the start of the text to use for the GlyphVector

limit - the limit of the text to use for the GlyphVector

flags - control flags as described above

Returns:

a new GlyphVector representing the text between start and limit, with glyphs chosen and positioned so as to best represent the text

Throws:

ArrayIndexOutOfBoundsException - if start or limit is out of bounds

Since:

See Also:

Bidi , LAYOUT_LEFT_TO_RIGHT , LAYOUT_RIGHT_TO_LEFT , LAYOUT_NO_START_CONTEXT , LAYOUT_NO_LIMIT_CONTEXT