Package com.pdftools.optimization

Class FontOptions

  • public class FontOptions
extends NativeObject

    The parameters for font optimization

    • Method Detail

      • getMerge

        public boolean getMerge()

        Whether to merge fonts and font programs (Getter)

        A PDF document can have the same font, or a subset of it, embedded multiple times. This commonly occurs, when multiple PDFs are merged into one large PDF. Such fonts can be merged into one font.

        Merging fonts and font programs can greatly reduce the file size. However, it is computationally complex and can increase file processing time and memory usage substantially.

        Default: true.

      • setMerge

        public void setMerge​(boolean value)

        Whether to merge fonts and font programs (Setter)

        A PDF document can have the same font, or a subset of it, embedded multiple times. This commonly occurs, when multiple PDFs are merged into one large PDF. Such fonts can be merged into one font.

        Merging fonts and font programs can greatly reduce the file size. However, it is computationally complex and can increase file processing time and memory usage substantially.

        Default: true.

      • getRemoveStandardFonts

        public boolean getRemoveStandardFonts()

        Whether to remove standard fonts (Getter)

        Enable or disable un-embedding of the font programs of all embedded standard fonts, such as Arial, Courier, CourierNew, Helvetica, Symbol, Times, TimesNewRoman and ZapfDingbats. This decreases the file size.

        The fonts are replaced with one of the 14 PDF Standard Fonts, all of which have no associated font program. A PDF viewer must be able to display these 14 PDF Standard Fonts correctly. Therefore, enabling this property usually does not visually alter the PDF when it is displayed.

        Un-embedding the font works based on the font's Unicode information, i.e. the un-embedded font's characters are mapped to those of the original font with the same Unicode. Therefore, only fonts with Unicode information are un-embedded.

        If a font's Unicode information is incorrect, un-embedding may lead to visual differences. The correctness of a Unicode information can be verified by extracting text that uses the font.

        If the extracted text is meaningful, the font's Unicode information is correct, and un-embedding of the font does not cause visual differences.

        Default: false (disabled) except in the profile profiles.MinimalFileSize.

      • setRemoveStandardFonts

        public void setRemoveStandardFonts​(boolean value)

        Whether to remove standard fonts (Setter)

        Enable or disable un-embedding of the font programs of all embedded standard fonts, such as Arial, Courier, CourierNew, Helvetica, Symbol, Times, TimesNewRoman and ZapfDingbats. This decreases the file size.

        The fonts are replaced with one of the 14 PDF Standard Fonts, all of which have no associated font program. A PDF viewer must be able to display these 14 PDF Standard Fonts correctly. Therefore, enabling this property usually does not visually alter the PDF when it is displayed.

        Un-embedding the font works based on the font's Unicode information, i.e. the un-embedded font's characters are mapped to those of the original font with the same Unicode. Therefore, only fonts with Unicode information are un-embedded.

        If a font's Unicode information is incorrect, un-embedding may lead to visual differences. The correctness of a Unicode information can be verified by extracting text that uses the font.

        If the extracted text is meaningful, the font's Unicode information is correct, and un-embedding of the font does not cause visual differences.

        Default: false (disabled) except in the profile profiles.MinimalFileSize.