Package com.adobe.fontengine.fontmanagement.postscript

Class PSNameFontDatabase

java.lang.Object

com.adobe.fontengine.fontmanagement.postscript.PSNameFontDatabase

All Implemented Interfaces:

PSNameResolver, java.io.Serializable

public final class PSNameFontDatabase
extends java.lang.Object
implements PSNameResolver

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor	Description
PSNameFontDatabase()
PSNameFontDatabase(PSNameFontDatabase original)
PSNameFontDatabase(FamilyNameNormalizer normalizer)

Method Summary

Modifier and Type	Method	Description
void	addFont(Font font)	Adds a font to the set of fonts that are examined for resolving of Postscript names.
void	addFont(PostscriptFontDescription psDesc, Font font)	Adds a font to the set of fonts that are examined for resolving of Postscript names.
boolean	equals(java.lang.Object obj)
Font	findFont(PostscriptFontDescription psDesc)	Deprecated. This method is deprecated.
Font	findFont(java.lang.String psName)
int	hashCode()
boolean	isEmpty()
FontResolutionPriority	setResolutionPriority(FontResolutionPriority priority)	Set the resolution mechanism that the PSNameResolver should use to decide which font should be chosen when two fonts have the same Postscript name.
java.lang.String	toString()

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

PSNameFontDatabase

public PSNameFontDatabase()

PSNameFontDatabase

public PSNameFontDatabase(FamilyNameNormalizer normalizer)

PSNameFontDatabase

public PSNameFontDatabase(PSNameFontDatabase original)

Method Detail

addFont

public void addFont(Font font)
             throws UnsupportedFontException,
                    InvalidFontException,
                    FontLoadingException

Description copied from interface: PSNameResolver

Adds a font to the set of fonts that are examined for resolving of Postscript names. If this font is indistinguishable from another font already in the font set then which of the two that is kept is determined by the settings of FontResolutionPriority.

Specified by:

addFont in interface PSNameResolver

Parameters:

font - the font to add to the fonts used for Postscript resolution

Throws:

UnsupportedFontException

InvalidFontException

FontLoadingException

addFont

public void addFont(PostscriptFontDescription psDesc,
                    Font font)
             throws UnsupportedFontException,
                    InvalidFontException,
                    FontLoadingException

Description copied from interface: PSNameResolver

Adds a font to the set of fonts that are examined for resolving of Postscript names. If this font's PostscriptFontDescription is indistinguishable from another font already in the font set then which of the two that is kept is determined by the settings of FontResolutionPriority.

Note that the PostscriptFontDescription is NOT pushed down into the Font. It is only an alias in the database. Thus, calling font.getPostscriptFontDescription() will not return the description passed in through this method but will instead return the original platform description of the font.

Specified by:

addFont in interface PSNameResolver

Parameters:

psDesc - the postscript description of the font

font - the font to add to the fonts used for Postscript resolution

Throws:

UnsupportedFontException

InvalidFontException

FontLoadingException

isEmpty

public boolean isEmpty()

Specified by:

isEmpty in interface PSNameResolver

Returns:

true if the font set is empty (has no fonts); false otherwise

findFont

public Font findFont(PostscriptFontDescription psDesc)

Deprecated.

This method is deprecated. Use findFont(String) instead.

Description copied from interface: PSNameResolver

Find a Font that matches the provided postscript description. No analysis (e.g., removal of a CMap extension) is done by this function.

Specified by:

findFont in interface PSNameResolver

Parameters:

psDesc - the postscript description of the font

Returns:

the Font.

findFont

public Font findFont(java.lang.String psName)

setResolutionPriority

public FontResolutionPriority setResolutionPriority(FontResolutionPriority priority)

Description copied from interface: PSNameResolver

Set the resolution mechanism that the PSNameResolver should use to decide which font should be chosen when two fonts have the same Postscript name.

FontResolutionPriority.INTELLIGENT_FIRST specifies that an "intelligent" determination is made about the fonts and the "better" of the two font is chosen. If the "intelligent" resolver can make no distinction between the fonts then the first font to have been added first is chosen.

FontResolutionPriority.INTELLIGENT_LAST specifies that an "intelligent" determination is made about the fonts and the "better" of the two font is chosen. If the "intelligent" resolver can make no distinction between the fonts then the first font to have been added last is chosen.

FontResolutionPriority.FIRST specifies the first font added to the font set that matches the Postscript attributes is chosen.

FontResolutionPriority.LAST specifies the last font added to the font set that matches the Postscript attributes is chosen.

Specified by:

setResolutionPriority in interface PSNameResolver

Parameters:

priority - The resolution mechanism to use

Returns:

The old resolution priority setting.

equals

public boolean equals(java.lang.Object obj)

Overrides:

equals in class java.lang.Object

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object