*
FontMetrics for the
* specified font.
*
* @param font The font to return metric information for.
*/
protected
FontMetrics(Font font)
{
this.font = font;
}
/*************************************************************************/
/*
* Instance Methods
*/
/**
* Returns the font that this object is creating metric information fo.
*
* @return The font for this object.
*/
public Font
getFont()
{
return(font);
}
/*************************************************************************/
/**
* Returns the leading, or spacing between lines, for this font.
*
* @return The font leading.
*/
public int
getLeading()
{
return(0);
}
/*************************************************************************/
/**
* Returns the ascent of the font, which is the distance from the base
* to the top of the majority of characters in the set. Some characters
* can exceed this value however.
*
* @return The font ascent.
*/
public int
getAscent()
{
return(1);
}
/*************************************************************************/
/**
* Returns the descent of the font, which is the distance from the base
* to the bottom of the majority of characters in the set. Some characters
* can exceed this value however.
*
* @return The font descent.
*/
public int
getDescent()
{
return(1);
}
/*************************************************************************/
/**
* Returns the height of a line in this font. This will be the sum
* of the leading, the ascent, and the descent.
*
* @return The height of the font.
*/
public int
getHeight()
{
return(getAscent() + getDescent() + getLeading());
}
/*************************************************************************/
/**
* Returns the maximum ascent value. This is the maximum distance any
* character in the font rised above the baseline.
*
* @return The maximum ascent for this font.
*/
public int
getMaxAscent()
{
return(getAscent());
}
/*************************************************************************/
/**
* Returns the maximum descent value. This is the maximum distance any
* character in the font extends below the baseline.
*
* @return The maximum descent for this font.
*/
public int
getMaxDescent()
{
return(getDescent());
}
/*************************************************************************/
/**
* Returns the maximum descent value. This is the maximum distance any
* character in the font extends below the baseline.
*
* @return The maximum descent for this font.
*
* @deprecated This method is deprecated in favor of
* getMaxDescent().
*/
public int
getMaxDecent()
{
return(getMaxDescent());
}
/*************************************************************************/
/**
* Returns the width of the widest character in the font.
*
* @return The width of the widest character in the font.
*/
public int
getMaxAdvance()
{
return(-1);
}
/*************************************************************************/
/**
* Returns the width of the specified character.
*
* @param ch The character to return the width of.
*
* @return The width of the specified character.
*/
public int
charWidth(int ch)
{
return(charWidth((char)ch));
}
/*************************************************************************/
/**
* Returns the width of the specified character.
*
* @param ch The character to return the width of.
*
* @return The width of the specified character.
*/
public int
charWidth(char ch)
{
return(1);
}
/*************************************************************************/
/**
* Returns the total width of the specified string
*
* @param str The string to return the width of.
*
* @return The width of the string.
*/
public int
stringWidth(String str)
{
char[] buf = new char[str.length()];
str.getChars(0, str.length(), buf, 0);
return(charsWidth(buf, 0, buf.length));
}
/*************************************************************************/
/**
* Returns the total width of the specified character array.
*
* @param buf The character array containing the data.
* @param offset The offset into the array to start calculating from.
* @param len The total number of bytes to process.
*
* @return The width of the requested characters.
*/
public int
charsWidth(char buf[], int offset, int len)
{
int total_width = 0;
for (int i = offset; i < len; i++)
total_width = charWidth(buf[i]);
return(total_width);
}
/*************************************************************************/
/**
* Returns the total width of the specified byte array.
*
* @param buf The byte array containing the data.
* @param offset The offset into the array to start calculating from.
* @param len The total number of bytes to process.
*
* @return The width of the requested characters.
*/
public int
bytesWidth(byte buf[], int offset, int len)
{
int total_width = 0;
for (int i = offset; i < len; i++)
total_width = charWidth((char)buf[i]);
return(total_width);
}
/*************************************************************************/
/**
* Returns the widths of the first 256 characters in the font.
*
* @return The widths of the first 256 characters in the font.
*/
public int[]
getWidths()
{
return(new int[256]);
}
/*************************************************************************/
/**
* Returns a string representation of this object.
*
* @return A string representation of this object.
*/
public String
toString()
{
return (this.getClass() + "[font=" + font + ",ascent=" + getAscent()
+ ",descent=" + getDescent() + ",height=" + getHeight() + "]");
}
} // class FontMetrics