gitpan / math-gmatrix Goto Github PK

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, <[email protected]>