/
Image.pm
174 lines (132 loc) · 4.81 KB
/
Image.pm
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
#============================================================= -*-Perl-*-
#
# Template::Plugin::GD::Image
#
# DESCRIPTION
#
# Simple Template Toolkit plugin interfacing to the GD::Image
# class in the GD.pm module.
#
# AUTHOR
# Craig Barratt <craig@arraycomm.com>
#
# COPYRIGHT
# Copyright (C) 2001 Craig Barratt. All Rights Reserved.
#
# This module is free software; you can redistribute it and/or
# modify it under the same terms as Perl itself.
#
#----------------------------------------------------------------------------
#
# $Id$
#
#============================================================================
package Template::Plugin::GD::Image;
require 5.004;
use strict;
use GD;
use Template::Plugin;
use base qw( GD Template::Plugin );
use vars qw( $VERSION );
$VERSION = sprintf("%d.%02d", q$Revision$ =~ /(\d+)\.(\d+)/);
sub new
{
my $class = shift;
my $context = shift;
return new GD::Image(@_);
}
1;
__END__
#------------------------------------------------------------------------
# IMPORTANT NOTE
# This documentation is generated automatically from source
# templates. Any changes you make here may be lost.
#
# The 'docsrc' documentation source bundle is available for download
# from http://www.template-toolkit.org/docs.html and contains all
# the source templates, XML files, scripts, etc., from which the
# documentation for the Template Toolkit is built.
#------------------------------------------------------------------------
=head1 NAME
Template::Plugin::GD::Image - Interface to GD Graphics Library
=head1 SYNOPSIS
[% USE im = GD.Image(x_size, y_size) %]
=head1 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;
-%]
=head1 DESCRIPTION
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 L<GD> for a complete description of the GD library and all the
methods that can be called via the GD.Image plugin.
See L<Template::Plugin::GD::Constants> for a plugin that allows you
access to GD.pm's constants.
=head1 AUTHOR
Craig Barratt E<lt>craig@arraycomm.comE<gt>
Lincoln D. Stein wrote the GD.pm interface to the GD library.
=head1 VERSION
1.15, distributed as part of the
Template Toolkit version 2.05, released on 11 September 2001.
=head1 COPYRIGHT
Copyright (C) 2001 Craig Barratt E<lt>craig@arraycomm.comE<gt>
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.
=head1 SEE ALSO
L<Template::Plugin|Template::Plugin>, L<Template::Plugin::GD|Template::Plugin::GD>, L<Template::Plugin::GD::Polygon|Template::Plugin::GD::Polygon>, L<Template::Plugin::GD::Constants|Template::Plugin::GD::Constants>, L<GD|GD>