.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "Template::Plugin::GD::Text 3"
.TH Template::Plugin::GD::Text 3 2024-07-13 "perl v5.38.2" "User Contributed Perl Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH NAME
Template::Plugin::GD::Text \- Text utilities for use with GD
.SH SYNOPSIS
.IX Header "SYNOPSIS"
.Vb 1
\&    [% USE gd_text = GD.Text %]
.Ve
.SH EXAMPLES
.IX Header "EXAMPLES"
.Vb 7
\&    [%
\&        USE gd_c = GD.Constants;
\&        USE t = GD.Text;
\&        x = t.set_text(\*(AqSome text\*(Aq);
\&        r = t.get(\*(Aqwidth\*(Aq, \*(Aqheight\*(Aq, \*(Aqchar_up\*(Aq, \*(Aqchar_down\*(Aq);
\&        r.join(":"); "\en";     # returns 54:13:13:0.
\&    \-%]
\&
\&    [%
\&        USE gd_c = GD.Constants;
\&        USE t = GD.Text(text => \*(AqFooBar Banana\*(Aq, font => gd_c.gdGiantFont);
\&        t.get(\*(Aqwidth\*(Aq); "\en";  # returns 117.
\&    \-%]
.Ve
.SH DESCRIPTION
.IX Header "DESCRIPTION"
The GD.Text plugin provides an interface to the GD::Text module.
It allows attributes of strings such as width and height in pixels
to be computed.
.PP
See GD::Text for more details. See
Template::Plugin::GD::Text::Align and
Template::Plugin::GD::Text::Wrap for plugins that
allow you to render aligned or wrapped text in GD images.
.SH AUTHOR
.IX Header "AUTHOR"
Thomas Boutell wrote the GD graphics library.
.PP
Lincoln D. Stein wrote the Perl GD modules that interface to it
and Martien Verbruggen wrote the GD::Text module.
.PP
Craig Barratt <craig@arraycomm.com> wrote the original GD
plugins for the Template Toolkit (2001).
.PP
Andy Wardley <abw@cpan.org> extracted them from the TT core
into a separate distribution for TT version 2.15.
.SH COPYRIGHT
.IX Header "COPYRIGHT"
Copyright (C) 2001 Craig Barratt <craig@arraycomm.com>,
2006 Andy Wardley <abw@cpan.org>.
.PP
GD::Text is copyright 1999 Martien Verbruggen.
.PP
This module is free software; you can redistribute it and/or
modify it under the same terms as Perl itself.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
Template::Plugin::GD, Template::Plugin::GD::Text::Wrap, Template::Plugin::GD::Text::Align, GD