[%# # 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. -%] [% META book = 'Modules' page = 'Plugin_GD_Text_Wrap' %] [% WRAPPER toc; PROCESS tocitem title ="SYNOPSIS" subs = []; PROCESS tocitem title ="EXAMPLES" subs = []; PROCESS tocitem title ="DESCRIPTION" subs = []; PROCESS tocitem title ="AUTHOR" subs = []; PROCESS tocitem title ="VERSION" subs = []; PROCESS tocitem title ="COPYRIGHT" subs = []; PROCESS tocitem title ="SEE ALSO" subs = []; END %] [% WRAPPER section title="SYNOPSIS" -%]
[% tt_start_tag %] USE align = GD.Text.Wrap(gd_image); [% tt_end_tag %][%- END %] [% WRAPPER section title="EXAMPLES" -%]
[% tt_start_tag %] FILTER null; USE gd = GD.Image(200,400); USE gdc = GD.Constants; black = gd.colorAllocate(0, 0, 0); green = gd.colorAllocate(0, 255, 0); txt = "This is some long text. " | repeat(10); USE wrapbox = GD.Text.Wrap(gd, line_space => 4, color => green, text => txt, ); wrapbox.set_font(gdc.gdMediumBoldFont); wrapbox.set(align => 'center', width => 160); wrapbox.draw(20, 20); gd.png | stdout(1); END; -[% tt_end_tag %]
[% tt_start_tag %] txt = BLOCK -[% tt_end_tag %] Lorem ipsum dolor sit amet, consectetuer adipiscing elit, sed diam nonummy nibh euismod tincidunt ut laoreet dolore magna aliquam erat volutpat. [% tt_start_tag %] END -[% tt_end_tag %] [% tt_start_tag %] FILTER null; # # This example follows the example in GD::Text::Wrap, except # we create a second image that is a copy just enough of the # first image to hold the final text, plus a border. # USE gd = GD.Image(400,400); USE gdc = GD.Constants; green = gd.colorAllocate(0, 255, 0); blue = gd.colorAllocate(0, 0, 255); USE wrapbox = GD.Text.Wrap(gd, line_space => 4, color => green, text => txt, ); wrapbox.set_font(gdc.gdMediumBoldFont); wrapbox.set(align => 'center', width => 140); rect = wrapbox.get_bounds(5, 5); x0 = rect.0; y0 = rect.1; x1 = rect.2 + 9; y1 = rect.3 + 9; gd.filledRectangle(0, 0, x1, y1, blue); gd.rectangle(0, 0, x1, y1, green); wrapbox.draw(x0, y0); nx = x1 + 1; ny = y1 + 1; USE gd2 = GD.Image(nx, ny); gd2.copy(gd, 0, 0, 0, 0, x1, y1); gd2.png | stdout(1); END; -[% tt_end_tag %][%- END %] [% WRAPPER section title="DESCRIPTION" -%]
The GD.Text.Wrap plugin provides an interface to the GD::Text::Wrap module. It allows multiples line of text to be drawn in GD images with various wrapping and alignment.
See [% ttlink('GD::Text::Wrap') -%] for more details. See [% ttlink('Template::Plugin::GD::Text::Align') -%] for a plugin that allow you to draw text with various alignment and orientation.
[%- END %] [% WRAPPER section title="AUTHOR" -%]Craig Barratt <craig@arraycomm.com>
The GD::Text module was written by Martien Verbruggen.
[%- END %] [% WRAPPER section title="VERSION" -%]1.43, distributed as part of the Template Toolkit version 2.08, released on 30 July 2002.
[%- END %] [% WRAPPER section title="COPYRIGHT" -%]Copyright (C) 2001 Craig Barratt <craig@arraycomm.com>
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.
[%- END %] [% WRAPPER section title="SEE ALSO" -%][% ttlink('Template::Plugin', 'Template::Plugin') -%], [% ttlink('Template::Plugin::GD', 'Template::Plugin::GD') -%], [% ttlink('Template::Plugin::GD::Text::Align', 'Template::Plugin::GD::Text::Align') -%], [% ttlink('GD', 'GD') -%], [% ttlink('GD::Text::Wrap', 'GD::Text::Wrap') -%]
[%- END %]