com.itextpdf.layout.font

Class FontProvider

java.lang.Object

com.itextpdf.layout.font.FontProvider

public class FontProvider
extends Object

Main entry point of font selector logic. Contains reusable FontSet and collection of PdfFonts. FontProvider depends from PdfDocument, due to PdfFont, it cannot be reused for different documents, but a new instance of FontProvider could be created with getFontSet(). FontProvider the only end point for creating PdfFont.

It is recommended to use only one FontProvider per document. If temporary fonts per element needed, additional FontSet can be used. For more details see Property.FONT_SET, getPdfFont(FontInfo, FontSet), getStrategy(String, List, FontCharacteristics, FontSet).

Note, FontProvider does not close created FontPrograms, because of possible conflicts with FontCache.

Constructor Summary

Constructors

Constructor and Description
FontProvider() Creates a new instance of FontProvider.
FontProvider(FontSet fontSet) Creates a new instance of FontProvider

Method Summary

Modifier and Type	Method and Description
int	addDirectory(String dir)
boolean	addFont(byte[] fontData)
boolean	addFont(byte[] fontData, String encoding)
boolean	addFont(FontProgram fontProgram)
boolean	addFont(FontProgram fontProgram, String encoding)
boolean	addFont(String fontPath)
boolean	addFont(String fontPath, String encoding)
int	addStandardPdfFonts()
int	addSystemFonts()
protected FontSelector	createFontSelector(Collection<FontInfo> fonts, List<String> fontFamilies, FontCharacteristics fc) Create a new instance of FontSelector.
boolean	getDefaultCacheFlag()
boolean	getDefaultEmbeddingFlag()
String	getDefaultEncoding(FontProgram fontProgram)
FontSelector	getFontSelector(List<String> fontFamilies, FontCharacteristics fc) Create FontSelector or get from cache.
FontSelector	getFontSelector(List<String> fontFamilies, FontCharacteristics fc, FontSet tempFonts) Create FontSelector or get from cache.
FontSet	getFontSet() Gets FontSet.
PdfFont	getPdfFont(FontInfo fontInfo) Get from cache or create a new instance of PdfFont.
PdfFont	getPdfFont(FontInfo fontInfo, FontSet tempFonts) Get from cache or create a new instance of PdfFont.
FontSelectorStrategy	getStrategy(String text, List<String> fontFamilies)
FontSelectorStrategy	getStrategy(String text, List<String> fontFamilies, FontCharacteristics fc)
FontSelectorStrategy	getStrategy(String text, List<String> fontFamilies, FontCharacteristics fc, FontSet additonalFonts)

Methods inherited from class java.lang.Object

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

Constructor Detail

FontProvider

public FontProvider(FontSet fontSet)

Creates a new instance of FontProvider

Parameters:

fontSet - predefined set of fonts, could be null.

FontProvider

public FontProvider()

Creates a new instance of FontProvider.

Method Detail

addFont

public boolean addFont(FontProgram fontProgram,
                       String encoding)

addFont

public boolean addFont(String fontPath,
                       String encoding)

addFont

public boolean addFont(byte[] fontData,
                       String encoding)

addFont

public boolean addFont(String fontPath)

addFont

public boolean addFont(FontProgram fontProgram)

addFont

public boolean addFont(byte[] fontData)

addDirectory

public int addDirectory(String dir)

addSystemFonts

public int addSystemFonts()

addStandardPdfFonts

public int addStandardPdfFonts()

getFontSet

public FontSet getFontSet()

Gets FontSet.

getDefaultEncoding

public String getDefaultEncoding(FontProgram fontProgram)

getDefaultCacheFlag

public boolean getDefaultCacheFlag()

getDefaultEmbeddingFlag

public boolean getDefaultEmbeddingFlag()

getStrategy

public FontSelectorStrategy getStrategy(String text,
                                        List<String> fontFamilies,
                                        FontCharacteristics fc,
                                        FontSet additonalFonts)

getStrategy

public FontSelectorStrategy getStrategy(String text,
                                        List<String> fontFamilies,
                                        FontCharacteristics fc)

getStrategy

public FontSelectorStrategy getStrategy(String text,
                                        List<String> fontFamilies)

getFontSelector

public final FontSelector getFontSelector(List<String> fontFamilies,
                                          FontCharacteristics fc)

Create FontSelector or get from cache.

Parameters:

fontFamilies - target font families

fc - instance of FontCharacteristics.

Returns:

an instance of FontSelector.

See Also:

createFontSelector(Collection, List, FontCharacteristics), getFontSelector(List, FontCharacteristics, FontSet)

getFontSelector

public final FontSelector getFontSelector(List<String> fontFamilies,
                                          FontCharacteristics fc,
                                          FontSet tempFonts)

Create FontSelector or get from cache.

Parameters:

fontFamilies - target font families

fc - instance of FontCharacteristics.

tempFonts - set of temporary fonts.

Returns:

an instance of FontSelector.

See Also:

}

createFontSelector

protected FontSelector createFontSelector(Collection<FontInfo> fonts,
                                          List<String> fontFamilies,
                                          FontCharacteristics fc)

Create a new instance of FontSelector. While caching is main responsibility of getFontSelector(List, FontCharacteristics, FontSet). This method just create a new instance of FontSelector.

Parameters:

fonts - Set of all available fonts in current context.

fontFamilies - target font families

fc - instance of FontCharacteristics.

Returns:

an instance of FontSelector.

getPdfFont

public PdfFont getPdfFont(FontInfo fontInfo)

Get from cache or create a new instance of PdfFont.

Parameters:

fontInfo - font info, to create FontProgram and PdfFont.

Returns:

cached or new instance of PdfFont.

Throws:

IOException - on I/O exceptions in FontProgramFactory.

getPdfFont

public PdfFont getPdfFont(FontInfo fontInfo,
                          FontSet tempFonts)

Get from cache or create a new instance of PdfFont.

Parameters:

fontInfo - font info, to create FontProgram and PdfFont.

tempFonts - Set of temporary fonts.

Returns:

cached or new instance of PdfFont.