---
name: "Template::Plugin::GD::Text::Align"
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::Align"
---

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

Draw aligned strings in GD images

## NAME

Template::Plugin::GD::Text::Align - Draw aligned strings in GD images

## SYNOPSIS

```
    [% 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;
    -%]
```

## DESCRIPTION

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.

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

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

## 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, Template::Plugin::GD::Text::Wrap, GD