com.itextpdf.kernel.font

Class PdfType3Font

java.lang.Object

com.itextpdf.kernel.pdf.PdfObjectWrapper<PdfDictionary>

com.itextpdf.kernel.font.PdfFont

com.itextpdf.kernel.font.PdfSimpleFont<Type3Font>

com.itextpdf.kernel.font.PdfType3Font

All Implemented Interfaces:

Serializable

public class PdfType3Font
extends PdfSimpleFont<Type3Font>

Low-level API class for Type 3 fonts.

In Type 3 fonts, glyphs are defined by streams of PDF graphics operators. These streams are associated with character names. A separate encoding entry maps character codes to the appropriate character names for the glyphs.

To be able to be wrapped with this PdfObjectWrapper the PdfObject must be indirect.

See Also:

Serialized Form

Field Summary

Fields inherited from class com.itextpdf.kernel.font.PdfSimpleFont

fontEncoding, forceWidthsOutput, shortTag, toUnicode

Fields inherited from class com.itextpdf.kernel.font.PdfFont

DEFAULT_FONT_MATRIX, embedded, EMPTY_BYTES, fontProgram, newFont, notdefGlyphs, subset, subsetRanges

Method Summary

Modifier and Type	Method and Description
protected void	addFontStream(PdfDictionary fontDescriptor)
Type3Glyph	addGlyph(char c, int wx, int llx, int lly, int urx, int ury) Defines a glyph.
boolean	containsGlyph(int unicode) Check whether font contains glyph with specified unicode.
void	flush() To manually flush a PdfObject behind this wrapper, you have to ensure that this object is added to the document, i.e.
protected PdfDocument	getDocument()
protected PdfDictionary	getFontDescriptor(String fontName) Generates the font descriptor for this font or null if it is one of the 14 built in fonts.
double[]	getFontMatrix()
Glyph	getGlyph(int unicode) Get glyph by unicode
int	getNumberOfGlyphs() Gets count of glyphs in Type 3 font.
Type3Glyph	getType3Glyph(int unicode)
boolean	isEmbedded()
boolean	isSubset() Indicates if all the glyphs and widths for that particular encoding should be included in the document.
void	setFontFamily(String fontFamily) Sets a preferred font family name.
void	setFontMatrix(double[] fontMatrix)
void	setFontName(String fontName) Sets the PostScript name of the font.
void	setFontStretch(String fontWidth) Sets font width in css notation (font-stretch property)
void	setFontWeight(int fontWeight) Sets font weight.
void	setItalicAngle(int italicAngle) Sets the PostScript italic angle.
void	setPdfFontFlags(int flags) Sets Font descriptor flags.

Methods inherited from class com.itextpdf.kernel.font.PdfSimpleFont

appendAnyGlyph, appendGlyphs, convertToBytes, convertToBytes, convertToBytes, createGlyphLine, decode, decodeIntoGlyphLine, flushFontData, getContentWidth, getFontEncoding, isBuiltInFont, isBuiltWith, isForceWidthsOutput, setFontProgram, setForceWidthsOutput, writeText, writeText

Methods inherited from class com.itextpdf.kernel.font.PdfFont

addSubsetRange, compactRanges, getAscent, getAscent, getDescent, getDescent, getFontProgram, getPdfFontStream, getWidth, getWidth, getWidth, getWidth, isWrappedObjectMustBeIndirect, setSubset, splitString, toString, updateSubsetPrefix

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

Method Detail

setFontName

public void setFontName(String fontName)

Sets the PostScript name of the font.

Parameters:

fontName - the PostScript name of the font, shall not be null or empty.

setFontFamily

public void setFontFamily(String fontFamily)

Sets a preferred font family name.

Parameters:

fontFamily - a preferred font family name.

setFontWeight

public void setFontWeight(int fontWeight)

Sets font weight.

Parameters:

fontWeight - integer form 100 to 900. See FontWeights.

setItalicAngle

public void setItalicAngle(int italicAngle)

Sets the PostScript italic angle.

Italic angle in counter-clockwise degrees from the vertical. Zero for upright text, negative for text that leans to the right (forward).

Parameters:

italicAngle - in counter-clockwise degrees from the vertical

setFontStretch

public void setFontStretch(String fontWidth)

Sets font width in css notation (font-stretch property)

Parameters:

fontWidth - FontStretches.

setPdfFontFlags

public void setPdfFontFlags(int flags)

Sets Font descriptor flags.

Parameters:

flags - font descriptor flags.

See Also:

FontDescriptorFlags

getType3Glyph

public Type3Glyph getType3Glyph(int unicode)

isSubset

public boolean isSubset()

Description copied from class: PdfFont

Indicates if all the glyphs and widths for that particular encoding should be included in the document.

Overrides:

isSubset in class PdfFont

Returns:

false to include all the glyphs and widths.

isEmbedded

public boolean isEmbedded()

Overrides:

isEmbedded in class PdfFont

getFontMatrix

public double[] getFontMatrix()

Overrides:

getFontMatrix in class PdfFont

setFontMatrix

public void setFontMatrix(double[] fontMatrix)

getNumberOfGlyphs

public int getNumberOfGlyphs()

Gets count of glyphs in Type 3 font.

Returns:

number of glyphs.

addGlyph

public Type3Glyph addGlyph(char c,
                           int wx,
                           int llx,
                           int lly,
                           int urx,
                           int ury)

Defines a glyph. If the character was already defined it will return the same content

Parameters:

c - the character to match this glyph.

wx - the advance this character will have

llx - the X lower left corner of the glyph bounding box. If the colorize option is true the value is ignored

lly - the Y lower left corner of the glyph bounding box. If the colorize option is true the value is ignored

urx - the X upper right corner of the glyph bounding box. If the colorize option is true the value is ignored

ury - the Y upper right corner of the glyph bounding box. If the colorize option is true the value is ignored

Returns:

a content where the glyph can be defined

getGlyph

public Glyph getGlyph(int unicode)

Description copied from class: PdfFont

Get glyph by unicode

Specified by:

getGlyph in class PdfFont

Parameters:

unicode - a unicode code point

Returns:

Glyph if it exists or .NOTDEF if supported, otherwise null.

containsGlyph

public boolean containsGlyph(int unicode)

Description copied from class: PdfFont

Check whether font contains glyph with specified unicode.

Overrides:

containsGlyph in class PdfFont

Parameters:

unicode - a unicode code point

Returns:

true if font contains glyph, represented with the unicode code point, otherwise false.

flush

public void flush()

Description copied from class: PdfFont

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 PdfFont

getFontDescriptor

protected PdfDictionary getFontDescriptor(String fontName)

Description copied from class: PdfSimpleFont

Generates the font descriptor for this font or null if it is one of the 14 built in fonts.

Overrides:

getFontDescriptor in class PdfSimpleFont<Type3Font>

Returns:

the PdfDictionary containing the font descriptor or null.

addFontStream

protected void addFontStream(PdfDictionary fontDescriptor)

Specified by:

addFontStream in class PdfSimpleFont<Type3Font>

getDocument

protected PdfDocument getDocument()