PdfFont (iText 7 7.0.6 API)

java.lang.Object
- com.itextpdf.kernel.pdf.PdfObjectWrapper<PdfDictionary>
- - com.itextpdf.kernel.font.PdfFont

All Implemented Interfaces:

Serializable

Direct Known Subclasses:

PdfSimpleFont, PdfType0Font
```
public abstract class PdfFont
extends PdfObjectWrapper<PdfDictionary>
```
See Also:

Serialized Form

Field Summary

Fields
Modifier and Type	Field and Description
`protected boolean`	`embedded` true if the font is to be embedded in the PDF.
`protected static byte[]`	`emptyBytes`
`protected FontProgram`	`fontProgram`
`protected boolean`	`newFont` false, if the font comes from PdfDocument.
`protected Map<Integer,Glyph>`	`notdefGlyphs`
`protected boolean`	`subset` Indicates if all the glyphs and widths for that particular encoding should be included in the document.
`protected List`	`subsetRanges`

Constructor Summary

Constructors
Modifier	Constructor and Description
`protected`	`PdfFont()`
`protected`	`PdfFont(PdfDictionary fontDictionary)`

Method Summary

All Methods Static Methods Instance Methods Abstract Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`void`	`addSubsetRange(int[] range)` Adds a character range when subsetting.
`int`	`appendAnyGlyph(String text, int from, List<Glyph> glyphs)` Append any single glyph, even notdef.
`int`	`appendGlyphs(String text, int from, int to, List<Glyph> glyphs)` Append all supported glyphs and return number of processed chars.
`protected boolean`	`checkFontDictionary(PdfDictionary fontDic, PdfName fontType)`
`protected boolean`	`checkTrueTypeFontDictionary(PdfDictionary fontDic)` Deprecated. Will be removed in 7.1
`protected boolean`	`checkTrueTypeFontDictionary(PdfDictionary fontDic, boolean isException)` Deprecated. Will be removed in 7.1
`protected static int[]`	`compactRanges(List ranges)`
`boolean`	`containsGlyph(char unicode)` Deprecated. Use `containsGlyph(int)` instead.
`boolean`	`containsGlyph(int unicode)` Check whether font contains glyph with specified unicode.
`boolean`	`containsGlyph(String text, int from)` Check whether font contains glyph with specified unicode.
`abstract byte[]`	`convertToBytes(Glyph glyph)`
`abstract byte[]`	`convertToBytes(GlyphLine glyphLine)`
`abstract byte[]`	`convertToBytes(String text)` Converts the text into bytes to be placed in the document.
`abstract GlyphLine`	`createGlyphLine(String content)`
`protected static String`	`createSubsetPrefix()` Deprecated.
`abstract String`	`decode(PdfString content)`
`GlyphLine`	`decodeIntoGlyphLine(PdfString content)` Decodes a given `PdfString` containing encoded string (e.g.
`void`	`flush()` To manually flush a `PdfObject` behind this wrapper, you have to ensure that this object is added to the document, i.e.
`int`	`getAscent(int unicode, float fontSize)` Gets the ascent of a char code in normalized 1000 units.
`int`	`getAscent(String text, float fontSize)` Gets the ascent of a `String` in points.
`abstract float`	`getContentWidth(PdfString content)`
`int`	`getDescent(int unicode, float fontSize)` Gets the descent of a char code in points.
`int`	`getDescent(String text, float fontSize)` Gets the descent of a `String` in points.
`protected abstract PdfDictionary`	`getFontDescriptor(String fontName)`
`double[]`	`getFontMatrix()`
`FontProgram`	`getFontProgram()`
`abstract Glyph`	`getGlyph(int unicode)` Get glyph by unicode
`protected PdfStream`	`getPdfFontStream(byte[] fontStreamBytes, int[] fontStreamLengths)` Create `PdfStream` based on `fontStreamBytes`.
`int`	`getWidth(int unicode)` Returns the width of a certain character of this font in 1000 normalized units.
`float`	`getWidth(int unicode, float fontSize)` Returns the width of a certain character of this font in points.
`int`	`getWidth(String text)` Returns the width of a string of this font in 1000 normalized units.
`float`	`getWidth(String text, float fontSize)` Gets the width of a `String` in points.
`boolean`	`isEmbedded()`
`boolean`	`isSubset()` Indicates if all the glyphs and widths for that particular encoding should be included in the document.
`protected boolean`	`isWrappedObjectMustBeIndirect()` Defines if the object behind this wrapper must be an indirect object in the resultant document.
`void`	`setSubset(boolean subset)` Indicates if all the glyphs and widths for that particular encoding should be included in the document.
`List<String>`	`splitString(String text, float fontSize, float maxWidth)`
`List<String>`	`splitString(String text, int fontSize, float maxWidth)` Deprecated. Will be removed in 7.1. Use `splitString(String, float, float)` instead
`String`	`toString()`
`protected static String`	`updateSubsetPrefix(String fontName, boolean isSubset, boolean isEmbedded)` Adds a unique subset prefix to be added to the font name when the font is embedded and subset.
`abstract void`	`writeText(GlyphLine text, int from, int to, PdfOutputStream stream)`
`void`	`writeText(GlyphLine text, PdfOutputStream stream)` Deprecated.
`abstract void`	`writeText(String text, PdfOutputStream stream)`

Methods inherited from class com.itextpdf.kernel.pdf.PdfObjectWrapper
ensureObjectIsAddedToDocument, ensureUnderlyingObjectHasIndirectReference, getPdfObject, isFlushed, makeIndirect, makeIndirect, markObjectAsIndirect, setForbidRelease, setModified, setPdfObject, unsetForbidRelease

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Field Detail
  - fontProgram
```
protected FontProgram fontProgram
```
  - emptyBytes
```
protected static final byte[] emptyBytes
```
  - notdefGlyphs
```
protected Map<Integer,Glyph> notdefGlyphs
```
  - newFont
```
protected boolean newFont
```
    false, if the font comes from PdfDocument.
  - embedded
```
protected boolean embedded
```
    true if the font is to be embedded in the PDF.
  - subset
```
protected boolean subset
```
    Indicates if all the glyphs and widths for that particular encoding should be included in the document.
  - subsetRanges
```
protected List subsetRanges
```
- Constructor Detail
  - PdfFont
```
protected PdfFont(PdfDictionary fontDictionary)
```
  - PdfFont
```
protected PdfFont()
```
- Method Detail
  - getGlyph
```
public abstract Glyph getGlyph(int unicode)
```
    Get glyph by unicode
    
    Parameters:
    
    unicode - a unicode code point
    
    Returns:
    
    Glyph if it exists or .NOTDEF if supported, otherwise null.
  - containsGlyph
```
@Deprecated
public boolean containsGlyph(char unicode)
```
    Deprecated. Use containsGlyph(int) instead.
    
    Check whether font contains glyph with specified unicode.
    
    Parameters:
    
    unicode - a unicode code point
    
    Returns:
    
    true if font contains glyph, represented with the unicode code point, otherwise false.
  - containsGlyph
```
public boolean containsGlyph(int unicode)
```
    Check whether font contains glyph with specified unicode.
    
    Parameters:
    
    unicode - a unicode code point
    
    Returns:
    
    true if font contains glyph, represented with the unicode code point, otherwise false.
  - containsGlyph
```
public boolean containsGlyph(String text,
                             int from)
```
    Check whether font contains glyph with specified unicode.
    
    Parameters:
    
    text - a java unicode string
    
    from - start index. one or two char may be used.
    
    Returns:
    
    true if font contains glyph, represented with the unicode code point, otherwise false.
  - createGlyphLine
```
public abstract GlyphLine createGlyphLine(String content)
```
  - appendGlyphs
```
public int appendGlyphs(String text,
                        int from,
                        int to,
                        List<Glyph> glyphs)
```
    Append all supported glyphs and return number of processed chars. Composite font supports surrogate pairs.
    
    Parameters:
    
    text - String to convert to glyphs.
    
    from - from index of the text.
    
    to - to index of the text.
    
    glyphs - array for a new glyphs, shall not be null.
    
    Returns:
    
    number of processed chars from text.
  - appendAnyGlyph
```
public int appendAnyGlyph(String text,
                          int from,
                          List<Glyph> glyphs)
```
    Append any single glyph, even notdef. Returns number of processed chars: 2 in case surrogate pair, otherwise 1.
    
    Parameters:
    
    text - String to convert to glyphs.
    
    from - from index of the text.
    
    glyphs - array for a new glyph, shall not be null.
    
    Returns:
    
    number of processed chars: 2 in case surrogate pair, otherwise 1
  - convertToBytes
```
public abstract byte[] convertToBytes(String text)
```
    Converts the text into bytes to be placed in the document. The conversion is done according to the font and the encoding and the characters used are stored.
    
    Parameters:
    
    text - the text to convert
    
    Returns:
    
    the conversion
  - convertToBytes
```
public abstract byte[] convertToBytes(GlyphLine glyphLine)
```
  - decode
```
public abstract String decode(PdfString content)
```
  - decodeIntoGlyphLine
```
public GlyphLine decodeIntoGlyphLine(PdfString content)
```
    Decodes a given PdfString containing encoded string (e.g. from content stream) into a GlyphLine
    
    Parameters:
    
    content - the encoded string
    
    Returns:
    
    the GlyphLine containing the glyphs encoded by the passed string
  - getContentWidth
```
public abstract float getContentWidth(PdfString content)
```
  - convertToBytes
```
public abstract byte[] convertToBytes(Glyph glyph)
```
  - writeText
```
public abstract void writeText(GlyphLine text,
                               int from,
                               int to,
                               PdfOutputStream stream)
```
  - writeText
```
public abstract void writeText(String text,
                               PdfOutputStream stream)
```
  - writeText
```
@Deprecated
public void writeText(GlyphLine text,
                                  PdfOutputStream stream)
```
    Deprecated.
  - getFontMatrix
```
public double[] getFontMatrix()
```
  - getWidth
```
public int getWidth(int unicode)
```
    Returns the width of a certain character of this font in 1000 normalized units.
    
    Parameters:
    
    unicode - a certain character.
    
    Returns:
    
    a width in Text Space.
  - getWidth
```
public float getWidth(int unicode,
                      float fontSize)
```
    Returns the width of a certain character of this font in points.
    
    Parameters:
    
    unicode - a certain character.
    
    fontSize - the font size.
    
    Returns:
    
    a width in points.
  - getWidth
```
public int getWidth(String text)
```
    Returns the width of a string of this font in 1000 normalized units.
    
    Parameters:
    
    text - a string content.
    
    Returns:
    
    a width of string in Text Space.
  - getWidth
```
public float getWidth(String text,
                      float fontSize)
```
    Gets the width of a String in points.
    
    Parameters:
    
    text - the String to get the width of
    
    fontSize - the font size
    
    Returns:
    
    the width in points
  - getDescent
```
public int getDescent(String text,
                      float fontSize)
```
    Gets the descent of a String in points. The descent will always be less than or equal to zero even if all the characters have an higher descent.
    
    Parameters:
    
    text - the String to get the descent of
    
    fontSize - the font size
    
    Returns:
    
    the descent in points
  - getDescent
```
public int getDescent(int unicode,
                      float fontSize)
```
    Gets the descent of a char code in points. The descent will always be less than or equal to zero even if all the characters have an higher descent.
    
    Parameters:
    
    unicode - the char code to get the descent of
    
    fontSize - the font size
    
    Returns:
    
    the descent in points
  - getAscent
```
public int getAscent(String text,
                     float fontSize)
```
    Gets the ascent of a String in points. The ascent will always be greater than or equal to zero even if all the characters have a lower ascent.
    
    Parameters:
    
    text - the String to get the ascent of
    
    fontSize - the font size
    
    Returns:
    
    the ascent in points
  - getAscent
```
public int getAscent(int unicode,
                     float fontSize)
```
    Gets the ascent of a char code in normalized 1000 units. The ascent will always be greater than or equal to zero even if all the characters have a lower ascent.
    
    Parameters:
    
    unicode - the char code to get the ascent of
    
    fontSize - the font size
    
    Returns:
    
    the ascent in points
  - getFontProgram
```
public FontProgram getFontProgram()
```
  - isEmbedded
```
public boolean isEmbedded()
```
  - isSubset
```
public boolean isSubset()
```
    Indicates if all the glyphs and widths for that particular encoding should be included in the document.
    
    Returns:
    
    false to include all the glyphs and widths.
  - setSubset
```
public void setSubset(boolean subset)
```
    Indicates if all the glyphs and widths for that particular encoding should be included in the document. When set to true only the glyphs used will be included in the font. When set to false and addSubsetRange(int[]) was not called the full font will be included otherwise just the characters ranges will be included.
    
    Parameters:
    
    subset - new value of property subset
  - addSubsetRange
```
public void addSubsetRange(int[] range)
```
    Adds a character range when subsetting. The range is an int array where the first element is the start range inclusive and the second element is the end range inclusive. Several ranges are allowed in the same array.
    
    Parameters:
    
    range - the character range
  - splitString
```
@Deprecated
public List<String> splitString(String text,
                                            int fontSize,
                                            float maxWidth)
```
    Deprecated. Will be removed in 7.1. Use splitString(String, float, float) instead
  - splitString
```
public List<String> splitString(String text,
                                float fontSize,
                                float maxWidth)
```
  - flush
```
public void flush()
```
    To manually flush a PdfObject behind this wrapper, you have to ensure that this object is added to the document, i.e. it has an indirect reference. Basically this means that before flushing you need to explicitly call PdfObjectWrapper.makeIndirect(PdfDocument). For example: wrapperInstance.makeIndirect(document).flush(); Note that not every wrapper require this, only those that have such warning in documentation.
    
    Overrides:
    
    flush in class PdfObjectWrapper<PdfDictionary>
  - getFontDescriptor
```
protected abstract PdfDictionary getFontDescriptor(String fontName)
```
  - isWrappedObjectMustBeIndirect
```
protected boolean isWrappedObjectMustBeIndirect()
```
    Description copied from class: PdfObjectWrapper
    
    Defines if the object behind this wrapper must be an indirect object in the resultant document.
    
    If this method returns true it doesn't necessarily mean that object must be in the indirect state at any moment, but rather defines that when the object will be written to the document it will be transformed into indirect object if it's not indirect yet.
    
    Return value of this method shouldn't depend on any logic, it should return always true or false.
    
    Specified by:
    
    isWrappedObjectMustBeIndirect in class PdfObjectWrapper<PdfDictionary>
    
    Returns:
    
    true if in the resultant document the object behind the wrapper must be indirect, otherwise false.
  - checkFontDictionary
```
protected boolean checkFontDictionary(PdfDictionary fontDic,
                                      PdfName fontType)
```
  - checkTrueTypeFontDictionary
```
@Deprecated
protected boolean checkTrueTypeFontDictionary(PdfDictionary fontDic)
```
    Deprecated. Will be removed in 7.1
  - checkTrueTypeFontDictionary
```
@Deprecated
protected boolean checkTrueTypeFontDictionary(PdfDictionary fontDic,
                                                          boolean isException)
```
    Deprecated. Will be removed in 7.1
  - createSubsetPrefix
```
@Deprecated
protected static String createSubsetPrefix()
```
    Deprecated.
    
    Creates a unique subset prefix to be added to the font name when the font is embedded and subset.
    
    Returns:
    
    the subset prefix
  - updateSubsetPrefix
```
protected static String updateSubsetPrefix(String fontName,
                                           boolean isSubset,
                                           boolean isEmbedded)
```
    Adds a unique subset prefix to be added to the font name when the font is embedded and subset.
    
    Returns:
    
    the font name with subset prefix if isSubset and isEmbedded are true.s
  - getPdfFontStream
```
protected PdfStream getPdfFontStream(byte[] fontStreamBytes,
                                     int[] fontStreamLengths)
```
    Create PdfStream based on fontStreamBytes.
    
    Parameters:
    
    fontStreamBytes - original font data, must be not null.
    
    fontStreamLengths - array to generate Length* keys, must be not null.
    
    Returns:
    
    the PdfStream containing the font or null, if there is an error reading the font.
    
    Throws:
    
    PdfException - Method will throw exception if fontStreamBytes is null.
  - compactRanges
```
protected static int[] compactRanges(List ranges)
```
  - toString
```
public String toString()
```
    Overrides:
    
    toString in class Object

Class PdfFont

Field Summary

Constructor Summary

Method Summary

Methods inherited from class com.itextpdf.kernel.pdf.PdfObjectWrapper

Methods inherited from class java.lang.Object

Field Detail

fontProgram

emptyBytes

notdefGlyphs

newFont

embedded

subset

subsetRanges

Constructor Detail

PdfFont

PdfFont

Method Detail

getGlyph

containsGlyph

containsGlyph

containsGlyph

createGlyphLine

appendGlyphs

appendAnyGlyph

convertToBytes

convertToBytes

decode

decodeIntoGlyphLine

getContentWidth

convertToBytes

writeText

writeText

writeText

getFontMatrix

getWidth

getWidth

getWidth

getWidth

getDescent

getDescent

getAscent

getAscent

getFontProgram

isEmbedded

isSubset

setSubset

addSubsetRange

splitString

splitString

flush

getFontDescriptor

isWrappedObjectMustBeIndirect

checkFontDictionary

checkTrueTypeFontDictionary

checkTrueTypeFontDictionary

createSubsetPrefix

updateSubsetPrefix

getPdfFontStream

compactRanges

toString