man PDL::State () - A package to keep track of plotting commands

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 CWnew operator 

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

Then for each new command you call CWadd on this object so that for a call to CWline of the form 

  line $x, $y, $opt;

the call to CWadd 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 CWget 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 CWremove with the number in the stack. No further interaction is implmented except CWclear which clears the stack and CWcopy 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.