---
name: "Template::Plugin::GD::Text"
section: "3pm"
platform: "linux"
package: "perl-template-gd"
version: "2.66-8"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/Template::Plugin::GD::Text"
---

# Template::Plugin::GD::Text(3pm)

Text utilities for use with GD

## 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