Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
Template::Plugin::GD::User:Contributed PerlTemplate::Plugin::GD::Text::Wrap(3)

NAME
       Template::Plugin::GD::Text::Wrap	- Break	and wrap strings in GD images

SYNOPSIS
	   [% USE align	= GD.Text.Wrap(gd_image); %]

EXAMPLES
	   [% 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;
	   -%]

	   [% txt = BLOCK -%]
	   Lorem ipsum dolor sit amet, consectetuer adipiscing elit,
	   sed diam nonummy nibh euismod tincidunt ut laoreet dolore
	   magna aliquam erat volutpat.
	   [% END -%]
	   [% 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;
	   -%]

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 GD::Text::Wrap for more details. See
       Template::Plugin::GD::Text::Align for a plugin that allow you to	draw
       text with various alignment and orientation.

AUTHOR
       Thomas Boutell wrote the	GD graphics library.

       Lincoln D. Stein	wrote the Perl GD modules that interface to it and
       Martien Verbruggen wrote	the GD::Text module.

       Craig Barratt <craig@arraycomm.com> wrote the original GD plugins for
       the Template Toolkit (2001).

       Andy Wardley <abw@cpan.org> extracted them from the TT core into	a
       separate	distribution for TT version 2.15.

       These modules are looking for a new maintainer.	Please contact Andy
       Wardley if you are willing to help out.

COPYRIGHT
       Copyright (C) 2001 Craig	Barratt	<craig@arraycomm.com>, 2006 Andy
       Wardley <abw@cpan.org>.

       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.

SEE ALSO
       Template::Plugin::GD, Template::Plugin::GD::Text, GD

perl v5.32.1			  2006-02-0Template::Plugin::GD::Text::Wrap(3)

NAME | SYNOPSIS | EXAMPLES | DESCRIPTION | AUTHOR | COPYRIGHT | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=Template::Plugin::GD::Text::Wrap&sektion=3&manpath=FreeBSD+13.0-RELEASE+and+Ports>

home | help