# NAME

PDF::API2::PDF::TTFont - Inherits from PDF::API2::PDF::Dict and represents a TrueType font within a PDF file.

# DESCRIPTION

A font consists of two primary parts in a PDF file: the header and the font descriptor. Whilst two fonts may share font descriptors, they will have their own header dictionaries including encoding and widhth information.

# INSTANCE VARIABLES

There are no instance variables beyond the variables which directly correspond to entries in the appropriate PDF dictionaries.

# METHODS

## PDF::API2::PDF::TTFont->new($parent, $fontfname, $pdfname, %opts)

Creates a new font resource for the given fontfile. This includes the font descriptor and the font stream. The $pdfname is the name by which this font resource will be known throught a particular PDF file.

All font resources are full PDF objects.

## $t->width($text)

Measures the width of the given text according to the widths in the font

## $t->trim($text, $len)

Trims the given text to the given length (in per mille em) returning the trimmed text

## $t->out_text($text)

Indicates to the font that the text is to be output and returns the text to be output

## $f->copy

Copies the font object excluding the name, widths and encoding, etc.

# TITLE

PDF::API2::PDF::TTIOString - internal IO type handle for string output for font embedding. This code is ripped out of IO::Scalar, to save the direct dependence for so little. See IO::Scalar for details