NAME

Template::Plugin::GD::Text - Text utilities for use with GD

SYNOPSIS

    [% USE gd_text = GD.Text %]

EXAMPLES

    [%
        USE gd_c = GD.Constants;
        USE t = GD.Text;
        x = t.set_text('Some text');
        r = t.get('width', 'height', 'char_up', 'char_down');
        r.join(":"); "\n";     # returns 54:13:13:0.
    -%]

    [%
        USE gd_c = GD.Constants;
        USE t = GD.Text(text => 'FooBar Banana', font => gd_c.gdGiantFont);
        t.get('width'); "\n";  # returns 117.
    -%]

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.

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.

AUTHOR

Thomas Boutell wrote the GD graphics library.

Lincoln D. Stein wrote the Perl GD modules that interface to it and Martien Verbruggen wrote the GD::Text module.

Craig Barratt <craig@arraycomm.com> wrote the original GD plugins for the Template Toolkit (2001).

Andy Wardley <abw@cpan.org> extracted them from the TT core into a separate distribution for TT version 2.15.

COPYRIGHT

Copyright (C) 2001 Craig Barratt <craig@arraycomm.com>, 2006 Andy Wardley <abw@cpan.org>.

GD::Text is copyright 1999 Martien Verbruggen.

This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

SEE ALSO

Template::Plugin::GD, Template::Plugin::GD::Text::Wrap, Template::Plugin::GD::Text::Align, GD