PDL::State--3pm

State(3pm)            User Contributed Perl Documentation           State(3pm)



NAME
       State - A package to keep track of plotting commands

SYNOPSIS
         use PDL::Graphics::State;

DESCRIPTION
       This is a very simple, at present almost trivial, package to keep track
       of the current set of plotting commands.

USAGE
       You create a new object by calling the "new" operator

         $state = PDL::Graphics::State->new();

       Then for each new command you call "add" on this object so that for a
       call to "line" of the form

         line $x, $y, $opt;

       the call to "add" would be like

         $state->add(\&line, 'line', [$x, $y], $opt);

       which is stored internally as:

         [\&line, 'line', [$x, $y], $opt]

       The state can later be extracted using "get" which returns the state
       object which is an array of anonymous arrays like the one above where
       the first object is a reference to the function, the second an anomy-
       mous array of arguments to the function and finally an anonymous hash
       with options to the command.

       If you know the order in which you inserted commands they can be
       removed by calling "remove" with the number in the stack. No further
       interaction is implmented except "clear" which clears the stack and
       "copy" which returns a "deep" copy of the state.

AUTHOR
       Jarle Brinchmann (jarle AT astro.uk) after some prodding by Karl
       Glazebrook.

       All rights reserved. There is no warranty. You are allowed to redis-
       tribute this software / documentation under certain conditions. For
       details, see the file COPYING in the PDL distribution. If this file is
       separated from the PDL distribution, the copyright notice should be
       included in the file.



perl v5.8.8                       2000-10-26                        State(3pm)