imager::matrix2d(3pm) [debian man page]

Imager::Matrix2d(3pm)					User Contributed Perl Documentation				     Imager::Matrix2d(3pm)

NAME

	 Imager::Matrix2d - simple wrapper for matrix construction

SYNOPSIS

	 use Imager::Matrix2d;
	 $m1 = Imager::Matrix2d->identity;
	 $m2 = Imager::Matrix2d->rotate(radians=>$angle, x=>$cx, y=>$cy);
	 $m3 = Imager::Matrix2d->translate(x=>$dx, y=>$dy);
	 $m4 = Imager::Matrix2d->shear(x=>$sx, y=>$sy);
	 $m5 = Imager::Matrix2d->reflect(axis=>$axis);
	 $m6 = Imager::Matrix2d->scale(x=>$xratio, y=>$yratio);
	 $m8 = Imager::Matric2d->matrix($v11, $v12, $v13,
					$v21, $v22, $v23,
					$v31, $v32, $v33);
	 $m6 = $m1 * $m2;
	 $m7 = $m1 + $m2;
	 use Imager::Matrix2d qw(:handy);
	 # various m2d_* functions imported
	 # where m2d_(.*) calls Imager::Matrix2d->$1()

DESCRIPTION

       This class provides a simple wrapper around a reference to an array of 9 co-efficients, treated as a matrix:

	[ 0, 1, 2,
	  3, 4, 5,
	  6, 7, 8 ]

       Most of the methods in this class are constructors.  The others are overloaded operators.

       Note that since Imager represents images with y increasing from top to bottom, rotation angles are clockwise, rather than counter-
       clockwise.

       identity()
	   Returns the identity matrix.

       rotate(radians=>$angle)
       rotate(degrees=>$angle)
	   Creates a matrix that rotates around the origin, or around the point (x,y) if the 'x' and 'y' parameters are provided.

       translate(x=>$dx, y=>$dy)
       translate(x=>$dx)
       translate(y=>$dy)
	   Translates by the specify amounts.

       shear(x=>$sx, y=>$sy)
       shear(x=>$sx)
       shear(y=>$sy)
	   Shear by the given amounts.

       reflect(axis=>$axis)
	   Reflect around the given axis, either 'x' or 'y'.

       reflect(radians=>$angle)
       reflect(degrees=>$angle)
	   Reflect around a line drawn at the given angle from the origin.

       scale(x=>$xratio, y=>$yratio)
	   Scales at the given ratios.

	   You can also specify a center for the scaling with the "cx" and "cy" parameters.

       matrix($v11, $v12, $v13, $v21, $v22, $v23, $v31, $v32, $v33)
	   Create a matrix with custom co-efficients.

       _mult()
	   Implements the overloaded '*' operator.  Internal use.

	   Currently both the left and right-hand sides of the operator must be an Imager::Matrix2d.

       _add()
	   Implements the overloaded binary '+' operator.

	   Currently both the left and right sides of the operator must be Imager::Matrix2d objects.

       _string()
	   Implements the overloaded stringification operator.

	   This returns a string containing 3 lines of text with no terminating newline.

	   I tried to make it fairly nicely formatted.	You might disagree :)

       _eq Implement the overloaded equality operator.

	   Provided for older perls that don't handle magic auto generation of eq from "".

       The following functions are shortcuts to the various constructors.

       These are not methods.

       You can import these methods with:

	 use Imager::Matrix2d ':handy';

       m2d_identity
       m2d_rotate()
       m2d_translate()
       m2d_shear()
       m2d_reflect()
       m2d_scale()

AUTHOR

       Tony Cook <tony@develop-help.com>

BUGS

       Needs a way to invert a matrix.

SEE ALSO

       Imager(3), Imager::Font(3)

       http://imager.perl.org/

perl v5.14.2							    2011-11-25						     Imager::Matrix2d(3pm)

Check Out this Related Man Page

Imager::Color::Float(3pm)				User Contributed Perl Documentation				 Imager::Color::Float(3pm)

NAME

       Imager::Color::Float - Rough floating point sample color handling

SYNOPSIS

	 $color = Imager::Color->new($red, $green, $blue);
	 $color = Imager::Color->new($red, $green, $blue, $alpha);
	 $color = Imager::Color->new("#C0C0FF"); # html color specification

	 $color->set($red, $green, $blue);
	 $color->set($red, $green, $blue, $alpha);
	 $color->set("#C0C0FF"); # html color specification

	 ($red, $green, $blue, $alpha) = $color->rgba();
	 @hsv = $color->hsv(); # not implemented but proposed

	 $color->info();

DESCRIPTION

       This module handles creating color objects used by Imager.  The idea is that in the future this module will be able to handle color space
       calculations as well.

       A floating point Imager color consists of up to four components, each in the range 0.0 to 1.0. Unfortunately the meaning of the components
       can change depending on the type of image you're dealing with:

       o   for 3 or 4 channel images the color components are red, green, blue, alpha.

       o   for 1 or 2 channel images the color components are gray, alpha, with the other two components ignored.

       An alpha value of zero is fully transparent, an alpha value of 1.0 is fully opaque.

METHODS

       new This creates a color object to pass to functions that need a color argument.

       set This changes an already defined color.  Note that this does not affect any places where the color has been used previously.

       rgba()
	   This returns the red, green, blue and alpha channels of the color the object contains.

       info
	   Calling info merely dumps the relevant color to the log.

AUTHOR

       Arnar M. Hrafnkelsson, addi@umich.edu And a great deal of help from others - see the "README" for a complete list.

SEE ALSO

       Imager(3), Imager::Color.

       http://imager.perl.org/

perl v5.14.2							    2011-06-06						 Imager::Color::Float(3pm)

Linux and UNIX Man Pages

imager::matrix2d(3pm) [debian man page]

Check Out this Related Man Page