java.lang.Object | |
↳ | java.awt.Font |
Known Direct Subclasses |
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.
'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 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
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
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
.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(String)
method should
be used if the FONT attribute might be present. See FONT
for more information.
Several attributes will cause additional rendering overhead
and potentially invoke layout. If a Font
has such
attributes, the
method
will return true.hasLayoutAttributes()
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.'
Constants | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
int | BOLD | The bold style constant. | |||||||||
int | CENTER_BASELINE | The baseline used in ideographic scripts like Chinese, Japanese, and Korean when laying out text. | |||||||||
String | DIALOG | A String constant for the canonical family name of the logical font "Dialog". | |||||||||
String | DIALOG_INPUT | A String constant for the canonical family name of the logical font "DialogInput". | |||||||||
int | HANGING_BASELINE | The baseline used in Devanigiri and similar scripts when laying out text. | |||||||||
int | ITALIC | The italicized style constant. | |||||||||
int | LAYOUT_LEFT_TO_RIGHT | A flag to layoutGlyphVector indicating that text is left-to-right as determined by Bidi analysis. | |||||||||
int | LAYOUT_NO_LIMIT_CONTEXT | A flag to layoutGlyphVector indicating that text in the char array after the indicated limit should not be examined. | |||||||||
int | LAYOUT_NO_START_CONTEXT | A flag to layoutGlyphVector indicating that text in the char array before the indicated start should not be examined. | |||||||||
int | LAYOUT_RIGHT_TO_LEFT | A flag to layoutGlyphVector indicating that text is right-to-left as determined by Bidi analysis. | |||||||||
String | MONOSPACED | A String constant for the canonical family name of the logical font "Monospaced". | |||||||||
int | PLAIN | The plain style constant. | |||||||||
int | ROMAN_BASELINE | The baseline used in most Roman scripts when laying out text. | |||||||||
String | SANS_SERIF | A String constant for the canonical family name of the logical font "SansSerif". | |||||||||
String | SERIF | A String constant for the canonical family name of the logical font "Serif". | |||||||||
int | TRUETYPE_FONT | Identify a font resource of type TRUETYPE. | |||||||||
int | TYPE1_FONT | Identify a font resource of type TYPE1. |
Fields | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
name | The logical name of this Font , as passed to the
constructor.@serial |
||||||||||
pointSize | The point size of this Font in float .@serial |
||||||||||
size | The point size of this Font , rounded to integer.@serial |
||||||||||
style | The style of this Font , as passed to the constructor. |
Public Constructors | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Creates a new
Font from the specified name, style and
point size. | |||||||||||
Creates a new
Font with the specified attributes. |
Protected Constructors | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Creates a new
Font from the specified font . |
Public Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
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 input data. | |||||||||||
Returns a new
Font using the specified font type
and the specified font file. | |||||||||||
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 . | |||||||||||
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 this
Font object and applying a new style and transform. | |||||||||||
Creates a new
Font object by replicating the current
Font object and applying a new set of font attributes
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 size. | |||||||||||
Creates a new
Font object by replicating the current
Font object and applying a new size 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 , localized for
the specified locale. | |||||||||||
Returns the family name of this
Font . | |||||||||||
Gets the specified
Font from the system properties
list. | |||||||||||
Returns a
Font object from the system properties list. | |||||||||||
Returns a
Font appropriate to the attributes. | |||||||||||
Returns the font face name of the
Font , localized
for the specified locale. | |||||||||||
Returns the font face name of this
Font . | |||||||||||
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 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 . | |||||||||||
Returns the postscript name of this
Font . | |||||||||||
This method is deprecated.
Font rendering is now platform independent.
| |||||||||||
Returns the point size of this
Font , rounded to
an integer. | |||||||||||
Returns the point size of this
Font in
float value. | |||||||||||
Returns the logical bounds of the specified array of characters
in the specified
FontRenderContext . | |||||||||||
Returns the logical bounds of the specified
String in
the specified FontRenderContext . | |||||||||||
Returns the logical bounds of the characters indexed in the
specified
CharacterIterator in the
specified FontRenderContext . | |||||||||||
Returns the logical bounds of the specified
String in
the specified FontRenderContext . | |||||||||||
Returns the style of this
Font . | |||||||||||
Returns a copy of the transform associated with this
Font . | |||||||||||
Return true if this Font contains attributes that require extra
layout processing.
| |||||||||||
Checks whether or not this
Font has uniform
line metrics. | |||||||||||
Returns a hashcode for this
Font . | |||||||||||
Indicates whether or not this
Font object's style is
BOLD. | |||||||||||
Indicates whether or not this
Font object's style is
ITALIC. | |||||||||||
Indicates whether or not this
Font object's style is
PLAIN. | |||||||||||
Indicates whether or not this
Font object has a
transform that affects its size in addition to the Size
attribute. | |||||||||||
Returns a new
GlyphVector object, performing full
layout of the text if possible. | |||||||||||
Converts this
Font object to a String
representation. |
Protected Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Called by the garbage collector on an object when garbage collection
determines that there are no more references to the object.
|
[Expand]
Inherited Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From class
java.lang.Object
|
The bold style constant. This can be combined with the other style constants (except PLAIN) for mixed styles.
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". It is useful in Font construction to provide compile-time verification of the name.
A String constant for the canonical family name of the logical font "DialogInput". It is useful in Font construction to provide compile-time verification of the name.
The baseline used in Devanigiri and similar scripts when laying out text.
The italicized style constant. This can be combined with the other style constants (except PLAIN) for mixed styles.
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". It is useful in Font construction to provide compile-time verification of the name.
The plain style constant.
The baseline used in most Roman scripts when laying out text.
A String constant for the canonical family name of the logical font "SansSerif". It is useful in Font construction to provide compile-time verification of the name.
A String constant for the canonical family name of the logical font "Serif". It is useful in Font construction to provide compile-time verification of the name.
Identify a font resource of type TRUETYPE.
Used to specify a TrueType font resource to the
createFont(int, File)
method.
The TrueType format was extended to become the OpenType
format, which adds support for fonts with Postscript outlines,
this tag therefore references these fonts, as well as those
with TrueType outlines.
Identify a font resource of type TYPE1.
Used to specify a Type1 font resource to the
createFont(int, File)
method.
The point size of this Font
in float
.@serial
The style of this Font
, as passed to the constructor.
This style can be PLAIN, BOLD, ITALIC, or BOLD+ITALIC.@serial
Creates a new Font
from the specified name, style and
point size.
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".
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 |
Creates a new Font
with the specified attributes.
Only keys defined in TextAttribute
are recognized. In addition the FONT attribute is
not recognized by this constructor
(see getAvailableAttributes()
). Only attributes that have
values of valid types will affect the new Font
.
If attributes
is null
, a new
Font
is initialized with default values.
attributes | the attributes to assign to the new
Font , or null
|
---|
Creates a new Font
from the specified font
.
This constructor is intended for use by subclasses.
font | from which to create this Font . |
---|
NullPointerException | if font is null |
---|
Checks if this Font
has a glyph for the specified
character.
Note: This method cannot handle supplementary
characters. To support all Unicode characters, including
supplementary characters, use the canDisplay(int)
method or canDisplayUpTo
methods.
c | the character for which a glyph is needed |
---|
true
if this Font
has a glyph for this
character; false
otherwise.Checks if this Font
has a glyph for the specified
character.
codePoint | the character (Unicode code point) for which a glyph is needed. |
---|
true
if this Font
has a glyph for the
character; false
otherwise.IllegalArgumentException | if the code point is not a valid Unicode code point. |
---|
Indicates whether or not this Font
can display
the characters in the specified text
starting at start
and ending at
limit
. This method is a convenience overload.
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 |
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
.Indicates whether or not this Font
can display the
text specified by the iter
starting at
start
and ending at limit
.
iter | a CharacterIterator object |
---|---|
start | the specified starting offset into the specified
CharacterIterator . |
limit | the specified ending offset into the specified
CharacterIterator . |
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
.Indicates whether or not this Font
can display a
specified String
. For strings with Unicode encoding,
it is important to know if a particular font can display the
string. This method returns an offset into the String
str
which is the first character this
Font
cannot display without using the missing glyph
code. If the Font
can display all characters, -1 is
returned.
str | a String object |
---|
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
.Returns a new Font
using the specified font type
and input data. The new Font
is
created with a point size of 1 and style PLAIN
.
This base font can then be used with the deriveFont
methods in this class to derive new Font
objects with
varying sizes, styles, transforms and font features. This
method does not close the InputStream
.
To make the Font
available to Font constructors the
returned Font
must be registered in the
GraphicsEnviroment
by calling
registerFont(Font)
.
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. |
Font
created with the specified font type.IllegalArgumentException | if fontFormat is not
TRUETYPE_FONT orTYPE1_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. |
Returns a new Font
using the specified font type
and the specified font file. The new Font
is
created with a point size of 1 and style PLAIN
.
This base font can then be used with the deriveFont
methods in this class to derive new Font
objects with
varying sizes, styles, transforms and font features.
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 |
---|---|
fontFile | a File object representing the
input data for the font. |
Font
created with the specified font type.IllegalArgumentException | if fontFormat is not
TRUETYPE_FONT orTYPE1_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. |
Creates a GlyphVector
by
mapping the specified characters to glyphs one-to-one based on the
Unicode cmap in this Font
. This method does no other
processing besides the mapping of glyphs to characters. This
means that this method is not useful for some scripts, such
as Arabic, Hebrew, Thai, and Indic, that require reordering,
shaping, or ligature substitution.
frc | the specified FontRenderContext |
---|---|
ci | the specified CharacterIterator |
GlyphVector
created with the
specified CharacterIterator
and the specified
FontRenderContext
.
Creates a GlyphVector
by
mapping characters to glyphs one-to-one based on the
Unicode cmap in this Font
. This method does no other
processing besides the mapping of glyphs to characters. This
means that this method is not useful for some scripts, such
as Arabic, Hebrew, Thai, and Indic, that require reordering,
shaping, or ligature substitution.
frc | the specified FontRenderContext |
---|---|
str | the specified String |
GlyphVector
created with the
specified String
and the specified
FontRenderContext
.
Creates a GlyphVector
by
mapping characters to glyphs one-to-one based on the
Unicode cmap in this Font
. This method does no other
processing besides the mapping of glyphs to characters. This
means that this method is not useful for some scripts, such
as Arabic, Hebrew, Thai, and Indic, that require reordering,
shaping, or ligature substitution.
frc | the specified FontRenderContext |
---|---|
chars | the specified array of characters |
GlyphVector
created with the
specified array of characters and the specified
FontRenderContext
.
Creates a GlyphVector
by
mapping characters to glyphs one-to-one based on the
Unicode cmap in this Font
. This method does no other
processing besides the mapping of glyphs to characters. This
means that this method is not useful for some scripts, such
as Arabic, Hebrew, Thai, and Indic, that require reordering,
shaping, or ligature substitution.
frc | the specified FontRenderContext |
---|---|
glyphCodes | the specified integer array |
GlyphVector
created with the
specified integer array and the specified
FontRenderContext
.
Returns the Font
that the str
argument describes.
To ensure that this method returns the desired Font,
format the str
parameter in
one of these ways
"PLAIN"
, "BOLD"
, "BOLDITALIC"
, or
"ITALIC"
, and pointsize is a positive decimal integer
representation of the point size.
For example, if you want a font that is Arial, bold, with
a point size of 18, you would call this method with:
"Arial-BOLD-18".
This is equivalent to calling the Font constructor :
new Font("Arial", Font.BOLD, 18);
and the values are interpreted as specified by that constructor.
A valid trailing decimal field is always interpreted as the pointsize. Therefore a fontname containing a trailing decimal value should not be used in the fontname only form.
If a style name field is not one of the valid style strings, it is interpreted as part of the font name, and the default style is used.
Only one of ' ' or '-' may be used to separate fields in the input. The identified separator is the one closest to the end of the string which separates a valid pointsize, or a valid style name from the rest of the string. Null (empty) pointsize and style fields are treated as valid fields with the default value for that field.
Some font names may include the separator characters ' ' or '-'.
If str
is not formed with 3 components, e.g. such that
style
or pointsize
fields are not present in
str
, and fontname
also contains a
character determined to be the separator character
then these characters where they appear as intended to be part of
fontname
may instead be interpreted as separators
so the font name may not be properly recognised.
The default size is 12 and the default style is PLAIN.
If str
does not specify a valid size, the returned
Font
has a size of 12. If str
does not
specify a valid style, the returned Font has a style of PLAIN.
If you do not specify a valid font name in
the str
argument, this method will return
a font with the family name "Dialog".
To determine what font family names are available on
your system, use the
getAvailableFontFamilyNames()
method.
If str
is null
, a new Font
is returned with the family name "Dialog", a size of 12 and a
PLAIN style.
str | the name of the font, or null |
---|
Font
object that str
describes, or a new default Font
if
str
is null
.Creates a new Font
object by replicating the current
Font
object and applying a new transform to it.
trans | the AffineTransform associated with the
new Font |
---|
Font
object.IllegalArgumentException | if trans is
null |
---|
Creates a new Font
object by replicating this
Font
object and applying a new style and transform.
style | the style for the new Font |
---|---|
trans | the AffineTransform associated with the
new Font |
Font
object.IllegalArgumentException | if trans is
null |
---|
Creates a new Font
object by replicating the current
Font
object and applying a new set of font attributes
to it.
attributes | a map of attributes enabled for the new
Font |
---|
Font
object.Creates a new Font
object by replicating the current
Font
object and applying a new style to it.
style | the style for the new Font |
---|
Font
object.Creates a new Font
object by replicating this
Font
object and applying a new style and size.
style | the style for the new Font |
---|---|
size | the size for the new Font |
Font
object.Creates a new Font
object by replicating the current
Font
object and applying a new size to it.
size | the size for the new Font . |
---|
Font
object.Compares this Font
object to the specified
Object
.
obj | the Object to compare |
---|
true
if the objects are the same
or if the argument is a Font
object
describing the same font as this object;
false
otherwise.Returns a map of font attributes available in this
Font
. Attributes include things like ligatures and
glyph substitution.
Font
.
Returns the keys of all the attributes supported by this
Font
. These attributes can be used to derive other
fonts.
Font
.Returns the baseline appropriate for displaying this character.
Large fonts can support different writing systems, and each system can use a different baseline. The character argument determines the writing system to use. Clients should not assume all characters use the same baseline.
c | a character used to identify the writing system |
---|
Returns the family name of this Font
, localized for
the specified locale.
The family name of a font is font specific. Two fonts such as
Helvetica Italic and Helvetica Bold have the same family name,
Helvetica, whereas their font face names are
Helvetica Bold and Helvetica Italic. The list of
available family names may be obtained by using the
getAvailableFontFamilyNames()
method.
Use getFontName
to get the font face name of the font.
l | locale for which to get the family name |
---|
String
representing the family name of the
font, localized for the specified locale.Returns the family name of this Font
.
The family name of a font is font specific. Two fonts such as
Helvetica Italic and Helvetica Bold have the same family name,
Helvetica, whereas their font face names are
Helvetica Bold and Helvetica Italic. The list of
available family names may be obtained by using the
getAvailableFontFamilyNames()
method.
Use getName
to get the logical name of the font.
Use getFontName
to get the font face name of the font.
String
that is the family name of this
Font
.Gets the specified Font
from the system properties
list. As in the getProperty
method of
System
, the first
argument is treated as the name of a system property to be
obtained. The String
value of this property is then
interpreted as a Font
object.
The property value should be one of the forms accepted by
Font.decode(String)
If the specified property is not found, or the executing code does not
have permission to read the property, the font
argument is returned instead.
nm | the case-insensitive property name |
---|---|
font | a default Font to return if property
nm is not defined |
Font
value of the property.NullPointerException | if nm is null. |
---|
Returns a Font
object from the system properties list.
nm
is treated as the name of a system property to be
obtained. The String
value of this property is then
interpreted as a Font
object according to the
specification of Font.decode(String)
If the specified property is not found, or the executing code does
not have permission to read the property, null is returned instead.
nm | the property name |
---|
Font
object that the property name
describes, or null if no such property exists.NullPointerException | if nm is null. |
---|
Returns a Font
appropriate to the attributes.
If attributes
contains a FONT
attribute
with a valid Font
as its value, it will be
merged with any remaining attributes. See
FONT
for more
information.
attributes | the attributes to assign to the new
Font |
---|
Font
created with the specified
attributesNullPointerException | if attributes is null. |
---|
Returns the font face name of the Font
, localized
for the specified locale. For example, Helvetica Fett could be
returned as the font face name.
Use getFamily
to get the family name of the font.
l | a locale for which to get the font face name |
---|
String
representing the font face name,
localized for the specified locale.Returns the font face name of this Font
. For example,
Helvetica Bold could be returned as a font face name.
Use getFamily
to get the family name of the font.
Use getName
to get the logical name of the font.
String
representing the font face name of
this Font
.Returns the italic angle of this Font
. The italic angle
is the inverse slope of the caret which best matches the posture of this
Font
.
Font
.
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 |
LineMetrics
object created with the
specified arguments.
Returns a LineMetrics
object created with the specified
String
and FontRenderContext
.
str | the specified String |
---|---|
frc | the specified FontRenderContext |
LineMetrics
object created with the
specified String
and 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 |
LineMetrics
object created with the
specified arguments.
Returns a LineMetrics
object created with the
specified arguments.
str | the specified String |
---|---|
beginIndex | the initial offset of str |
limit | the end offset of str |
frc | the specified FontRenderContext |
LineMetrics
object created with the
specified arguments.
Returns the bounds for the character with the maximum
bounds as defined in the specified FontRenderContext
.
Note: The returned bounds is in baseline-relative coordinates
(see class notes
).
frc | the specified FontRenderContext |
---|
Rectangle2D
that is the bounding box
for the character with the maximum bounds.
Returns the glyphCode which is used when this Font
does not have a glyph for a specified unicode code point.
Font
.Returns the logical name of this Font
.
Use getFamily
to get the family name of the font.
Use getFontName
to get the font face name of the font.
String
representing the logical name of
this Font
.Returns the number of glyphs in this Font
. Glyph codes
for this Font
range from 0 to
getNumGlyphs()
- 1.
Font
.Returns the postscript name of this Font
.
Use getFamily
to get the family name of the font.
Use getFontName
to get the font face name of the font.
String
representing the postscript name of
this Font
.
This method is deprecated.
Font rendering is now platform independent.
Gets the peer of this Font
.
Font
.Returns the point size of this Font
, rounded to
an integer.
Most users are familiar with the idea of using point size to
specify the size of glyphs in a font. This point size defines a
measurement between the baseline of one line to the baseline of the
following line in a single spaced text document. The point size is
based on typographic points, approximately 1/72 of an inch.
The Java(tm)2D API adopts the convention that one point is equivalent to one unit in user coordinates. When using a normalized transform for converting user space coordinates to device space coordinates 72 user space units equal 1 inch in device space. In this case one point is 1/72 of an inch.
Font
in 1/72 of an
inch units.Returns the point size of this Font
in
float
value.
Font
as a
float
value.Returns the logical bounds of the specified array of characters
in the specified FontRenderContext
. The logical
bounds contains the origin, ascent, advance, and height, which
includes the leading. The logical bounds does not always enclose
all the text. For example, in some languages and in some fonts,
accent marks can be positioned above the ascent or below the
descent. To obtain a visual bounding box, which encloses all the
text, use the getBounds
method of
TextLayout
.
Note: The returned bounds is in baseline-relative coordinates
(see class notes
).
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 |
Rectangle2D
that is the bounding box of the
specified array of characters in the specified
FontRenderContext
.IndexOutOfBoundsException | if beginIndex is
less than zero, or limit is greater than the
length of chars , or beginIndex
is greater than limit . |
---|
Returns the logical bounds of the specified String
in
the specified FontRenderContext
. The logical bounds
contains the origin, ascent, advance, and height, which includes
the leading. The logical bounds does not always enclose all the
text. For example, in some languages and in some fonts, accent
marks can be positioned above the ascent or below the descent.
To obtain a visual bounding box, which encloses all the text,
use the getBounds
method of
TextLayout
.
Note: The returned bounds is in baseline-relative coordinates
(see class notes
).
str | the specified String |
---|---|
beginIndex | the initial offset of str |
limit | the end offset of str |
frc | the specified FontRenderContext |
Rectangle2D
that is the bounding box of the
specified String
in the specified
FontRenderContext
.IndexOutOfBoundsException | if beginIndex is
less than zero, or limit is greater than the
length of str , or beginIndex
is greater than limit . |
---|
Returns the logical bounds of the characters indexed in the
specified CharacterIterator
in the
specified FontRenderContext
. The logical bounds
contains the origin, ascent, advance, and height, which includes
the leading. The logical bounds does not always enclose all the
text. For example, in some languages and in some fonts, accent
marks can be positioned above the ascent or below the descent.
To obtain a visual bounding box, which encloses all the text,
use the getBounds
method of
TextLayout
.
Note: The returned bounds is in baseline-relative coordinates
(see class notes
).
ci | the specified CharacterIterator |
---|---|
beginIndex | the initial offset in ci |
limit | the end offset in ci |
frc | the specified FontRenderContext |
Rectangle2D
that is the bounding box of the
characters indexed in the specified CharacterIterator
in the specified FontRenderContext
.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
|
---|
Returns the logical bounds of the specified String
in
the specified FontRenderContext
. The logical bounds
contains the origin, ascent, advance, and height, which includes
the leading. The logical bounds does not always enclose all the
text. For example, in some languages and in some fonts, accent
marks can be positioned above the ascent or below the descent.
To obtain a visual bounding box, which encloses all the text,
use the getBounds
method of
TextLayout
.
Note: The returned bounds is in baseline-relative coordinates
(see class notes
).
str | the specified String |
---|---|
frc | the specified FontRenderContext |
Rectangle2D
that is the bounding box of the
specified String
in the specified
FontRenderContext
.Returns the style of this Font
. The style can be
PLAIN, BOLD, ITALIC, or BOLD+ITALIC.
Font
Returns a copy of the transform associated with this
Font
. This transform is not necessarily the one
used to construct the font. If the font has algorithmic
superscripting or width adjustment, this will be incorporated
into the returned AffineTransform
.
Typically, fonts will not be transformed. Clients generally
should call isTransformed()
first, and only call this
method if isTransformed
returns true.
AffineTransform
object representing the
transform attribute of this Font
object.
Return true if this Font contains attributes that require extra layout processing.
Checks whether or not this Font
has uniform
line metrics. A logical Font
might be a
composite font, which means that it is composed of different
physical fonts to cover different code ranges. Each of these
fonts might have different LineMetrics
. If the
logical Font
is a single
font then the metrics would be uniform.
true
if this Font
has
uniform line metrics; false
otherwise.
Returns a hashcode for this Font
.
Font
.Indicates whether or not this Font
object's style is
BOLD.
true
if this Font
object's
style is BOLD;
false
otherwise.Indicates whether or not this Font
object's style is
ITALIC.
true
if this Font
object's
style is ITALIC;
false
otherwise.Indicates whether or not this Font
object's style is
PLAIN.
true
if this Font
has a
PLAIN sytle;
false
otherwise.Indicates whether or not this Font
object has a
transform that affects its size in addition to the Size
attribute.
true
if this Font
object
has a non-identity AffineTransform attribute.
false
otherwise.Returns a new GlyphVector
object, performing full
layout of the text if possible. Full layout is required for
complex text, such as Arabic or Hindi. Support for different
scripts depends on the font and implementation.
Layout requires bidi analysis, as performed by
Bidi
, and should only be performed on text that
has a uniform direction. The direction is indicated in the
flags parameter,by using LAYOUT_RIGHT_TO_LEFT to indicate a
right-to-left (Arabic and Hebrew) run direction, or
LAYOUT_LEFT_TO_RIGHT to indicate a left-to-right (English)
run direction.
In addition, some operations, such as Arabic shaping, require context, so that the characters at the start and limit can have the proper shapes. Sometimes the data in the buffer outside the provided range does not have valid data. The values LAYOUT_NO_START_CONTEXT and LAYOUT_NO_LIMIT_CONTEXT can be added to the flags parameter to indicate that the text before start, or after limit, respectively, should not be examined for context.
All other values for the flags parameter are reserved.
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 |
GlyphVector
representing the text between
start and limit, with glyphs chosen and positioned so as to best represent
the textArrayIndexOutOfBoundsException | if start or limit is out of bounds |
---|
Converts this Font
object to a String
representation.
String
representation of this
Font
object.Called by the garbage collector on an object when garbage collection
determines that there are no more references to the object.
A subclass overrides the finalize
method to dispose of
system resources or to perform other cleanup.
The general contract of finalize is that it is invoked if and when the JavaTM virtual machine has determined that there is no longer any means by which this object can be accessed by any thread that has not yet died, except as a result of an action taken by the finalization of some other object or class which is ready to be finalized. The finalize method may take any action, including making this object available again to other threads; the usual purpose of finalize, however, is to perform cleanup actions before the object is irrevocably discarded. For example, the finalize method for an object that represents an input/output connection might perform explicit I/O transactions to break the connection before the object is permanently discarded.
The finalize method of class Object performs no special action; it simply returns normally. Subclasses of Object may override this definition.
The Java programming language does not guarantee which thread will invoke the finalize method for any given object. It is guaranteed, however, that the thread that invokes finalize will not be holding any user-visible synchronization locks when finalize is invoked. If an uncaught exception is thrown by the finalize method, the exception is ignored and finalization of that object terminates.
After the finalize method has been invoked for an object, no further action is taken until the Java virtual machine has again determined that there is no longer any means by which this object can be accessed by any thread that has not yet died, including possible actions by other objects or classes which are ready to be finalized, at which point the object may be discarded.
The finalize method is never invoked more than once by a Java virtual machine for any given object.
Any exception thrown by the finalize
method causes
the finalization of this object to be halted, but is otherwise
ignored.
Throwable |
---|