|  | Tutorial |  |

|  | Manual |  |

|  | Modules |  |

|  | Library |  |

|  | Tools |  |

|  | FAQ |  |

|  | Release |  |

| Template Toolkit | Modules | Template::Plugin::GD::Image |

## Template::Plugin::GD::Image

| Template::Plugin::Format

Template::Plugin::GD::Polygon |

Interface to GD Graphics Library

### Table of Contents

- SYNOPSIS
- EXAMPLES
- DESCRIPTION
- AUTHOR
- VERSION
- COPYRIGHT
- SEE ALSO

SYNOPSIS | [ Index ] [ Modules ] [ Top ]

        [% USE im = GD.Image(x_size, y_size) %]

EXAMPLES | [ Index ] [ Modules ] [ Top ]

        [% FILTER null;
            USE gdc = GD.Constants;
            USE im  = GD.Image(200,100);
            black = im.colorAllocate(0  ,0,  0);
            red   = im.colorAllocate(255,0,  0);
            r = im.string(gdc.gdLargeFont, 10, 10, "Large Red Text", red);
            im.png | stdout(1);
           END;
        -%]

        [% FILTER null;
            USE im = GD.Image(100,100);
            # 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);
            # And fill it with red
            im.fill(50,50,red);
            # Output binary image in PNG format
            im.png | stdout(1);
           END;
        -%]

        [% FILTER null;
            USE im   = GD.Image(100,100);
            USE c    = GD.Constants;
            USE poly = GD.Polygon;

            # allocate some colors
            white = im.colorAllocate(255,255,255);
            black = im.colorAllocate(0,  0,  0);
            red   = im.colorAllocate(255,0,  0);
            blue  = im.colorAllocate(0,  0,255);
            green = im.colorAllocate(0,  255,0);

            # make the background transparent and interlaced
            im.transparent(white);
            im.interlaced('true');

            # Put a black frame around the picture
            im.rectangle(0,0,99,99,black);

            # Draw a blue oval
            im.arc(50,50,95,75,0,360,blue);

            # And fill it with red
            im.fill(50,50,red);

            # Draw a blue triangle
            poly.addPt(50,0);
            poly.addPt(99,99);
            poly.addPt(0,99);
            im.filledPolygon(poly, blue);

            # Output binary image in PNG format
            im.png | stdout(1);
           END;
        -%]

DESCRIPTION | [ Index ] [ Modules ] [ Top ]

The GD.Image plugin provides an interface to GD.pm's GD::Image class. The GD::Image class is the main interface to GD.pm.

It is very important that no extraneous template output appear before or after the image. Since some methods return values that would otherwise appear in the output, it is recommended that GD.Image code be wrapped in a null filter. The methods that produce the final output (eg, png, jpeg, gd etc) can then explicitly make their output appear by using the stdout filter, with a non-zero argument to force binary mode (required for non-modern operating systems).

See GD for a complete description of the GD library and all the methods that can be called via the GD.Image plugin. See Template::Plugin::GD::Constants for a plugin that allows you access to GD.pm's constants.

AUTHOR | [ Index ] [ Modules ] [ Top ]

Craig Barratt <craig@arraycomm.com> Lincoln D. Stein wrote the GD.pm interface to the GD library.

VERSION | [ Index ] [ Modules ] [ Top ]

1.56, distributed as part of the Template Toolkit version 2.14, released on 04 October 2004.

COPYRIGHT | [ Index ] [ Modules ] [ Top ]

Copyright (C) 2001 Craig Barratt <craig@arraycomm.com> The GD.pm interface is copyright 1995-2000, Lincoln D. Stein. This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

SEE ALSO | [ Index ] [ Modules ] [ Top ]

Template::Plugin, Template::Plugin::GD, Template::Plugin::GD::Polygon, Template::Plugin::GD::Constants, GD

| Template::Plugin::Format

Template::Plugin::GD::Polygon |

| Tutorial |

| Manual |

| Modules |

| Library |

| Tools |

| FAQ |

| Release |

| http://www.template-toolkit.org/ |