Modifier and Type	Class and Description
private static class	FontDesignMetrics.KeyReference
private static class	FontDesignMetrics.MetricsKey

Modifier and Type	Field and Description
private transient float[]	advCache
private float	ascent
private int[]	cache
private static final int	CURRENT_VERSION
private static FontRenderContext	DEFAULT_FRC Hides java.awt.FontMetrics.DEFAULT_FRC.
private float	descent
private transient double[]	devmatrix
private Font	font Hides java.awt.FontMetrics.font.
private transient FontStrike	fontStrike
private transient FontRenderContext	frc
private AffineTransform	frcTx
private transient int	height
private boolean	isAntiAliased
private float	leading
private double[]	matrix
private float	maxAdvance
private static final int	MAXRECENT
private static final ConcurrentHashMap<Object, FontDesignMetrics.KeyReference>	metricsCache
private static int	recentIndex
private static final FontDesignMetrics[]	recentMetrics
private static float	roundingUpValue
private static final long	serialVersionUID Hides java.awt.FontMetrics.serialVersionUID. Use serialVersionUID from JDK 1.3 for interoperability.
private int	serVersion
private static final float	UNKNOWN_WIDTH
private boolean	usesFractionalMetrics

Access	Constructor and Description
private	FontDesignMetrics(Font font)
private	FontDesignMetrics(Font font, FontRenderContext frc)

Method Summary

Modifier and Type	Method and Description
public int	charsWidth(char[] data, int off, int len) Overrides java.awt.FontMetrics.charsWidth. Returns the total advance width for showing the specified array of characters in this `Font`.
public int	charWidth(char ch) Overrides java.awt.FontMetrics.charWidth. Returns the advance width of the specified character in this `Font`.
public int	charWidth(int ch) Overrides java.awt.FontMetrics.charWidth. Returns the advance width of the specified character in this `Font`.
public int	getAscent() Overrides java.awt.FontMetrics.getAscent. Determines the font ascent of the `Font` described by this `FontMetrics` object.
private static FontRenderContext	getDefaultFrc()
public int	getDescent() Overrides java.awt.FontMetrics.getDescent. Determines the font descent of the `Font` described by this `FontMetrics` object.
public FontRenderContext	getFontRenderContext() Overrides java.awt.FontMetrics.getFontRenderContext. Gets the `FontRenderContext` used by this `FontMetrics` object to measure text.
public int	getHeight() Overrides java.awt.FontMetrics.getHeight. Gets the standard height of a line of text in this font.
private float	getLatinCharWidth(char ch)
public int	getLeading() Overrides java.awt.FontMetrics.getLeading. Determines the standard leading of the `Font` described by this `FontMetrics` object.
public int	getMaxAdvance() Overrides java.awt.FontMetrics.getMaxAdvance. Returns an estimate of the maximum advance width of any character in the `Font` described by this `FontMetrics` object, with important caveats, enumerated below.
public static FontDesignMetrics	getMetrics(Font font)
public static FontDesignMetrics	getMetrics(Font font, FontRenderContext frc)
public Rectangle2D	getSimpleBounds(char[] data, int off, int len) This method is called from java.awt.Font only after verifying the arguments and that the text is simple and there are no layout attributes, font transform etc.
public int[]	Returns: an array storing the advance widths of the characters in the `Font` described by this `FontMetrics` object. getWidths() Overrides java.awt.FontMetrics.getWidths. Gets the advance widths of the first 256 characters in the `Font`.
private float	handleCharWidth(int ch)
private void	initAdvCache()
private void	initMatrixAndMetrics()
private void	readObject(ObjectInputStream in)
public int	stringWidth(String str) Overrides java.awt.FontMetrics.stringWidth. Returns the total advance width for showing the specified `String` in this `Font`.
private void	writeObject(ObjectOutputStream out)

Inherited from java.awt.FontMetrics:: bytesWidth getFont getLineMetrics getLineMetrics getLineMetrics getLineMetrics getMaxAscent getMaxCharBounds getMaxDecent getMaxDescent getStringBounds getStringBounds getStringBounds getStringBounds hasUniformLineMetrics toString

Field Detail

advCache	back to summary
private transient float[] advCache

ascent	back to summary
private float ascent

cache	back to summary
private int[] cache

CURRENT_VERSION	back to summary
private static final int CURRENT_VERSION

DEFAULT_FRC	back to summary
private static FontRenderContext DEFAULT_FRC Hides java.awt.FontMetrics.DEFAULT_FRC.

descent	back to summary
private float descent

devmatrix	back to summary
private transient double[] devmatrix

font	back to summary
private Font font Hides java.awt.FontMetrics.font.

fontStrike	back to summary
private transient FontStrike fontStrike

frc	back to summary
private transient FontRenderContext frc

frcTx	back to summary
private AffineTransform frcTx

height	back to summary
private transient int height

isAntiAliased	back to summary
private boolean isAntiAliased

leading	back to summary
private float leading

matrix	back to summary
private double[] matrix

maxAdvance	back to summary
private float maxAdvance

MAXRECENT	back to summary
private static final int MAXRECENT

metricsCache	back to summary
private static final ConcurrentHashMap<Object, FontDesignMetrics.KeyReference> metricsCache

recentIndex	back to summary
private static int recentIndex

recentMetrics	back to summary
private static final FontDesignMetrics[] recentMetrics

roundingUpValue	back to summary
private static float roundingUpValue

serialVersionUID	back to summary
private static final long serialVersionUID Hides java.awt.FontMetrics.serialVersionUID. Use serialVersionUID from JDK 1.3 for interoperability. Annotations @Serial

serialVersionUID

back to summary

private static final long serialVersionUID

Hides java.awt.FontMetrics.serialVersionUID.

Use serialVersionUID from JDK 1.3 for interoperability.

Annotations

@Serial

serVersion	back to summary
private int serVersion

UNKNOWN_WIDTH	back to summary
private static final float UNKNOWN_WIDTH

usesFractionalMetrics	back to summary
private boolean usesFractionalMetrics

Constructor Detail

FontDesignMetrics	back to summary
private FontDesignMetrics(Font font)

FontDesignMetrics	back to summary
private FontDesignMetrics(Font font, FontRenderContext frc)

Method Detail

charsWidth back to summary

charsWidth	back to summary
public int charsWidth(char[] data, int off, int len) Overrides java.awt.FontMetrics.charsWidth. Doc from java.awt.FontMetrics.charsWidth. Returns the total advance width for showing the specified array of characters in this `Font`. The advance is the distance from the leftmost point to the rightmost point on the string's baseline. The advance of a `String` is not necessarily the sum of the advances of its characters. This is equivalent to measuring a `String` of the characters in the specified range.

public int charsWidth(char[] data, int off, int len)

Overrides java.awt.FontMetrics.charsWidth.

Doc from java.awt.FontMetrics.charsWidth.

Returns the total advance width for showing the specified array of characters in this Font. The advance is the distance from the leftmost point to the rightmost point on the string's baseline. The advance of a String is not necessarily the sum of the advances of its characters. This is equivalent to measuring a String of the characters in the specified range.

charWidth back to summary

charWidth	back to summary
public int charWidth(char ch) Overrides java.awt.FontMetrics.charWidth. Doc from java.awt.FontMetrics.charWidth. Returns the advance width of the specified character in this `Font`. The advance is the distance from the leftmost point to the rightmost point on the character's baseline. Note that the advance of a `String` is not necessarily the sum of the advances of its characters. Note This method cannot handle supplementary characters. To support all Unicode characters, including supplementary characters, use the `charWidth(int)` method.

public int charWidth(char ch)

Overrides java.awt.FontMetrics.charWidth.

Doc from java.awt.FontMetrics.charWidth.

Returns the advance width of the specified character in this Font. The advance is the distance from the leftmost point to the rightmost point on the character's baseline. Note that the advance of a String is not necessarily the sum of the advances of its characters.

Note

This method cannot handle supplementary characters. To support all Unicode characters, including supplementary characters, use the charWidth(int) method.

charWidth back to summary

charWidth	back to summary
public int charWidth(int ch) Overrides java.awt.FontMetrics.charWidth. Doc from java.awt.FontMetrics.charWidth. Returns the advance width of the specified character in this `Font`. The advance is the distance from the leftmost point to the rightmost point on the character's baseline. Note that the advance of a `String` is not necessarily the sum of the advances of its characters. This method doesn't validate the specified character to be a valid Unicode code point. The caller must validate the character value using `Character.isValidCodePoint` if necessary.

public int charWidth(int ch)

Overrides java.awt.FontMetrics.charWidth.

Doc from java.awt.FontMetrics.charWidth.

This method doesn't validate the specified character to be a valid Unicode code point. The caller must validate the character value using Character.isValidCodePoint if necessary.

getAscent back to summary

getAscent	back to summary
public int getAscent() Overrides java.awt.FontMetrics.getAscent. Doc from java.awt.FontMetrics.getAscent. Determines the font ascent of the `Font` described by this `FontMetrics` object. The font ascent is the distance from the font's baseline to the top of most alphanumeric characters. Some characters in the `Font` might extend above the font ascent line.

public int getAscent()

Overrides java.awt.FontMetrics.getAscent.

Doc from java.awt.FontMetrics.getAscent.

Determines the font ascent of the Font described by this FontMetrics object. The font ascent is the distance from the font's baseline to the top of most alphanumeric characters. Some characters in the Font might extend above the font ascent line.

getDefaultFrc	back to summary
private static FontRenderContext getDefaultFrc()

getDescent back to summary

getDescent	back to summary
public int getDescent() Overrides java.awt.FontMetrics.getDescent. Doc from java.awt.FontMetrics.getDescent. Determines the font descent of the `Font` described by this `FontMetrics` object. The font descent is the distance from the font's baseline to the bottom of most alphanumeric characters with descenders. Some characters in the `Font` might extend below the font descent line.

public int getDescent()

Overrides java.awt.FontMetrics.getDescent.

Doc from java.awt.FontMetrics.getDescent.

Determines the font descent of the Font described by this FontMetrics object. The font descent is the distance from the font's baseline to the bottom of most alphanumeric characters with descenders. Some characters in the Font might extend below the font descent line.

getFontRenderContext back to summary

getFontRenderContext	back to summary
public FontRenderContext getFontRenderContext() Overrides java.awt.FontMetrics.getFontRenderContext. Doc from java.awt.FontMetrics.getFontRenderContext. Gets the `FontRenderContext` used by this `FontMetrics` object to measure text. Note that methods in this class which take a `Graphics` parameter measure text using the `FontRenderContext` of that `Graphics` object, and not this `FontRenderContext`

public FontRenderContext getFontRenderContext()

Overrides java.awt.FontMetrics.getFontRenderContext.

Doc from java.awt.FontMetrics.getFontRenderContext.

Gets the FontRenderContext used by this FontMetrics object to measure text.

Note that methods in this class which take a Graphics parameter measure text using the FontRenderContext of that Graphics object, and not this FontRenderContext

getHeight	back to summary
public int getHeight() Overrides java.awt.FontMetrics.getHeight. Doc from java.awt.FontMetrics.getHeight. Gets the standard height of a line of text in this font. This is the distance between the baseline of adjacent lines of text. It is the sum of the leading + ascent + descent. Due to rounding this may not be the same as getAscent() + getDescent() + getLeading(). There is no guarantee that lines of text spaced at this distance are disjoint; such lines may overlap if some characters overshoot either the standard ascent or the standard descent metric.

getHeight

back to summary

public int getHeight()

Overrides java.awt.FontMetrics.getHeight.

Doc from java.awt.FontMetrics.getHeight.

Gets the standard height of a line of text in this font. This is the distance between the baseline of adjacent lines of text. It is the sum of the leading + ascent + descent. Due to rounding this may not be the same as getAscent() + getDescent() + getLeading(). There is no guarantee that lines of text spaced at this distance are disjoint; such lines may overlap if some characters overshoot either the standard ascent or the standard descent metric.

getLatinCharWidth	back to summary
private float getLatinCharWidth(char ch)

getLeading back to summary

getLeading	back to summary
public int getLeading() Overrides java.awt.FontMetrics.getLeading. Doc from java.awt.FontMetrics.getLeading. Determines the standard leading of the `Font` described by this `FontMetrics` object. The standard leading, or interline spacing, is the logical amount of space to be reserved between the descent of one line of text and the ascent of the next line. The height metric is calculated to include this extra space.

public int getLeading()

Overrides java.awt.FontMetrics.getLeading.

Doc from java.awt.FontMetrics.getLeading.

Determines the standard leading of the Font described by this FontMetrics object. The standard leading, or interline spacing, is the logical amount of space to be reserved between the descent of one line of text and the ascent of the next line. The height metric is calculated to include this extra space.

getMaxAdvance back to summary

getMaxAdvance	back to summary
public int getMaxAdvance() Overrides java.awt.FontMetrics.getMaxAdvance. Doc from java.awt.FontMetrics.getMaxAdvance. Returns an estimate of the maximum advance width of any character in the `Font` described by this `FontMetrics` object, with important caveats, enumerated below. The advance is the distance from the leftmost point used to position the character to the rightmost point along the baseline. This is not the same thing as the visible width of the glyph image representing the character. The advance of a `String` is not necessarily the sum of the advances of its characters. It may differ substantially if complex text layout is required for proper rendering. Some of the caveats of the reported value include The returned value is relying upon information from some underlying system font, and the correctness of that information is outside of AWT's control. When specific characters are mapped into glyphs in some rendering context, instructions in the font itself together with the rasterization process may cause some glyph to have a wider advance than reported. When a font is requested in some style, eg `Font.BOLD`, for which no exact match is available, then techniques to satisfy the requested rendering may similarly result in glyphs that are wider than the reported maximum. Depending on the implementation, an AWT logical font or physical font may need to locate some characters from one or more "fall back" fonts, when the primary underlying physical font does not support the character. These fonts may not all be known or considered in the calculation of the reported maximum advance. It is common for the design center of such fall back fonts to be for a different script than the design center of the primary font, so their advances can be quite different. This can also lead to the unexpected result that a font such as `Font.MONOSPACED` can render glyphs that are not all the same width. None of these caveats are exposed as they are all implementation details, and there is no practical way to determine when these are in effect. An application which needs a better estimate of the maximum advance, and knows the subset of characters it expects to display can query the advance of each such character to find the widest, however, as discussed above, since the displayed width of a `String` is not necessarily the sum of the advances the value still needs to be used with caution. In summary, this method makes no absolute guarantee, nor can it even make a guarantee to be correct within some margin of error. So it should be used at most only for estimating the total space sufficient to display some number of as yet unknown characters from the font. And that might be either an overestimate, or an underestimate depending on the specific text and rendering context.

public int getMaxAdvance()

Overrides java.awt.FontMetrics.getMaxAdvance.

Doc from java.awt.FontMetrics.getMaxAdvance.

Returns an estimate of the maximum advance width of any character in the Font described by this FontMetrics object, with important caveats, enumerated below.

The advance is the distance from the leftmost point used to position the character to the rightmost point along the baseline. This is not the same thing as the visible width of the glyph image representing the character.

The advance of a String is not necessarily the sum of the advances of its characters. It may differ substantially if complex text layout is required for proper rendering.

Some of the caveats of the reported value include

The returned value is relying upon information from some underlying system font, and the correctness of that information is outside of AWT's control.
When specific characters are mapped into glyphs in some rendering context, instructions in the font itself together with the rasterization process may cause some glyph to have a wider advance than reported.
When a font is requested in some style, eg Font.BOLD, for which no exact match is available, then techniques to satisfy the requested rendering may similarly result in glyphs that are wider than the reported maximum.
Depending on the implementation, an AWT logical font or physical font may need to locate some characters from one or more "fall back" fonts, when the primary underlying physical font does not support the character. These fonts may not all be known or considered in the calculation of the reported maximum advance. It is common for the design center of such fall back fonts to be for a different script than the design center of the primary font, so their advances can be quite different. This can also lead to the unexpected result that a font such as Font.MONOSPACED can render glyphs that are not all the same width.

None of these caveats are exposed as they are all implementation details, and there is no practical way to determine when these are in effect. An application which needs a better estimate of the maximum advance, and knows the subset of characters it expects to display can query the advance of each such character to find the widest, however, as discussed above, since the displayed width of a String is not necessarily the sum of the advances the value still needs to be used with caution.

In summary, this method makes no absolute guarantee, nor can it even make a guarantee to be correct within some margin of error. So it should be used at most only for estimating the total space sufficient to display some number of as yet unknown characters from the font. And that might be either an overestimate, or an underestimate depending on the specific text and rendering context.

getMetrics	back to summary
public static FontDesignMetrics getMetrics(Font font)

getMetrics	back to summary
public static FontDesignMetrics getMetrics(Font font, FontRenderContext frc)

getSimpleBounds	back to summary
public Rectangle2D getSimpleBounds(char[] data, int off, int len) This method is called from java.awt.Font only after verifying the arguments and that the text is simple and there are no layout attributes, font transform etc.

getWidths back to summary

getWidths	back to summary
public int[] getWidths() Overrides java.awt.FontMetrics.getWidths. Gets the advance widths of the first 256 characters in the `Font`. The advance is the distance from the leftmost point to the rightmost point on the character's baseline. Note that the advance of a `String` is not necessarily the sum of the advances of its characters. Returns:int[] an array storing the advance widths of the characters in the `Font` described by this `FontMetrics` object.

public int[] getWidths()

Overrides java.awt.FontMetrics.getWidths.

Gets the advance widths of the first 256 characters in the Font. The advance is the distance from the leftmost point to the rightmost point on the character's baseline. Note that the advance of a String is not necessarily the sum of the advances of its characters.

Returns:int[]: an array storing the advance widths of the characters in the Font described by this FontMetrics object.

handleCharWidth	back to summary
private float handleCharWidth(int ch)

initAdvCache	back to summary
private void initAdvCache()

initMatrixAndMetrics	back to summary
private void initMatrixAndMetrics()

readObject	back to summary
private void readObject(ObjectInputStream in) throws IOException, ClassNotFoundException Annotations @Serial

stringWidth back to summary

public int stringWidth(String str)

Overrides java.awt.FontMetrics.stringWidth.

Doc from java.awt.FontMetrics.stringWidth.

Returns the total advance width for showing the specified String in this Font. The advance is the distance from the leftmost point to the rightmost point on the string's baseline.

Note that the advance of a String is not necessarily the sum of the advances of its characters.

writeObject	back to summary
private void writeObject(ObjectOutputStream out) throws IOException Annotations @Serial

sun.font back to summary

private Class FontDesignMetrics.KeyReference

Class Inheritance

extends SoftReference<Object>
implements DisposerRecord, PollDisposable

All Implemented Interfaces

sun.java2d.Disposer.PollDisposable, sun.java2d.DisposerRecord

Field Summary

Modifier and Type	Field and Description
pack-priv Object	key
pack-priv static ReferenceQueue<Object>	queue Hides java.lang.ref.Reference.queue.

Constructor Summary

Access	Constructor and Description
pack-priv	KeyReference(Object key, Object value)

Method Summary

Modifier and Type	Method and Description
public void	dispose() Implements sun.java2d.DisposerRecord.dispose.

Inherited from java.lang.ref.SoftReference:: get

Field Detail

key	back to summary
pack-priv Object key

queue	back to summary
pack-priv static ReferenceQueue<Object> queue Hides java.lang.ref.Reference.queue.

Constructor Detail

KeyReference	back to summary
pack-priv KeyReference(Object key, Object value)

Method Detail

dispose	back to summary
public void dispose() Implements sun.java2d.DisposerRecord.dispose.

sun.font back to summary

private Class FontDesignMetrics.MetricsKey

Class Inheritance

extends Object

java.lang.Object
sun.font.FontDesignMetrics.MetricsKey

Field Summary

Modifier and Type	Field and Description
pack-priv Font	font
pack-priv FontRenderContext	frc
pack-priv int	hash
pack-priv static final FontDesignMetrics.MetricsKey	key

Constructor Summary

Access	Constructor and Description
pack-priv	MetricsKey()
pack-priv	MetricsKey(Font font, FontRenderContext frc)

Method Summary

Modifier and Type	Method and Description
public boolean	equals(Object key) Overrides java.lang.Object.equals. Indicates whether some other object is "equal to" this one.
public int	hashCode() Overrides java.lang.Object.hashCode. Returns a hash code value for this object.
pack-priv void	init(Font font, FontRenderContext frc)

Inherited from java.lang.Object:: clone finalize getClass notify notifyAll toString wait wait wait

Field Detail

font	back to summary
pack-priv Font font

frc	back to summary
pack-priv FontRenderContext frc

hash	back to summary
pack-priv int hash

key	back to summary
pack-priv static final FontDesignMetrics.MetricsKey key

Constructor Detail

MetricsKey	back to summary
pack-priv MetricsKey()

MetricsKey	back to summary
pack-priv MetricsKey(Font font, FontRenderContext frc)

Method Detail

equals back to summary

public boolean equals(Object key)

Overrides java.lang.Object.equals.

Doc from java.lang.Object.equals.

Indicates whether some other object is "equal to" this one.

The equals method implements an equivalence relation on non-null object references:

It is reflexive: for any non-null reference value x, x.equals(x) should return true.
It is symmetric: for any non-null reference values x and y, x.equals(y) should return true if and only if y.equals(x) returns true.
It is transitive: for any non-null reference values x, y, and z, if x.equals(y) returns true and y.equals(z) returns true, then x.equals(z) should return true.
It is consistent: for any non-null reference values x and y, multiple invocations of x.equals(y) consistently return true or consistently return false, provided no information used in equals comparisons on the objects is modified.
For any non-null reference value x, x.equals(null) should return false.

An equivalence relation partitions the elements it operates on into equivalence classes; all the members of an equivalence class are equal to each other. Members of an equivalence class are substitutable for each other, at least for some purposes.

hashCode back to summary

public int hashCode()

Overrides java.lang.Object.hashCode.

Doc from java.lang.Object.hashCode.

Returns a hash code value for this object. This method is supported for the benefit of hash tables such as those provided by java.util.HashMap.

The general contract of hashCode is:

Whenever it is invoked on the same object more than once during an execution of a Java application, the hashCode method must consistently return the same integer, provided no information used in equals comparisons on the object is modified. This integer need not remain consistent from one execution of an application to another execution of the same application.
If two objects are equal according to the equals method, then calling the hashCode method on each of the two objects must produce the same integer result.
It is not required that if two objects are unequal according to the equals method, then calling the hashCode method on each of the two objects must produce distinct integer results. However, the programmer should be aware that producing distinct integer results for unequal objects may improve the performance of hash tables.

init	back to summary
pack-priv void init(Font font, FontRenderContext frc)

public final Class FontDesignMetrics

Nested and Inner Type Summary

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

private Class FontDesignMetrics.KeyReference

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

private Class FontDesignMetrics.MetricsKey

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail