com.sun.prism.j2d

Class J2DFontFactory

java.lang.Object

com.sun.prism.j2d.J2DFontFactory

All Implemented Interfaces:

FontFactory

final class J2DFontFactory
extends java.lang.Object
implements FontFactory

This is mostly just delegating, except for allowing for the registration of embedded fonts with Java 2D. Its possible it could also be check the names of all fonts that are being used are known to 2D but I'm not sure I need that.

Field Summary

Fields

Modifier and Type	Field and Description
private static boolean	compositeFontMethodsInitialized
private static java.lang.reflect.Method	getCompositeFontUIResource
(package private) FontFactory	prismFontFactory

Fields inherited from interface com.sun.javafx.font.FontFactory

DEFAULT_FULLNAME

Constructor Summary

Constructors

Constructor and Description
J2DFontFactory(FontFactory fontFactory)

Method Summary

Modifier and Type	Method and Description
PGFont	createFont(java.lang.String family, boolean bold, boolean italic, float size)
PGFont	createFont(java.lang.String name, float size)
PGFont	deriveFont(PGFont font, boolean bold, boolean italic, float size) Creates a new Font object by replicating the current Font object and applying a new bold style, italic style, and size to it.
(package private) static java.awt.Font	getCompositeFont(java.awt.Font srcFont) Returns a composite font from the font passed in the argument.
java.lang.String[]	getFontFamilyNames()
java.lang.String[]	getFontFullNames()
java.lang.String[]	getFontFullNames(java.lang.String family)
boolean	hasPermission()
boolean	isPlatformFont(java.lang.String name)
PGFont	loadEmbeddedFont(java.lang.String name, java.io.InputStream fontStream, float size, boolean register) Loads a font from the specified input stream.
PGFont	loadEmbeddedFont(java.lang.String name, java.lang.String path, float size, boolean register) Loads a font from the specified path.
static void	registerFont(FontResource fr) Printing uses the 2D pipeline which isn't initialised until printing begins, so grabs a copy of the file holding an embedded font to 2D on first use.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

prismFontFactory

FontFactory prismFontFactory

compositeFontMethodsInitialized

private static boolean compositeFontMethodsInitialized

getCompositeFontUIResource

private static java.lang.reflect.Method getCompositeFontUIResource

Constructor Detail

J2DFontFactory

J2DFontFactory(FontFactory fontFactory)

Method Detail

createFont

public PGFont createFont(java.lang.String name,
                         float size)

Specified by:

createFont in interface FontFactory

createFont

public PGFont createFont(java.lang.String family,
                         boolean bold,
                         boolean italic,
                         float size)

Specified by:

createFont in interface FontFactory

deriveFont

public PGFont deriveFont(PGFont font,
                         boolean bold,
                         boolean italic,
                         float size)

Description copied from interface: FontFactory

Creates a new Font object by replicating the current Font object and applying a new bold style, italic style, and size to it.

NOTE: bold and italic are hints.

Specified by:

deriveFont in interface FontFactory

Parameters:

font - the original font.

bold - the bold style for the new font.

italic - the italic style fort the new font.

size - the size for the new font.

Returns:

the new font.

getFontFamilyNames

public java.lang.String[] getFontFamilyNames()

Specified by:

getFontFamilyNames in interface FontFactory

getFontFullNames

public java.lang.String[] getFontFullNames()

Specified by:

getFontFullNames in interface FontFactory

getFontFullNames

public java.lang.String[] getFontFullNames(java.lang.String family)

Specified by:

getFontFullNames in interface FontFactory

isPlatformFont

public boolean isPlatformFont(java.lang.String name)

Specified by:

isPlatformFont in interface FontFactory

hasPermission

public final boolean hasPermission()

Specified by:

hasPermission in interface FontFactory

loadEmbeddedFont

public PGFont loadEmbeddedFont(java.lang.String name,
                               java.io.InputStream fontStream,
                               float size,
                               boolean register)

Description copied from interface: FontFactory

Loads a font from the specified input stream. If the load is successful such that the stream can be fully read, and it represents a supported font format then a PGFont object will be returned.

Any failure such as abbreviated input, or an unsupported font format will result in a null return. It is the application's responsibility to check this before use.

If the register flag is true, and the loading operation completes successfully, then the returned font is registered with the FX graphics system for creation by available constructors and factory methods, and the application should use it in this manner rather than calling this method again, which would repeat the overhead of re-reading and installing the font.

When the font is registered, an alternative name can be supplied. This name can be used for creation by available constructors and factory methods.

The font size parameter is a convenience so that in typical usage the application can directly use the returned (non-null) font rather than needing to create one via a constructor. Invalid sizes are those <=0 and will result in a default size.

This method does not close the input stream.

Specified by:

loadEmbeddedFont in interface FontFactory

Parameters:

name - the name for font, it can be null.

fontStream - the stream from which to load the font.

size - the size for the font.

register - whether the font should be register.

Returns:

the Font, or null if the font cannot be created.

registerFont

public static void registerFont(FontResource fr)

Printing uses the 2D pipeline which isn't initialised until printing begins, so grabs a copy of the file holding an embedded font to 2D on first use.

loadEmbeddedFont

public PGFont loadEmbeddedFont(java.lang.String name,
                               java.lang.String path,
                               float size,
                               boolean register)

Description copied from interface: FontFactory

Loads a font from the specified path. If the load is successful such that the location is readable, and it represents a supported font format then a PGFont object will be returned.

Any failure such as a file being unable to locate or read from the resource, or if it doesn't represent a font, will result in a null return. It is the application's responsibility to check this before use.

If the register flag is true, and the loading operation completes successfully, then the returned font is registered with the FX graphics system for creation by available constructors and factory methods, and the application should use it in this manner rather than calling this method again, which would repeat the overhead of re-reading and installing the font.

When the font is registered, an alternative name can be supplied. This name can be used for creation by available constructors and factory methods.

The font size parameter is a convenience so that in typical usage the application can directly use the returned (non-null) font rather than needing to create one via a constructor. Invalid sizes are those <=0 and will result in a default size.

Specified by:

loadEmbeddedFont in interface FontFactory

Parameters:

name - the name for font, it can be null.

path - the path from which to load the font.

size - the size for the font.

register - whether the font should be register.

Returns:

the Font, or null if the font cannot be created.

getCompositeFont

static java.awt.Font getCompositeFont(java.awt.Font srcFont)

Returns a composite font from the font passed in the argument. Note: This method relies on Java2D's sun.* APIs which are subject to change. ALso this may be just a stop gap measure.