Also see:

getFont()
serial:

 protected FontMetrics(Font font) 
{
        this.font = font;
}

Creates a new FontMetrics object for finding out height and width information about the specified Font and specific character glyphs in that Font.

Parameters:

font - the Font

Also see:

java.awt.Font

 public int bytesWidth(byte[] data,
    int off,
    int len) 
{
        return stringWidth(new String(data, 0, off, len));
}

Returns the total advance width for showing the specified array of bytes 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 charWidth(int codePoint) 
{
        if (!Character.isValidCodePoint(codePoint)) {
            codePoint = 0xffff; // substitute missing glyph width
        }
        if (codePoint <  256) {
            return getWidths()[codePoint];
        } else {
            char[] buffer = new char[2];
            int len = Character.toChars(codePoint, buffer, 0);
            return charsWidth(buffer, 0, len);
        }
}

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(char ch) 
{
        if (ch <  256) {
            return getWidths()[ch];
        }
        char data[] = {ch};
        return charsWidth(data, 0, 1);
}

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 charsWidth(char[] data,
    int off,
    int len) 
{
        return stringWidth(new String(data, off, len));
}

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 getAscent() 
{
        return font.getSize();
}

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 getDescent() 
{
        return 0;
}

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 Font getFont() 
{
        return font;
}

Gets the Font described by this FontMetrics object.

 public FontRenderContext getFontRenderContext() 
{
        return DEFAULT_FRC;
}

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 int getHeight() 
{
        return getLeading() + getAscent() + getDescent();
}

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.

 public int getLeading() 
{
        return 0;
}

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 LineMetrics getLineMetrics(String str,
    Graphics context) 
{
        return font.getLineMetrics(str, myFRC(context));
}

Returns the LineMetrics object for the specified String in the specified Graphics context.

 public LineMetrics getLineMetrics(String str,
    int beginIndex,
    int limit,
    Graphics context) 
{
        return font.getLineMetrics(str, beginIndex, limit, myFRC(context));
}

Returns the LineMetrics object for the specified String in the specified Graphics context.

 public LineMetrics getLineMetrics(char[] chars,
    int beginIndex,
    int limit,
    Graphics context) 
{
        return font.getLineMetrics(
                                chars, beginIndex, limit, myFRC(context));
}

Returns the LineMetrics object for the specified character array in the specified Graphics context.

 public LineMetrics getLineMetrics(CharacterIterator ci,
    int beginIndex,
    int limit,
    Graphics context) 
{
        return font.getLineMetrics(ci, beginIndex, limit, myFRC(context));
}

Returns the LineMetrics object for the specified CharacterIterator in the specified Graphics context.

 public int getMaxAdvance() 
{
        return -1;
}

Gets the maximum advance width of any character 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.

 public int getMaxAscent() 
{
        return getAscent();
}

Determines the maximum ascent of the Font described by this FontMetrics object. No character extends further above the font's baseline than this height.

 public Rectangle2D getMaxCharBounds(Graphics context) 
{
        return font.getMaxCharBounds(myFRC(context));
}

Returns the bounds for the character with the maximum bounds in the specified Graphics context.

 public int getMaxDecent() 
{
        return getMaxDescent();
}

For backward compatibility only.

 public int getMaxDescent() 
{
        return getDescent();
}

Determines the maximum descent of the Font described by this FontMetrics object. No character extends further below the font's baseline than this height.

 public Rectangle2D getStringBounds(String str,
    Graphics context) 
{
        return font.getStringBounds(str, myFRC(context));
}

Returns the bounds of the specified String in the specified Graphics context. The bounds is used to layout the String.

Note: The returned bounds is in baseline-relative coordinates (see class notes ).

 public Rectangle2D getStringBounds(String str,
    int beginIndex,
    int limit,
    Graphics context) 
{
        return font.getStringBounds(str, beginIndex, limit,
                                        myFRC(context));
}

Returns the bounds of the specified String in the specified Graphics context. The bounds is used to layout the String.

Note: The returned bounds is in baseline-relative coordinates (see class notes ).

 public Rectangle2D getStringBounds(char[] chars,
    int beginIndex,
    int limit,
    Graphics context) 
{
        return font.getStringBounds(chars, beginIndex, limit,
                                        myFRC(context));
}

Returns the bounds of the specified array of characters in the specified Graphics context. The bounds is used to layout the String created with the specified array of characters, beginIndex and limit.

Note: The returned bounds is in baseline-relative coordinates (see class notes ).

 public Rectangle2D getStringBounds(CharacterIterator ci,
    int beginIndex,
    int limit,
    Graphics context) 
{
        return font.getStringBounds(ci, beginIndex, limit,
                                        myFRC(context));
}

Returns the bounds of the characters indexed in the specified CharacterIterator in the specified Graphics context.

Note: The returned bounds is in baseline-relative coordinates (see class notes ).

 public int[] getWidths() 
{
        int widths[] = new int[256];
        for (char ch = 0 ; ch <  256 ; ch++) {
            widths[ch] = charWidth(ch);
        }
        return widths;
}

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.

 public boolean hasUniformLineMetrics() 
{
        return font.hasUniformLineMetrics();
}

Checks to see if the Font has uniform line metrics. A composite font may consist of several different fonts to cover various character sets. In such cases, the FontLineMetrics objects are not uniform. Different fonts may have a different ascent, descent, metrics and so on. This information is sometimes necessary for line measuring and line breaking.

 public int stringWidth(String str) 
{
        int len = str.length();
        char data[] = new char[len];
        str.getChars(0, len, data, 0);
        return charsWidth(data, 0, len);
}

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.

 public String toString() 
{
        return getClass().getName() +
            "[font=" + getFont() +
            "ascent=" + getAscent() +
            ", descent=" + getDescent() +
            ", height=" + getHeight() + "]";
}

Returns a representation of this FontMetrics object's values as a String.