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

Template::Plugin::GD::Text::Align3pm

Draw aligned strings in gd images

Usage

    [% USE align = GD.Text.Align(gd_image); %]

Examples

    [% FILTER null;
        USE im  = GD.Image(100,100);
        USE gdc = GD.Constants;
        # allocate some colors
        black = im.colorAllocate(0,   0, 0);
        red   = im.colorAllocate(255,0,  0);
        blue  = im.colorAllocate(0,  0,  255);
        # Draw a blue oval
        im.arc(50,50,95,75,0,360,blue);
        USE a = GD.Text.Align(im);
        a.set_font(gdc.gdLargeFont);
        a.set_text("Hello");
        a.set(colour => red, halign => "center");
        a.draw(50,70,0);
        # Output image in PNG format
        im.png | stdout(1);
       END;
    -%]

Overview

The GD.Text.Align plugin provides an interface to the GD::Text::Align module. It allows text to be drawn in GD images with various alignments and orientations.

See GD::Text::Align for more details. See Template::Plugin::GD::Text::Wrap for a plugin that allow you to render wrapped text in GD images.

Releases

13 releases since Debian 3.0 (Woody); the text changed 5 times.

  1. 3.0
  2. 3.1–4.0
  3. 5.0–10
  4. 11
  5. 12–13
  6. Arch

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 <[email protected]> wrote the original GD plugins for the Template Toolkit (2001).

Andy Wardley <[email protected]> extracted them from the TT core into a separate distribution for TT version 2.15.

These modules are looking for a new maintainer. Please contact Andy Wardley if you are willing to help out.

From perl-template-gd 2.66-8 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.