com.aspose.font

Class FontCharactersMerger

java.lang.Object

com.aspose.font.FontCharactersMerger

public abstract class FontCharactersMerger
extends Object

Declares functionality to merge fonts of different types. Fonts pair is needed for merge operation. One font from this pair is considered as primary. It means that many characteristics, related to final merged font, such as metrics, encoding structure and others, will be taken from this primary font. Another font from this pair (secondary) provides only glyphs for final merged font.

Method Summary

Modifier and Type	Method and Description
abstract Font	getPrimaryFont() Gets primary font.
abstract Font	getSecondaryFont() Gets secondary font.
abstract Font	mergeFonts(GlyphId[] primaryFontGlyphs, GlyphId[] secondaryFontGlyphs, String newFontName) Merges fonts based on glyphs lists passed.
abstract Font	mergeFonts(int[] primaryFontCharCodes, int[] secondaryFontCharCodes, String newFontName) Merges fonts based on character codes lists passed.
abstract Font	mergeFonts(Map<Integer,GlyphId> primaryFontDict, Map<Integer,GlyphId> secondaryFontDict, String newFontName) This method version is designed for cases when you want to set character codes for glyphs in the resultant font explicitly.

Methods inherited from class java.lang.Object

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

Method Detail

getPrimaryFont

public abstract Font getPrimaryFont()

Gets primary font.

Returns:

The primary font.

getSecondaryFont

public abstract Font getSecondaryFont()

Gets secondary font.

Returns:

The secondary font.

mergeFonts

public abstract Font mergeFonts(GlyphId[] primaryFontGlyphs,
                                GlyphId[] secondaryFontGlyphs,
                                String newFontName)

Merges fonts based on glyphs lists passed. Searches for a character code for every glyph passed and adds found character code with correspondent glyph into resultant new font.

Parameters:

primaryFontGlyphs - List of glyphs to take from primary font.

secondaryFontGlyphs - List of glyphs to take from secondary font.

newFontName - Desired name for resultant font.

Returns:

Merged font

mergeFonts

public abstract Font mergeFonts(int[] primaryFontCharCodes,
                                int[] secondaryFontCharCodes,
                                String newFontName)

Merges fonts based on character codes lists passed. To create the desired resultant font, just pass symbol codes from original fonts you want to include into the resultant font. Glyphs related to codes passed will be found automatically. For example, if you want to include glyphs related to letters A and B from the first font and glyphs related to letters C and D from the second font, just call this method like this: mergeFonts(new uint[] { 'A', 'B' }, new uint[] { 'C', 'D' }, "NewFont")

Parameters:

primaryFontCharCodes - Codes to take from the primary font.

secondaryFontCharCodes - Codes to take from the secondary font.

newFontName - Desired name for the resultant font.

Returns:

Merged font.

mergeFonts

public abstract Font mergeFonts(Map<Integer,GlyphId> primaryFontDict,
                                Map<Integer,GlyphId> secondaryFontDict,
                                String newFontName)

This method version is designed for cases when you want to set character codes for glyphs in the resultant font explicitly. It's not mandatory that the code for the glyph you provided is included in the original font. The purpose of the code passed is that it will be associated with the corresponding glyph identifier in the resultant font. Thus, the rule to process every pair passed by the dictionary parameter [code, glyph identifier] is that only the glyph identifier will be taken from the original font and then it will be linked with the corresponding code in the resultant font. This can be helpful when some codes from the first font conflict with the same codes from the second font.

Parameters:

primaryFontDict - Dictionary with pairs [symbol code, glyph identifier] from the primary font.

secondaryFontDict - Dictionary with pairs [symbol code, glyph identifier] from the secondary font.

newFontName - Desired name for the resultant font.

Returns:

Merged font.