- java.lang.Object
-
- java.awt.font.GlyphMetrics
-
public final class GlyphMetrics extends Object
TheGlyphMetrics
class represents infomation for a single glyph. A glyph is the visual representation of one or more characters. Many different glyphs can be used to represent a single character or combination of characters.GlyphMetrics
instances are produced byFont
and are applicable to a specific glyph in a particularFont
.Glyphs are either STANDARD, LIGATURE, COMBINING, or COMPONENT.
- STANDARD glyphs are commonly used to represent single characters.
- LIGATURE glyphs are used to represent sequences of characters.
- COMPONENT glyphs in a
GlyphVector
do not correspond to a particular character in a text model. Instead, COMPONENT glyphs are added for typographical reasons, such as Arabic justification. - COMBINING glyphs embellish STANDARD or LIGATURE glyphs, such as accent marks. Carets do not appear before COMBINING glyphs.
Other metrics available through
GlyphMetrics
are the components of the advance, the visual bounds, and the left and right side bearings.Glyphs for a rotated font, or obtained from a
GlyphVector
which has applied a rotation to the glyph, can have advances that contain both X and Y components. Usually the advance only has one component.The advance of a glyph is the distance from the glyph's origin to the origin of the next glyph along the baseline, which is either vertical or horizontal. Note that, in a
GlyphVector
, the distance from a glyph to its following glyph might not be the glyph's advance, because of kerning or other positioning adjustments.The bounds is the smallest rectangle that completely contains the outline of the glyph. The bounds rectangle is relative to the glyph's origin. The left-side bearing is the distance from the glyph origin to the left of its bounds rectangle. If the left-side bearing is negative, part of the glyph is drawn to the left of its origin. The right-side bearing is the distance from the right side of the bounds rectangle to the next glyph origin (the origin plus the advance). If negative, part of the glyph is drawn to the right of the next glyph's origin. Note that the bounds does not necessarily enclose all the pixels affected when rendering the glyph, because of rasterization and pixel adjustment effects.
Although instances of
GlyphMetrics
can be directly constructed, they are almost always obtained from aGlyphVector
. Once constructed,GlyphMetrics
objects are immutable.Example:
Querying a
Font
for glyph informationFont font = ...; int glyphIndex = ...; GlyphMetrics metrics = GlyphVector.getGlyphMetrics(glyphIndex); int isStandard = metrics.isStandard(); float glyphAdvance = metrics.getAdvance();
- See Also:
Font
,GlyphVector
-
-
Field Summary
Fields Modifier and Type Field and Description static byte
COMBINING
Indicates a glyph that represents a combining character, such as an umlaut.static byte
COMPONENT
Indicates a glyph with no corresponding character in the backing store.static byte
LIGATURE
Indicates a glyph that represents multiple characters as a ligature, for example 'fi' or 'ffi'.static byte
STANDARD
Indicates a glyph that represents a single standard character.static byte
WHITESPACE
Indicates a glyph with no visual representation.
-
Constructor Summary
Constructors Constructor and Description GlyphMetrics(boolean horizontal, float advanceX, float advanceY, Rectangle2D bounds, byte glyphType)
Constructs aGlyphMetrics
object.GlyphMetrics(float advance, Rectangle2D bounds, byte glyphType)
Constructs aGlyphMetrics
object.
-
Method Summary
Methods Modifier and Type Method and Description float
getAdvance()
Returns the advance of the glyph along the baseline (either horizontal or vertical).float
getAdvanceX()
Returns the x-component of the advance of the glyph.float
getAdvanceY()
Returns the y-component of the advance of the glyph.Rectangle2D
getBounds2D()
Returns the bounds of the glyph.float
getLSB()
Returns the left (top) side bearing of the glyph.float
getRSB()
Returns the right (bottom) side bearing of the glyph.int
getType()
Returns the raw glyph type code.boolean
isCombining()
Returnstrue
if this is a combining glyph.boolean
isComponent()
Returnstrue
if this is a component glyph.boolean
isLigature()
Returnstrue
if this is a ligature glyph.boolean
isStandard()
Returnstrue
if this is a standard glyph.boolean
isWhitespace()
Returnstrue
if this is a whitespace glyph.
-
-
-
Field Detail
-
STANDARD
public static final byte STANDARD
Indicates a glyph that represents a single standard character.- See Also:
- Constant Field Values
-
LIGATURE
public static final byte LIGATURE
Indicates a glyph that represents multiple characters as a ligature, for example 'fi' or 'ffi'. It is followed by filler glyphs for the remaining characters. Filler and combining glyphs can be intermixed to control positioning of accent marks on the logically preceeding ligature.- See Also:
- Constant Field Values
-
COMBINING
public static final byte COMBINING
Indicates a glyph that represents a combining character, such as an umlaut. There is no caret position between this glyph and the preceeding glyph.- See Also:
- Constant Field Values
-
COMPONENT
public static final byte COMPONENT
Indicates a glyph with no corresponding character in the backing store. The glyph is associated with the character represented by the logicaly preceeding non-component glyph. This is used for kashida justification or other visual modifications to existing glyphs. There is no caret position between this glyph and the preceeding glyph.- See Also:
- Constant Field Values
-
WHITESPACE
public static final byte WHITESPACE
Indicates a glyph with no visual representation. It can be added to the other code values to indicate an invisible glyph.- See Also:
- Constant Field Values
-
-
Constructor Detail
-
GlyphMetrics
public GlyphMetrics(float advance, Rectangle2D bounds, byte glyphType)
Constructs aGlyphMetrics
object.- Parameters:
advance
- the advance width of the glyphbounds
- the black box bounds of the glyphglyphType
- the type of the glyph
-
GlyphMetrics
public GlyphMetrics(boolean horizontal, float advanceX, float advanceY, Rectangle2D bounds, byte glyphType)
Constructs aGlyphMetrics
object.- Parameters:
horizontal
- if true, metrics are for a horizontal baseline, otherwise they are for a vertical baselineadvanceX
- the X-component of the glyph's advanceadvanceY
- the Y-component of the glyph's advancebounds
- the visual bounds of the glyphglyphType
- the type of the glyph- Since:
- 1.4
-
-
Method Detail
-
getAdvance
public float getAdvance()
Returns the advance of the glyph along the baseline (either horizontal or vertical).- Returns:
- the advance of the glyph
-
getAdvanceX
public float getAdvanceX()
Returns the x-component of the advance of the glyph.- Returns:
- the x-component of the advance of the glyph
- Since:
- 1.4
-
getAdvanceY
public float getAdvanceY()
Returns the y-component of the advance of the glyph.- Returns:
- the y-component of the advance of the glyph
- Since:
- 1.4
-
getBounds2D
public Rectangle2D getBounds2D()
Returns the bounds of the glyph. This is the bounding box of the glyph outline. Because of rasterization and pixel alignment effects, it does not necessarily enclose the pixels that are affected when rendering the glyph.- Returns:
- a
Rectangle2D
that is the bounds of the glyph.
-
getLSB
public float getLSB()
Returns the left (top) side bearing of the glyph.This is the distance from 0, 0 to the left (top) of the glyph bounds. If the bounds of the glyph is to the left of (above) the origin, the LSB is negative.
- Returns:
- the left side bearing of the glyph.
-
getRSB
public float getRSB()
Returns the right (bottom) side bearing of the glyph.This is the distance from the right (bottom) of the glyph bounds to the advance. If the bounds of the glyph is to the right of (below) the advance, the RSB is negative.
- Returns:
- the right side bearing of the glyph.
-
getType
public int getType()
Returns the raw glyph type code.- Returns:
- the raw glyph type code.
-
isStandard
public boolean isStandard()
Returnstrue
if this is a standard glyph.- Returns:
true
if this is a standard glyph;false
otherwise.
-
isLigature
public boolean isLigature()
Returnstrue
if this is a ligature glyph.- Returns:
true
if this is a ligature glyph;false
otherwise.
-
isCombining
public boolean isCombining()
Returnstrue
if this is a combining glyph.- Returns:
true
if this is a combining glyph;false
otherwise.
-
isComponent
public boolean isComponent()
Returnstrue
if this is a component glyph.- Returns:
true
if this is a component glyph;false
otherwise.
-
isWhitespace
public boolean isWhitespace()
Returnstrue
if this is a whitespace glyph.- Returns:
true
if this is a whitespace glyph;false
otherwise.
-
-
Nederlandse vertaling
U hebt gevraagd om deze site in het Nederlands te bezoeken. Voor nu wordt alleen de interface vertaald, maar nog niet alle inhoud.Als je me wilt helpen met vertalingen, is je bijdrage welkom. Het enige dat u hoeft te doen, is u op de site registreren en mij een bericht sturen waarin u wordt gevraagd om u toe te voegen aan de groep vertalers, zodat u de gewenste pagina's kunt vertalen. Een link onderaan elke vertaalde pagina geeft aan dat u de vertaler bent en heeft een link naar uw profiel.
Bij voorbaat dank.
Document heeft de 11/06/2005 gemaakt, de laatste keer de 04/03/2020 gewijzigd
Bron van het afgedrukte document:https://www.gaudry.be/nl/java-api-rf-java/awt/font/GlyphMetrics.html
De infobrol is een persoonlijke site waarvan de inhoud uitsluitend mijn verantwoordelijkheid is. De tekst is beschikbaar onder CreativeCommons-licentie (BY-NC-SA). Meer info op de gebruiksvoorwaarden en de auteur.
Referenties
Deze verwijzingen en links verwijzen naar documenten die geraadpleegd zijn tijdens het schrijven van deze pagina, of die aanvullende informatie kunnen geven, maar de auteurs van deze bronnen kunnen niet verantwoordelijk worden gehouden voor de inhoud van deze pagina.
De auteur Deze site is als enige verantwoordelijk voor de manier waarop de verschillende concepten, en de vrijheden die met de referentiewerken worden genomen, hier worden gepresenteerd. Vergeet niet dat u meerdere broninformatie moet doorgeven om het risico op fouten te verkleinen.