Class GdkFontPeer

public GdkFontPeer(String name,
                   int style)

public GdkFontPeer(String name,
                   int style,
                   int size)

public GdkFontPeer(String name,
                   Map<K,V> attributes)

public boolean canDisplay(Font font,
                          int c)

Implementation of Font.canDisplay(char)

Overrides:

canDisplay in interface ClasspathFontPeer

Parameters:

font - the font this peer is being called from. This may be useful if you are sharing peers between Font objects. Otherwise it may be ignored.

public int canDisplayUpTo(Font font,
                          CharacterIterator i,
                          int start,
                          int limit)

Implementation of Font.canDisplay(String), Font.canDisplay(char [], int, int), and Font.canDisplay(CharacterIterator, int, int).

Overrides:

canDisplayUpTo in interface ClasspathFontPeer

Parameters:

font - the font this peer is being called from. This may be useful if you are sharing peers between Font objects. Otherwise it may be ignored.

public GlyphVector createGlyphVector(Font font,
                                     FontRenderContext ctx,
                                     int[] glyphCodes)

Implementation of Font.createGlyphVector(FontRenderContext,int[]).

Overrides:

createGlyphVector in interface ClasspathFontPeer

Parameters:

font - the font object that the created GlyphVector will return when it gets asked for its font. This argument is needed because the public API of GlyphVector works with Font, not with font peers.

public GlyphVector createGlyphVector(Font font,
                                     FontRenderContext ctx,
                                     CharacterIterator i)

Implementation of Font.createGlyphVector(FontRenderContext,String), Font.createGlyphVector(FontRenderContext,char[]), and Font.createGlyphVector(FontRenderContext,CharacterIterator).

Overrides:

createGlyphVector in interface ClasspathFontPeer

Parameters:

font - the font object that the created GlyphVector will return when it gets asked for its font. This argument is needed because the public API of GlyphVector works with Font, not with font peers.

protected void finalize()

Called on an object by the Virtual Machine at most once, at some point after the Object is determined unreachable but before it is destroyed. You would think that this means it eventually is called on every Object, but this is not necessarily the case. If execution terminates abnormally, garbage collection does not always happen. Thus you cannot rely on this method to always work. For finer control over garbage collection, use references from the java.lang.ref package.

Virtual Machines are free to not call this method if they can determine that it does nothing important; for example, if your class extends Object and overrides finalize to do simply super.finalize().

finalize() will be called by a Thread that has no locks on any Objects, and may be called concurrently. There are no guarantees on the order in which multiple objects are finalized. This means that finalize() is usually unsuited for performing actions that must be thread-safe, and that your implementation must be use defensive programming if it is to always work.

If an Exception is thrown from finalize() during garbage collection, it will be patently ignored and the Object will still be destroyed.

It is allowed, although not typical, for user code to call finalize() directly. User invocation does not affect whether automatic invocation will occur. It is also permitted, although not recommended, for a finalize() method to "revive" an object by making it reachable from normal code again.

Unlike constructors, finalize() does not get called for an object's superclass unless the implementation specifically calls super.finalize().

The default implementation does nothing.

Overrides:

finalize in interface Object

See Also:

System.gc(), System.runFinalizersOnExit(boolean), java.lang.ref

public byte getBaselineFor(Font font,
                           char c)

Implementation of Font.getBaselineFor(char)

Overrides:

getBaselineFor in interface ClasspathFontPeer

Parameters:

font - the font this peer is being called from. This may be useful if you are sharing peers between Font objects. Otherwise it may be ignored.

public FontMetrics getFontMetrics(Font font)

Implementation of Font.getFontMetrics()

Overrides:

getFontMetrics in interface ClasspathFontPeer

Parameters:

font - the font this peer is being called from. This may be useful if you are sharing peers between Font objects. Otherwise it may be ignored.

public String getGlyphName(Font font,
                           int glyphIndex)

Returns a name for the specified glyph. This is useful for generating PostScript or PDF files that embed some glyphs of a font. If the implementation follows glyph naming conventions specified by Adobe, search engines can extract the original text from the generated PostScript and PDF files.

This method is currently not used by GNU Classpath. However, it would be very useful for someone wishing to write a good PostScript or PDF stream provider for the javax.print package.

Names are not unique: Under some rare circumstances, the same name can be returned for different glyphs. It is therefore recommended that printer drivers check whether the same name has already been returned for antoher glyph, and make the name unique by adding the string ".alt" followed by the glyph index.

This situation would occur for an OpenType or TrueType font that has a post table of format 3 and provides a mapping from glyph IDs to Unicode sequences through a Zapf table. If the same sequence of Unicode codepoints leads to different glyphs (depending on contextual position, for example, or on typographic sophistication level), the same name would get synthesized for those glyphs. To avoid this, the font peer would have to go through the names of all glyphs, which would make this operation very inefficient with large fonts.

Overrides:

getGlyphName in interface ClasspathFontPeer

Parameters:

font - the font containing the glyph whose name is requested.

glyphIndex - the glyph whose name the caller wants to retrieve.

Returns:

the glyph name, or null if a font does not provide glyph names.

public LineMetrics getLineMetrics(Font font,
                                  String str,
                                  FontRenderContext frc)

public LineMetrics getLineMetrics(Font font,
                                  CharacterIterator ci,
                                  int begin,
                                  int limit,
                                  FontRenderContext rc)

Implementation of Font.getLineMetrics(CharacterIterator,int,int,FontRenderContext)

Overrides:

getLineMetrics in interface ClasspathFontPeer

Parameters:

font - the font this peer is being called from. This may be useful if you are sharing peers between Font objects. Otherwise it may be ignored.

public Rectangle2D getMaxCharBounds(Font font,
                                    FontRenderContext rc)

Implementation of Font.getMaxCharBounds(FontRenderContext)

Overrides:

getMaxCharBounds in interface ClasspathFontPeer

Parameters:

font - the font this peer is being called from. This may be useful if you are sharing peers between Font objects. Otherwise it may be ignored.

public int getMissingGlyphCode(Font font)

Implementation of Font.getMissingGlyphCode()

Overrides:

getMissingGlyphCode in interface ClasspathFontPeer

Parameters:

font - the font this peer is being called from. This may be useful if you are sharing peers between Font objects. Otherwise it may be ignored.

public int getNumGlyphs(Font font)

Implementation of Font.getNumGlyphs()

Overrides:

getNumGlyphs in interface ClasspathFontPeer

Parameters:

font - the font this peer is being called from. This may be useful if you are sharing peers between Font objects. Otherwise it may be ignored.

public String getPostScriptName(Font font)

Returns the PostScript name of the font, defaults to the familyName if a PS name could not be retrieved.

Overrides:

getPostScriptName in interface ClasspathFontPeer

public String getSubFamilyName(Font font,
                               Locale locale)

Unneeded, but implemented anyway.

Overrides:

getSubFamilyName in interface ClasspathFontPeer

public boolean hasUniformLineMetrics(Font font)

Implementation of Font.hasUniformLineMetrics()

Overrides:

hasUniformLineMetrics in interface ClasspathFontPeer

Parameters:

font - the font this peer is being called from. This may be useful if you are sharing peers between Font objects. Otherwise it may be ignored.

public GlyphVector layoutGlyphVector(Font font,
                                     FontRenderContext frc,
                                     char[] chars,
                                     int start,
                                     int limit,
                                     int flags)

Implementation of Font.layoutGlyphVector(FontRenderContext,char[],int,int,int).

Overrides:

layoutGlyphVector in interface ClasspathFontPeer

Parameters:

font - the font object that the created GlyphVector will return when it gets asked for its font. This argument is needed because the public API of GlyphVector works with Font, not with font peers.