.\" -*- 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::Align 3"
.TH Template::Plugin::GD::Text::Align 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::Align \- Draw aligned strings in GD images
.SH SYNOPSIS
.IX Header "SYNOPSIS"
.Vb 1
\&    [% USE align = GD.Text.Align(gd_image); %]
.Ve
.SH EXAMPLES
.IX Header "EXAMPLES"
.Vb 9
\&    [% 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;
\&    \-%]
.Ve
.SH DESCRIPTION
.IX Header "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.
.PP
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.
.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.
.PP
These modules are looking for a new maintainer.  Please contact 
Andy Wardley if you are willing to help out.
.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, Template::Plugin::GD::Text::Wrap, GD