FontRepository

Inheritance: java.lang.Object

public final class FontRepository

Performs font search. Searches in system installed fonts and standard Pdf fonts. Also provides functionality to open custom fonts.


The example demonstrates how to find font and replace the font of text of first page.


  // Find font
  Font font = FontRepository.findFont("Arial");

  // Open document
  Document doc = new Document("D:\\Tests\\input.pdf");
  // Create TextFragmentAbsorber object to find all "hello world" text occurrences
  TextFragmentAbsorber absorber = new TextFragmentAbsorber("hello world");

  // Accept the absorber for first page
  doc.getPages().get_Item(1).accept(absorber);

  // Change font of the first text occurrence
  absorber.getTextFragments().get_Item(1).getTextState().setFont(font);

  // Save document
  doc.save("D:\\Tests\\output.pdf");

Constructors

ConstructorDescription
FontRepository()

Methods

MethodDescription
getSubstitutions()Gets font substitution strategies collection.
getSources()Gets font sources collection.
findFont(String fontName)Searches and returns font with specified font name.
findFont(String fontName, boolean ignoreCase)Searches and returns font with specified font name ignoring or honoring case sensitivity.
findFont(String fontFamilyName, int stl)Searches and returns font with specified font name and font style.
findFont(String fontFamilyName, int stl, boolean ignoreCase)Searches and returns font with specified font name and font style ignoring or honoring case sensitivity.
openFont(InputStream fontStream, int fontType)Opens font with specified font stream.
openFont(String fontFilePath)Opens font with specified font file path.
openFont(String fontFilePath, String metricsFilePath)Opens font with specified font file path and metrics file path.
reloadFonts()Reloads all fonts specified by property Sources (#getSources#getSources)
loadFonts()Loads system installed fonts and standard Pdf fonts.
isReplaceNotFoundFonts()Is not found fonts will be replaced by standard font.
setReplaceNotFoundFonts(boolean value)Set TRUE if need to replace not found fonts with the default font.
clear()
getLocalFontPaths()Copy of the list with actual font directories.
isThreadStaticConfigEnabled()Returns status of Font Sources storage configuration.
setThreadStaticConfigEnabled(boolean isTheadLocal)Option for setting Font Sources storage configuration.
addLocalFontPath(String path)Add one more path to fonts.
setLocalFontPaths(List newFontPathsList)Sets user list with font paths
restoreLocalFontPath()Restores list for standard font directories by default.
addSystemFont(Font font)Add system font with specified font.

FontRepository()

public FontRepository()

getSubstitutions()

public static FontSubstitutionCollection getSubstitutions()

Gets font substitution strategies collection.

Returns: FontSubstitutionCollection - FontSubstitutionCollection object

getSources()

public static FontSourceCollection getSources()

Gets font sources collection.

Returns: FontSourceCollection - FontSourceCollection object

findFont(String fontName)

public static Font findFont(String fontName)

Searches and returns font with specified font name.


The example demonstrates how to find font and replace the font of text of first page.

  // Find font
  Font font = FontRepository.findFont("Arial");

  // Open document
  Document doc = new Document("D:\\Tests\\input.pdf");
  // Create TextFragmentAbsorber object to find all "hello world" text occurrences
  TextFragmentAbsorber absorber = new TextFragmentAbsorber("hello world");

  // Accept the absorber for first page
  doc.getPages().get_Item(1).accept(absorber);

  // Change font of the first text occurrence
  absorber.getTextFragments().get_Item(1).getTextState().setFont ( font);

  // Save document
  doc.save("D:\\Tests\\output.pdf");

Parameters:

ParameterTypeDescription
fontNamejava.lang.StringFont name.

Returns: Font - Font object.

findFont(String fontName, boolean ignoreCase)

public static Font findFont(String fontName, boolean ignoreCase)

Searches and returns font with specified font name ignoring or honoring case sensitivity.


The example demonstrates how to find font and replace the font of text of first page.

  // Find font
  Font font = FontRepository.findFont("Arial", FontStyles.Italic);

  // Open document
  Document doc = new Document("D:\\Tests\\input.pdf");
  // Create TextFragmentAbsorber object to find all "hello world" text occurences
  TextFragmentAbsorber absorber = new TextFragmentAbsorber("hello world");

  // Accept the absorber for first page
  doc.getPages().get_Item(1).accept(absorber);

  // Change font of the first text occurence
  absorber.getTextFragments().get_Item(1).getTextState().setFont(font);

  // Save document
  doc.save("D:\\Tests\\output.pdf");

Parameters:

ParameterTypeDescription
fontNamejava.lang.StringFont name.
ignoreCasebooleancase sensitivity

Returns: Font - Font object.

findFont(String fontFamilyName, int stl)

public static Font findFont(String fontFamilyName, int stl)

Searches and returns font with specified font name and font style.


The example demonstrates how to find font and replace the font of text of first page.

  // Find font
  Font font = FontRepository.findFont("Arial", FontStyles.Italic);

  // Open document
  Document doc = new Document("D:\\Tests\\input.pdf");
  // Create TextFragmentAbsorber object to find all "hello world" text occurences
  TextFragmentAbsorber absorber = new TextFragmentAbsorber("hello world");

  // Accept the absorber for first page
  doc.getPages().get_Item(1).accept(absorber);

  // Change font of the first text occurence
  absorber.getTextFragments().get_Item(1).getTextState().setFont(font);

  // Save document
  doc.save("D:\\Tests\\output.pdf");

Parameters:

ParameterTypeDescription
fontFamilyNamejava.lang.StringFont family name.
stlintFont style value.

Returns: Font - Font object corresponding to search request parameters.

findFont(String fontFamilyName, int stl, boolean ignoreCase)

public static Font findFont(String fontFamilyName, int stl, boolean ignoreCase)

Searches and returns font with specified font name and font style ignoring or honoring case sensitivity.


The example demonstrates how to find font and replace the font of text of first page.

  // Find font

  Font font = FontRepository.findFont("Arial", FontStyles.Italic, true);

  // Open document
  Document doc = new Document("D:\\Tests\\input.pdf");
  // Create TextFragmentAbsorber object to find all "hello world" text occurences
  TextFragmentAbsorber absorber = new TextFragmentAbsorber("hello world");

  // Accept the absorber for first page
  doc.getPages().get_Item(1).accept(absorber);

  // Change font of the first text occurence
  absorber.getTextFragments().get_Item(1).getTextState().setFont(font);

  // Save document
  doc.save("D:\\Tests\\output.pdf");

Parameters:

ParameterTypeDescription
fontFamilyNamejava.lang.StringFont family name.
stlintFont style value.
ignoreCasebooleancase sensitivity

Returns: Font - Font object corresponding to search request parameters.

openFont(InputStream fontStream, int fontType)

public static Font openFont(InputStream fontStream, int fontType)

Opens font with specified font stream.


The example demonstrates how to open font and replace the font of text of first page.

  // Open font
  InputStream fontStream = new FileInputStream("C:\\WINDOWS\\Fonts\\arial.ttf"))
  {
      Font font = FontRepository.openFont(fontStream, , FontTypes.TTF);

      // Open document
      Document doc = new Document("D:\\Tests\\input.pdf");
      // Create TextFragmentAbsorber object to find all "hello world" text occurrences
      TextFragmentAbsorber absorber = new TextFragmentAbsorber("hello world");

      // Accept the absorber for first page
      doc.getPages().get_Item(1).accept(absorber);

      // Change font of the first text occurrence
      absorber.getTextFragments().get_Item(1).getTextState().setFont ( font);

      // Save document
      doc.save("D:\\Tests\\output.pdf");
  }

Parameters:

ParameterTypeDescription
fontStreamjava.io.InputStreamFont stream.
fontTypeintFont type value.

Returns: Font - Font object.

openFont(String fontFilePath)

public static Font openFont(String fontFilePath)

Opens font with specified font file path.


The example demonstrates how to open font and replace the font of text of first page.

  // Open font
  Font font = FontRepository.openFont("C:\\WINDOWS\\Fonts\\arial.ttf");

  // Open document
  Document doc = new Document("D:\\Tests\\input.pdf");
  // Create TextFragmentAbsorber object to find all "hello world" text occurrences
  TextFragmentAbsorber absorber = new TextFragmentAbsorber("hello world");

  // Accept the absorber for first page
  doc.getPages().get_Item(1).accept(absorber);

  // Change font of the first text occurrence
  absorber.getTextFragments().get_Item(1).getTextState().setFont ( font);

  // Save document
  doc.save("D:\\Tests\\output.pdf");

Parameters:

ParameterTypeDescription
fontFilePathjava.lang.StringFont file path.

Returns: Font - Font object.

openFont(String fontFilePath, String metricsFilePath)

public static Font openFont(String fontFilePath, String metricsFilePath)

Opens font with specified font file path and metrics file path.


The example demonstrates how to open Type1 font with metrics and replace the font of text of first page.

  // Open font
  Font font = FontRepository.openFont("courier.pfb", "courier.afm");

  // Open document
  Document doc = new Document("D:\\Tests\\input.pdf");
  // Create TextFragmentAbsorber object to find all "hello world" text occurrences
  TextFragmentAbsorber absorber = new TextFragmentAbsorber("hello world");

  // Accept the absorber for first page
  doc.getPages().get_Item(1).accept(absorber);

  // Change font of the first text occurrence
  absorber.getTextFragments().get_Item(1).sgetTextState().setFont(font);

  // Save document
  doc.save("D:\\Tests\\output.pdf");

Parameters:

ParameterTypeDescription
fontFilePathjava.lang.StringFont file path.
metricsFilePathjava.lang.StringFont metrics file patrh.

Returns: Font - Font object.

reloadFonts()

public static void reloadFonts()

Reloads all fonts specified by property Sources (#getSources#getSources)

loadFonts()

public static void loadFonts()

Loads system installed fonts and standard Pdf fonts. This method was designed to speed up font loading process. By default fonts are loaded on first request for any font. Use of this method loads system and standard Pdf fonts immediately before any Pdf document was open.

isReplaceNotFoundFonts()

public static boolean isReplaceNotFoundFonts()

Is not found fonts will be replaced by standard font.

Returns: boolean - boolean value

setReplaceNotFoundFonts(boolean value)

public static void setReplaceNotFoundFonts(boolean value)

Set TRUE if need to replace not found fonts with the default font. The default value is false.

Parameters:

ParameterTypeDescription
valuebooleanboolean

clear()

public static void clear()

getLocalFontPaths()

public static List<String> getLocalFontPaths()

Copy of the list with actual font directories.

Returns: java.util.List<java.lang.String> - list of String

isThreadStaticConfigEnabled()

public static boolean isThreadStaticConfigEnabled()

Returns status of Font Sources storage configuration. If true, used ThreadStatic and every thread has own Font Sources. If false, used global static configuration for all the threads.


Default value is True.

Returns: boolean - boolean value

setThreadStaticConfigEnabled(boolean isTheadLocal)

public static void setThreadStaticConfigEnabled(boolean isTheadLocal)

Option for setting Font Sources storage configuration. If true, used ThreadStatic and every thread has own Font Sources. If false, used global static configuration for all the threads.

Parameters:

ParameterTypeDescription
isTheadLocalbooleanboolean value

addLocalFontPath(String path)

public static void addLocalFontPath(String path)

Add one more path to fonts.

Parameters:

ParameterTypeDescription
pathjava.lang.StringString value

setLocalFontPaths(List newFontPathsList)

public static void setLocalFontPaths(List<String> newFontPathsList)

Sets user list with font paths

Parameters:

ParameterTypeDescription
newFontPathsListjava.util.List<java.lang.String>List object

restoreLocalFontPath()

public static void restoreLocalFontPath()

Restores list for standard font directories by default.

addSystemFont(Font font)

public static void addSystemFont(Font font)

Add system font with specified font.


The example demonstrates how to add system font.

  InputStream fontStream = new FileInputStream("C:\\WINDOWS\\Fonts\\arial.ttf"))

  Font font = FontRepository.openFont(fontStream, FontTypes.TTF);

  FontRepository.addSystemFont(font);

Parameters:

ParameterTypeDescription
fontFontFont instance