State(e)       User Contributed Perl Documentation       State(e)



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 anomymous array of argu-
       ments 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@astro.ox.ac.uk) after some prod-
       ding by Karl Glazebrook.

       All rights reserved. There is no warranty. You are allowed
       to redistribute this software / documentation under cer-
       tain 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.6.1                 2001-09-27                   State(e)