## PDF::API2::Text

Subclassed from PDF::API2::Content.

$txt = PDF::API2::Text->new @parameters

Returns a new text content object (called from $page->text).

%state = $txt->textstate %state

Sets or gets the current text-object state.

($tx,$ty) = $txt->textpos

Gets the current estimated text position.

$txt->matrix $a, $b, $c, $d, $e, $f

Sets the matrix.

PLEASE NOTE: This method is not expected to be called by the user and else will 'die'. This was implemented to keep proper state in the text-object, so please use transform, transform_rel, translate, scale, skew or rotate instead.

$txt->transform_rel %opts

Sets transformations (eg. translate, rotate, scale, skew) in pdf-canonical order, but relative to the previously set values.

Example:

    	$txt->transform_rel(
    		-translate => [$x,$y],
    		-rotate    => $rot,
    		-scale     => [$sx,$sy],
    		-skew      => [$sa,$sb],
    	)

$txt->font $fontobj,$size
$spacing = $txt->charspace $spacing
$spacing = $txt->wordspace $spacing
$spacing = $txt->hspace $spacing
$leading = $txt->lead $leading
$rise = $txt->rise $rise
$rendering = $txt->render $rendering
$txt->cr $linesize

takes an optional argument giving a custom leading between lines.

$txt->nl
$txt->distance $dx,$dy
$width = $txt->advancewidth $string

Returns the width of the string based on all currently set text-attributes.

$width = $txt->text $text, %options

Applys text to the content and optionally returns the width of the given text.

You can use the -utf8 option to give the text in utf8.

$txt->text_center $text, %options

You can use the -utf8 option to give the text in utf8.

$txt->text_right $text, %options

You can use the -utf8 option to give the text in utf8.

($width, $overflow) = $txt->text_justify $text , -width => $width [, %options ]

If -overflow is given, $overflow will contain any text, which wont fit into width without exessive scaling.

If -underflow is given, and $text is smaller than $width the text will be typeset using $txt->text.

if -less is given, text overflow will be calculated using minimal number of words.

You can use the -utf8 option to give the text in utf8.

The returned width is that of the typeset text.

$txt->paragraph $text, %options, -x => $xorg, -y => $yorg, -w => $width, -h => $height, -flindent => $firstlineindent, -lead => $lead

You can use the -utf8 option to give the text in utf8.

# AUTHOR

alfred reibenschuh