com.aspose.slides

Interface IFontsManager

All Known Implementing Classes:

FontsManager

public interface IFontsManager

Manages fonts across the presentation.

Method Summary

Modifier and Type	Method and Description
void	addEmbeddedFont(byte[] fontData, int embedFontRule) Adds the embedded font
void	addEmbeddedFont(IFontData fontData, int embedFontRule) Adds the embedded font.
IFontData[]	getEmbeddedFonts() Returns the fonts embedded in the presentation
byte[]	getFontBytes(IFontData fontData, int fontStyle) Retrieves the byte array representing the font data for a specified font style and font data.
int	getFontEmbeddingLevel(byte[] fontBytes, java.lang.String fontName) Determines the embedding level of a font from the given byte array and font name.
IFontFallBackRulesCollection	getFontFallBackRulesCollection() Represents a user's collection of FontFallBack rules for managing of collections of fonts for proper substitutions by fallback functionality Read/write IFontFallBackRulesCollection.
IFontData[]	getFonts() Returns the fonts used in the presentation
IFontSubstRuleCollection	getFontSubstRuleList() Font substitutions to use when rendering Read/write IFontSubstRuleCollection.
com.aspose.ms.System.Collections.Generic.IGenericEnumerable<FontSubstitutionInfo>	getSubstitutions() Gets the information about fonts that will be replaced on the presentation's rendering.
void	removeEmbeddedFont(IFontData fontData) Removes the embedded font
void	replaceFont(IFontData sourceFont, IFontData destFont) Replace font in presentation
void	replaceFont(IFontSubstRule substRule) Replace font in presentation using information provided in IFontSubstRule
void	replaceFont(IFontSubstRuleCollection substRules) Replace font in presentation using information provided in collection of IFontSubstRule
void	setFontFallBackRulesCollection(IFontFallBackRulesCollection value) Represents a user's collection of FontFallBack rules for managing of collections of fonts for proper substitutions by fallback functionality Read/write IFontFallBackRulesCollection.
void	setFontSubstRuleList(IFontSubstRuleCollection value) Font substitutions to use when rendering Read/write IFontSubstRuleCollection.

Method Detail

getFontSubstRuleList

IFontSubstRuleCollection getFontSubstRuleList()

Font substitutions to use when rendering Read/write IFontSubstRuleCollection.

setFontSubstRuleList

void setFontSubstRuleList(IFontSubstRuleCollection value)

Font substitutions to use when rendering Read/write IFontSubstRuleCollection.

getFontFallBackRulesCollection

IFontFallBackRulesCollection getFontFallBackRulesCollection()

Represents a user's collection of FontFallBack rules for managing of collections of fonts for proper substitutions by fallback functionality Read/write IFontFallBackRulesCollection.

 
 Presentation pres = new Presentation();
 try
 {
     // Getting of empty or preinitialized rules collection from FontsManager
     IFontFallBackRulesCollection rulesList = pres.getFontsManager().getFontFallBackRulesCollection();
     // adding of rules to collection
     rulesList.add(new FontFallBackRule(0x400,0x4FF, "Times New Roman"));
     // or 
     // initialization of new instance of rules collection
     IFontFallBackRulesCollection rulesList = new FontFallBackRulesCollection();
     // adding of rules to collection
     rulesList.add(new FontFallBackRule(0x400,0x4FF, "Times New Roman"));
     // and replacing of existing collection by the new one in FontsManager 
     pres.getFontsManager().setFontFallBackRulesCollection(rulesList);
 }
 finally {
     if (pres != null) pres.dispose();
 }
 
 

setFontFallBackRulesCollection

void setFontFallBackRulesCollection(IFontFallBackRulesCollection value)

Represents a user's collection of FontFallBack rules for managing of collections of fonts for proper substitutions by fallback functionality Read/write IFontFallBackRulesCollection.

 
 Presentation pres = new Presentation();
 try
 {
     // Getting of empty or preinitialized rules collection from FontsManager
     IFontFallBackRulesCollection rulesList = pres.getFontsManager().getFontFallBackRulesCollection();
     // adding of rules to collection
     rulesList.add(new FontFallBackRule(0x400,0x4FF, "Times New Roman"));
     // or 
     // initialization of new instance of rules collection
     IFontFallBackRulesCollection rulesList = new FontFallBackRulesCollection();
     // adding of rules to collection
     rulesList.add(new FontFallBackRule(0x400,0x4FF, "Times New Roman"));
     // and replacing of existing collection by the new one in FontsManager 
     pres.getFontsManager().setFontFallBackRulesCollection(rulesList);
 }
 finally {
     if (pres != null) pres.dispose();
 }
 
 

getFonts

IFontData[] getFonts()

Returns the fonts used in the presentation

Returns:

An array of fonts

getSubstitutions

com.aspose.ms.System.Collections.Generic.IGenericEnumerable<FontSubstitutionInfo> getSubstitutions()

Gets the information about fonts that will be replaced on the presentation's rendering.

 
 Presentation pres = new Presentation("pres.pptx");
 try {
     for (FontSubstitutionInfo fontSubstitution : pres.getFontsManager().getSubstitutions())
     {
         System.out.println(fontSubstitution.getOriginalFontName() + " -> " + fontSubstitution.getSubstitutedFontName());
     }
 } finally {
     if (pres != null) pres.dispose();
 }
 
 

Returns:

Collection of all fonts substitution FontSubstitutionInfo.

getEmbeddedFonts

IFontData[] getEmbeddedFonts()

Returns the fonts embedded in the presentation

Returns:

Embedded fonts IFontData[]

removeEmbeddedFont

void removeEmbeddedFont(IFontData fontData)

Removes the embedded font

Parameters:

fontData - Font data object IFontData

addEmbeddedFont

void addEmbeddedFont(IFontData fontData,
                     int embedFontRule)

Adds the embedded font.

Parameters:

fontData - Font data object IFontData

embedFontRule - Embedded font rule EmbedFontCharacters

Keep in mind when copying any fonts that most fonts are copyrighted. First locate the license of a font before hand and verify they can be freely transferred to another machine.

Throws:

com.aspose.ms.System.ArgumentException - An ArgumentException can be thrown if font data is null or this font is already embedded

addEmbeddedFont

void addEmbeddedFont(byte[] fontData,
                     int embedFontRule)

Adds the embedded font

Parameters:

fontData - Font data byte[]

embedFontRule - Embedded font rule EmbedFontCharacters

Keep in mind when adding any fonts that most fonts are copyrighted. First locate the license of a font before hand and verify they can be freely transferred to another machine.

Throws:

com.aspose.ms.System.ArgumentException - An ArgumentException can be thrown if font data is null or this font is already embedded

replaceFont

void replaceFont(IFontData sourceFont,
                 IFontData destFont)

Replace font in presentation

Parameters:

sourceFont - Source font

destFont - Destination font

replaceFont

void replaceFont(IFontSubstRule substRule)

Replace font in presentation using information provided in IFontSubstRule

Parameters:

substRule - Font substitution info

replaceFont

void replaceFont(IFontSubstRuleCollection substRules)

Replace font in presentation using information provided in collection of IFontSubstRule

Parameters:

substRules - Font substitution info collection

getFontBytes

byte[] getFontBytes(IFontData fontData,
                    int fontStyle)

Retrieves the byte array representing the font data for a specified font style and font data.

 
 Presentation pres = new Presentation ("Presentation.pptx");
 try {
     // Retrieve all fonts used in the presentation
     IFontData[] fonts = pres.getFontsManager().getFonts();
     // Get the byte array representing the regular style of the first font in the presentation
     byte[] fontBytes = pres.getFontsManager().getFontBytes(fonts[0], FontStyleType.Regular);
 } finally {
     if (pres != null) pres.dispose();
 }
 
 

Parameters:

fontData - The font data object containing the information about the font IFontData.

fontStyle - The style of the font for which the data is to be retrieved FontStyleType.

Returns:

A byte array containing the font data for the specified font style. If the font data or style is not found, returns null.

getFontEmbeddingLevel

int getFontEmbeddingLevel(byte[] fontBytes,
                          java.lang.String fontName)

Determines the embedding level of a font from the given byte array and font name.

 
 Presentation pres = new Presentation(pptxFileName);
 try {
     // Retrieve all fonts used in the presentation
     IFontData[] fontDatas = pres.getFontsManager().getFonts();
     // Get the byte array representing the regular style of the first font in the presentation
     byte[] bytes = pres.getFontsManager().getFontBytes(fontDatas[0], FontStyleType.Regular);
     // Determine the embedding level of the font
     int embeddingLevel = pres.getFontsManager().getFontEmbeddingLevel(bytes, fontDatas[0].getFontName());
 } finally {
     if (pres != null) pres.dispose();
 }
 
 

Parameters:

fontBytes - The byte array containing the font data.

fontName - The name of the font.

Returns:

The embedding level of the specified font.

Throws:

com.aspose.ms.System.ArgumentNullException - Thrown when fontBytes is null.