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
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@astro.ox.ac.uk) after some prodding by Karl Glazebrook.
All rights reserved. There is no warranty. You are allowed to redistribute 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.