graphics::primitive::font(3pm) [debian man page]

Graphics::Primitive::Font(3pm)				User Contributed Perl Documentation			    Graphics::Primitive::Font(3pm)

NAME

       Graphics::Primitive::Font - Text styling

DESCRIPTION

       Graphics::Primitive::Font represents the various options that are available when rendering text.  The options here may or may not have an
       effect on your rendering.  They represent a cross-section of the features provided by various drivers.  Setting them should not break
       anything, but may not have an effect if the driver doesn't understand the option.

SYNOPSIS

	 use Graphics::Primitive::Font;

	 my $font = Graphics::Primitive::Font->new({
	   family => 'Arial',
	   size => 12,
	   slant => 'normal'
	 });

METHODS

   Constructor
Attributes
   antialias_modes
       Set the antialiasing mode for this font. Possible values are default, none, gray and subpixel.

   family
       Set this font's family.

   hint_metrics
       Controls whether to hint font metrics.  Hinting means quantizing them so that they are integer values in device space.  This improves the
       consistency of letter and line spacing, however it also means that text will be laid out differently at different zoom factors.	May not be
       supported by all drivers.

   hint_style
       Set the the type of hinting to do on font outlines.  Hinting is the process of fitting outlines to the pixel grid in order to improve the
       appearance of the result. Since hinting outlines involves distorting them, it also reduces the faithfulness to the original outline shapes.
       Not all of the outline hinting styles are supported by all drivers.  Options are default, none, slight, medium and full.

   size
       Set/Get the size of this font.

   slant
       Set/Get the slant of this font.	Valid values are normal, italic and oblique.

   subpixel_order
       Set the order of color elements within each pixel on the display device when rendering with subpixel antialiasing.  Value values are
       default, rgb, bgr, vrgb and vbgr.

   variant
       Set/Get the variant of this font.  Valid values are normal or small-caps.

   weight
       Set/Get the weight of this font.  Value valies are normal and bold.

METHODS

   new
       Creates a new Graphics::Primitive::Font.

   derive
       Clone this font but change one or more of it's attributes by passing in a hashref of options:

	 my $new = $font->derive({ attr => $newvalue });

       The returned font will be identical to the cloned one, save the attributes specified.

AUTHOR

       Cory Watson, "<gphat@cpan.org>"

COPYRIGHT &; LICENSE
       Copyright 2008-2010 by Cory G Watson.

       This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

perl v5.12.3							    2010-08-21					    Graphics::Primitive::Font(3pm)

Graphics::Primitive::Driver::Cairo(3pm) 		User Contributed Perl Documentation		   Graphics::Primitive::Driver::Cairo(3pm)

NAME

       Graphics::Primitive::Driver::Cairo - Cairo backend for Graphics::Primitive

VERSION

       version 0.44

SYNOPSIS

	   use Graphics::Primitive::Component;
	   use Graphics::Primitive::Driver::Cairo;

	   my $driver = Graphics::Primitive::Driver::Cairo->new;
	   my $container = Graphics::Primitive::Container->new(
	       width => 800,
	       height => 600
	   );
	   my $black = Graphics::Primitive::Color->new(red => 0, green => 0, blue => 0);
	   $container->border->width(1);
	   $container->border->color($black);
	   $container->padding(
	       Graphics::Primitive::Insets->new(top => 5, bottom => 5, left => 5, right => 5)
	   );
	   my $comp = Graphics::Primitive::Component->new;
	   $comp->background_color($black);
	   $container->add_component($comp, 'c');

	   my $lm = Layout::Manager::Compass->new;
	   $lm->do_layout($container);

	   my $driver = Graphics::Primitive::Driver::Cairo->new(
	       format => 'PDF'
	   );
	   $driver->draw($container);
	   $driver->write('/Users/gphat/foo.pdf');

DESCRIPTION

       This module draws Graphics::Primitive objects using Cairo.

IMPLEMENTATION DETAILS

       Borders
	   Borders are drawn clockwise starting with the top one.  Since cairo can't do line-joins on different colored lines, each border
	   overlaps those before it.  This is not the way I'd like it to work, but i'm opting to fix this later.  Consider yourself warned.

ATTRIBUTES

   antialias_mode
       Set/Get the antialias mode of this driver. Options are default, none, gray and subpixel.

   cairo
       This driver's Cairo::Context object

   format
       Get the format for this driver.

   surface
       Get/Set the surface on which this driver is operating.

METHODS

   data
       Get the data in a scalar for this driver.

   write ($file)
       Write this driver's data to the specified file.

   get_text_bounding_box ($font, $text, $angle)
       Returns two Rectangles that encloses the supplied text. The origin's x and y maybe negative, meaning that the glyphs in the text extending
       left of x or above y.

       The first rectangle is the bounding box required for a container that wants to contain the text.  The second box is only useful if an
       optional angle is provided.  This second rectangle is the bounding box of the un-rotated text that allows for a controlled rotation.  If no
       angle is supplied then the two rectangles are actually the same object.

       If the optional angle is supplied the text will be rotated by the supplied amount in radians.

   get_textbox_layout ($tb)
       Returns a Graphics::Primitive::Driver::TextLayout for the supplied textbox.

   reset
       Reset the driver.

   draw
       Draws the specified component.  Container's components are drawn recursively.

ACKNOWLEDGEMENTS

       Danny Luna

AUTHOR

       Cory G Watson <gphat@cpan.org>

COPYRIGHT AND LICENSE

       This software is copyright (c) 2011 by Cold Hard Code, LLC.

       This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.

perl v5.12.4							    2011-09-27				   Graphics::Primitive::Driver::Cairo(3pm)