NAME

Math::GMatrix - Extension of Math::Matrix for (2D graphics-)vector manipulation

SYNOPSIS

use Math::GMatrix;

DESCRIPTION

The following methods are available:

new

Constructor arguments are a list of references to arrays of the same length. The arrays are copied. The method returns undef in case of error.

$a = new Math::Matrix ([rand,rand,rand],
		       [rand,rand,rand],
		       [rand,rand,rand]);

As s special case you can pass a single argument 'I' for getting an identity matrix.

If you call new as method, a zero filled matrix with identical deminsions is returned.

xform

You can transform one or more vectors by calling:

	@V1=(1.5,3.7);

        @V2 = $M->xform(@V1);


	@L1=( [1.5,3.7], [4.6,6.8], [5.1,-0.7] );

        @L2 = $M->xform(@L1);

translate

You can pan (move by x and y offset) your graphics by calling:

$M2 = $M->translate(2.5,10.2);

rotate

You can rotate your graphics by calling:

$M2 = $M->rotate(-90);

scale

You can scale (factor_x and factor_y) your graphics by calling:

$M2 = $M->rotate(2,2);

EXAMPLE

@ListOfVectors = [
	[0,1],
	[3,5],
	[2,7],
	[8,-1],
];
$paperwidth = 21;               # DIN A4 is 21x29.7 cm
$M = new Math::Matrix('I');     # get an identity matrix
$M = $M->translate(-1,-1)->rotate(90)->translate($paperwidth-1,1);
@Result = $M->xform(@ListOfVectors);

AUTHOR

A. Cester, <albert.cester@web.de>