template::plugin::gd::image(3)
NAME
Template::Plugin::GD::Image - Interface to GD Graphics
Library
SYNOPSIS
[% USE im = GD.Image(x_size, y_size) %]
EXAMPLES
- [% 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
The GD.Image plugin provides an interface to GD.pm's
GD::Image class. The GD::Image class is the main inter
face 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 argu
ment to force binary mode (required for non-modern operat
ing systems).
See GD for a complete description of the GD library and
all the methods that can be called via the GD.Image plu
gin. See Template::Plugin::GD::Constants for a plugin
that allows you access to GD.pm's constants.
AUTHOR
Craig Barratt <craig@arraycomm.com>
Lincoln D. Stein wrote the GD.pm interface to the GD
library.
VERSION
1.43, distributed as part of the Template Toolkit version
2.08, released on 30 July 2002.
COPYRIGHT
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
- Template::Plugin, Template::Plugin::GD, Template::Plu
gin::GD::Polygon, Template::Plugin::GD::Constants, GD