com.aspose.slides

Class FontsManager

java.lang.Object

com.aspose.slides.FontsManager

All Implemented Interfaces:

IFontsManager

public class FontsManager
extends java.lang.Object
implements IFontsManager

Manages fonts across the presentation.

 The following example shows how to add embedded fonts to PowerPoint Presentation.
 
 // Load presentation
 Presentation pres = new Presentation("Fonts.pptx");
 try {
     // Load source font to be replaced
     IFontData sourceFont = new FontData("Arial");
     IFontData[] allFonts = pres.getFontsManager().getFonts();
     for (IFontData font : allFonts)
     {
         boolean fontAlreadyEmbedded = false;
         IFontData[] embeddedFonts = pres.getFontsManager().getEmbeddedFonts();
         for (int i = 0; i < embeddedFonts.length; i++)
         {
             if (embeddedFonts[i].equals(font))
             {
                 fontAlreadyEmbedded = true;
                 break;
             }
         }
         if (!fontAlreadyEmbedded) {
             pres.getFontsManager().addEmbeddedFont(font, EmbedFontCharacters.All);
         }
     }
     // Save the presentation
     pres.save("AddEmbeddedFont_out.pptx", SaveFormat.Pptx);
 } finally {
     if (pres != null) pres.dispose();
 }
 
 

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.
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 FontSubstRule
void	replaceFont(IFontSubstRuleCollection substRules) Replace font in presentation using information provided in collection of FontSubstRule
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.

Methods inherited from class java.lang.Object

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

Method Detail

getFontSubstRuleList

public final IFontSubstRuleCollection getFontSubstRuleList()

Font substitutions to use when rendering. Read/write IFontSubstRuleCollection.

Specified by:

getFontSubstRuleList in interface IFontsManager

setFontSubstRuleList

public final void setFontSubstRuleList(IFontSubstRuleCollection value)

Font substitutions to use when rendering. Read/write IFontSubstRuleCollection.

Specified by:

setFontSubstRuleList in interface IFontsManager

getFontFallBackRulesCollection

public final 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();
 }
 
 

Specified by:

getFontFallBackRulesCollection in interface IFontsManager

setFontFallBackRulesCollection

public final 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();
 }
 
 

Specified by:

setFontFallBackRulesCollection in interface IFontsManager

getFonts

public final IFontData[] getFonts()

Returns the fonts used in the presentation

Specified by:

getFonts in interface IFontsManager

Returns:

An array of fonts

getSubstitutions

public final 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();
 }
 
 

Specified by:

getSubstitutions in interface IFontsManager

Returns:

Collection of all fonts substitution FontSubstitutionInfo.

getEmbeddedFonts

public final IFontData[] getEmbeddedFonts()

Returns the fonts embedded in the presentation

Specified by:

getEmbeddedFonts in interface IFontsManager

Returns:

Embedded fonts IFontData[]

removeEmbeddedFont

public final void removeEmbeddedFont(IFontData fontData)

Removes the embedded font

Specified by:

removeEmbeddedFont in interface IFontsManager

Parameters:

fontData - Font data object IFontData

addEmbeddedFont

public final void addEmbeddedFont(IFontData fontData,
                                  int embedFontRule)

Adds the embedded font

Specified by:

addEmbeddedFont in interface IFontsManager

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

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.

addEmbeddedFont

public final void addEmbeddedFont(byte[] fontData,
                                  int embedFontRule)

Adds the embedded font

Specified by:

addEmbeddedFont in interface IFontsManager

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

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.

replaceFont

public final void replaceFont(IFontData sourceFont,
                              IFontData destFont)

Replace font in presentation

Specified by:

replaceFont in interface IFontsManager

Parameters:

sourceFont - Source font

destFont - Destination font

replaceFont

public final void replaceFont(IFontSubstRule substRule)

Replace font in presentation using information provided in FontSubstRule

Specified by:

replaceFont in interface IFontsManager

Parameters:

substRule - Font substitution info

replaceFont

public final void replaceFont(IFontSubstRuleCollection substRules)

Replace font in presentation using information provided in collection of FontSubstRule

Specified by:

replaceFont in interface IFontsManager

Parameters:

substRules - Font substitution rules collection

getFontBytes

public final 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();
 }
 
 

Specified by:

getFontBytes in interface IFontsManager

Parameters:

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

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

public final 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], FontStyle.Regular);
     // Determine the embedding level of the font
     int embeddingLevel = pres.getFontsManager().getFontEmbeddingLevel(bytes, fontDatas[0].getFontName());
 } finally {
     if (pres != null) pres.dispose();
 }
 
 

Specified by:

getFontEmbeddingLevel in interface IFontsManager

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.