Index

  1. \SetaPDF
    1. Core
    2. Core
      1. Font
      2. Font
        1. Type0
        2. Type0
          1. Subset

SetaPDF_Core_Font_Type0_Subset Class that represents a PDF Type0 (Composite) font subset.

File: /SetaPDF v2/Core/Font/Type0/Subset.php

This class will embedded a subset of the original TrueType font programm with only glyphs, that were requested by calling the getCharCodes() method.

This font allows you to use several thousands of glyphs (there's a limit of 65000 glyphs).

Class hierarchy

Implements

Summary

Methods

Properties

Constants

Constants

TYPE_COLOR_SPACE

public const string SetaPDF_Core_Resource::TYPE_COLOR_SPACE = 'ColorSpace'

Type constant

TYPE_EXT_G_STATE

public const string SetaPDF_Core_Resource::TYPE_EXT_G_STATE = 'ExtGState'

Type constant

TYPE_FONT

public const string SetaPDF_Core_Resource::TYPE_FONT = 'Font'

Type constant

TYPE_PATTERN

public const string SetaPDF_Core_Resource::TYPE_PATTERN = 'Pattern'

Type constant

TYPE_PROC_SET

public const string SetaPDF_Core_Resource::TYPE_PROC_SET = 'ProcSet'

Type constant

TYPE_PROPERTIES

public const string SetaPDF_Core_Resource::TYPE_PROPERTIES = 'Properties'

Type constant

TYPE_SHADING

public const string SetaPDF_Core_Resource::TYPE_SHADING = 'Shading'

Type constant

TYPE_X_OBJECT

public const string SetaPDF_Core_Resource::TYPE_X_OBJECT = 'XObject'

Type constant


Properties

$_ascent

protected int SetaPDF_Core_Font_TrueType_Subset::$_ascent

The ascent value.

$_charCodes

protected array SetaPDF_Core_Font_Type0_Subset::$_charCodes = array(...)

Mapping from UTF-16BE characters to glyph ids.

$_chars

protected array SetaPDF_Core_Font_Type0_Subset::$_chars = array(...)

Mapping from glyph ids to UTF-16BE charcater codes.

$_cidToGlyphId

protected array SetaPDF_Core_Font_Type0_Subset::$_cidToGlyphId = array(...)

Mapping array from character ids to glyph ids

$_descent

protected int SetaPDF_Core_Font_TrueType_Subset::$_descent

The descent value.

$_dictionary

protected SetaPDF_Core_Type_Dictionary SetaPDF_Core_Font_TrueType_Subset::$_dictionary

The main font dictionary.

$_document

protected SetaPDF_Core_Document SetaPDF_Core_Font_TrueType_Subset::$_document

The document instance.

$_factor

protected float SetaPDF_Core_Font_TrueType_Subset::$_factor

The scaling factor from TrueType units to glyph coordinate system.

$_fontBBox

protected int[] SetaPDF_Core_Font_TrueType_Subset::$_fontBBox

The font bounding box.

$_fontFile

protected SetaPDF_Core_Font_TrueType_File SetaPDF_Core_Font_TrueType_Subset::$_fontFile

The source font file instance.

$_fontName

protected string SetaPDF_Core_Font_TrueType_Subset::$_fontName

The font name.

$_indirectObject

protected null|SetaPDF_Core_Type_IndirectObject SetaPDF_Core_Font_TrueType_Subset::$_indirectObject

The indirect object for the PDF font object.

$_isCidToGlyphMapIdentity

protected bool SetaPDF_Core_Font_Type0_Subset::$_isCidToGlyphMapIdentity = true

Flag saying whether we can use Identity mapping or not.

$_subsetFile

protected SetaPDF_Core_Font_TrueType_Subset_File_ByteEncoding SetaPDF_Core_Font_TrueType_Subset::$_subsetFile

The instance of the subset class.

$_throwExceptionWhenMissingGlyphIsUsed

protected bool SetaPDF_Core_Font_TrueType_Subset::$_throwExceptionWhenMissingGlyphIsUsed = false

Flag saying whether an exception should be thrown if a character is not available or not.

$_widths

protected int[] SetaPDF_Core_Font_TrueType_Subset::$_widths = array()

The widths of the used glyphs.

$_writeCidSet

protected bool SetaPDF_Core_Font_Type0_Subset::$_writeCidSet = false

Flag saying whether to write the CIDSet entry or not.

$maxCharLimit

public int SetaPDF_Core_Font_TrueType_Subset::$maxCharLimit = 256

The char count limit.


Methods

__construct()

public SetaPDF_Core_Font_Type0_Subset::__construct (
SetaPDF_Core_Document $document, SetaPDF_Core_Font_TrueType_File|string|SetaPDF_Core_Reader_Binary $fontFile [, bool $throwExceptionWhenMissingGlyphIsUsed = false [, bool $ignoreLicenseRestrictions = false ]]
)

The constructor.

Parameters
$document : SetaPDF_Core_Document
 
$fontFile : SetaPDF_Core_Font_TrueType_File|string|SetaPDF_Core_Reader_Binary
 
$throwExceptionWhenMissingGlyphIsUsed : bool

Whether an exception should be thrown if the registered character cannot be found or not.

$ignoreLicenseRestrictions : bool

Can be used to disable the font license check

Exceptions

Throws SetaPDF_Core_Exception

Throws SetaPDF_Core_Font_Exception

Throws SetaPDF_Core_Font_TrueType_Subset_Exception

Throws SetaPDF_Exception_NotImplemented

_createCidSet()

protected SetaPDF_Core_Font_Type0_Subset::_createCidSet (
void
): SetaPDF_Core_Type_Stream

Create the CIDSet stream.

Exceptions

Throws SetaPDF_Core_Font_Exception

_createCidToGidMap()

protected SetaPDF_Core_Font_Type0_Subset::_createCidToGidMap (
void
): SetaPDF_Core_Type_Name|SetaPDF_Core_Type_IndirectObject

Create the CIDtoGIDMap entry.

_createSubset()

protected SetaPDF_Core_Font_Type0_Subset::_createSubset (
void
): void

Create the final subset file and embed it into the PDF document.

Exceptions

Throws SetaPDF_Core_Font_Exception

Throws SetaPDF_Exception_NotImplemented

_getSubsetFile()

protected SetaPDF_Core_Font_Type0_Subset::_getSubsetFile (
void
): SetaPDF_Core_Font_TrueType_Subset_File

Gets the subset file instance.

Exceptions

Throws SetaPDF_Core_Font_Exception

_getToUnicode()

protected SetaPDF_Core_Font_Type0_Subset::_getToUnicode (
void
): string

Returns the ToUnicode cmap.

_getWidthArray()

protected SetaPDF_Core_Font_Type0_Subset::_getWidthArray (
void
): SetaPDF_Core_Type_Array

Create the width array.

Exceptions

Throws SetaPDF_Core_Font_Exception

Throws SetaPDF_Exception_NotImplemented

_registerChar()

protected SetaPDF_Core_Font_Type0_Subset::_registerChar (
string $char, string $charCode
): void

Registers a glyph that got registered in the font subsetter.

Parameters
$char : string
 
$charCode : string
 

cleanUp()

public SetaPDF_Core_Font_TrueType_Subset::cleanUp (
void
): void

Release cycled references and memory.

getAscent()

public SetaPDF_Core_Font_TrueType_Subset::getAscent (
void
): float

Returns the distance from baseline of highest ascender (Typographic ascent).

Exceptions

Throws SetaPDF_Exception_NotImplemented

getCharCodes()

public SetaPDF_Core_Font_TrueType_Subset::getCharCodes (
string $chars [, string $encoding = 'UTF-16BE' ]
): array

Get the final character codes of a character string.

Parameters
$chars : string

The character string

$encoding : string

The output encoding

Exceptions

Throws SetaPDF_Core_Font_Exception

Throws SetaPDF_Exception_NotImplemented

getDescent()

public SetaPDF_Core_Font_TrueType_Subset::getDescent (
void
): float

Returns the distance from baseline of lowest descender (Typographic descent).

Exceptions

Throws SetaPDF_Exception_NotImplemented

getDocument()

public SetaPDF_Core_Font_TrueType_Subset::getDocument (
void
): SetaPDF_Core_Document

Get the document instance.

getFontBBox()

public SetaPDF_Core_Font_TrueType_Subset::getFontBBox (
void
): int[]

Get the font bounding box array.

Exceptions

Throws SetaPDF_Core_Font_Exception

Throws SetaPDF_Exception_NotImplemented

getFontDescriptorFlags()

public SetaPDF_Core_Font_TrueType_Subset::getFontDescriptorFlags (
void
): int

Get flags defining various characteristics of the font.

Exceptions

Throws SetaPDF_Exception_NotImplemented

See
  • PDF 32000-1:2008 - 9.8.2 Font Descriptor Flags

getFontFile()

public SetaPDF_Core_Font_TrueType_Subset::getFontFile (
void
): SetaPDF_Core_Font_TrueType_File

Get the source true type file.

getFontName()

public SetaPDF_Core_Font_TrueType_Subset::getFontName (
void
): string

Get the font name.

Exceptions

Throws SetaPDF_Core_Font_Exception

Throws SetaPDF_Exception_NotImplemented

getGlyphWidth()

public SetaPDF_Core_Font_TrueType_Subset::getGlyphWidth (
string $char [, string $encoding = 'UTF-16BE' ]
): int

Get the glyph width of a single character.

Parameters
$char : string

The character

$encoding : string

The encoding of the character

Exceptions

Throws SetaPDF_Core_Font_Exception

Throws SetaPDF_Exception_NotImplemented

getGlyphWidthByCharCode()

public SetaPDF_Core_Font_TrueType_Subset::getGlyphWidthByCharCode (
string $charCode
): int

Get the glyph width by a char code.

Parameters
$charCode : string
 
Exceptions

Throws SetaPDF_Core_Font_Exception

Throws SetaPDF_Exception_NotImplemented

getGlyphsWidth()

public SetaPDF_Core_Font_TrueType_Subset::getGlyphsWidth (
string $chars [, string $encoding = 'UTF-16BE' ]
): int

Get the glyphs width of a string.

Parameters
$chars : string

The string

$encoding : string

The encoding of the characters

Exceptions

Throws SetaPDF_Core_Font_Exception

Throws SetaPDF_Exception_NotImplemented

getIndirectObject()

public SetaPDF_Core_Font_TrueType_Subset::getIndirectObject (
[ SetaPDF_Core_Document|null $document = null ]
): SetaPDF_Core_Type_IndirectObject

Get the indirect object of this resource.

Parameters
$document : SetaPDF_Core_Document|null
 

getRegisteredChars()

public SetaPDF_Core_Font_TrueType_Subset::getRegisteredChars (
void
): array

Get all registered characters (UTF-16BE encoded) indexed by their glyph ids.

getResourceType()

public SetaPDF_Core_Font_TrueType_Subset::getResourceType (
void
): string

Get the resource type of an implementation.

getUnderlinePosition()

public SetaPDF_Core_Font_TrueType_Subset::getUnderlinePosition (
void
): int|float

Get the underline position.

Exceptions

Throws SetaPDF_Exception_NotImplemented

getUnderlineThickness()

public SetaPDF_Core_Font_TrueType_Subset::getUnderlineThickness (
void
): int|float

Get the underline thickness.

Exceptions

Throws SetaPDF_Exception_NotImplemented

setWriteCidSet()

public SetaPDF_Core_Font_Type0_Subset::setWriteCidSet (
[ bool $writeCidSet = true ]
): void

Defines whether the CIDSet entry is created and written or not.

This was required for PDF/A-1 and are optional in PDF/A-2 and PDF/A-3.

Parameters
$writeCidSet : bool
 

splitCharCodes()

public SetaPDF_Core_Font_Type0_Subset::splitCharCodes (
string $charCodes
): array

Split a string of char codes into single char codes.

Parameters
$charCodes : string
 

© 2024 Setasign GmbH & Co. KG · Contact / Imprint · Data Privacy Statement (German)