Getting Started

Documentation

Glish

Learn More

Programming

Contact Us

Version 1.9 Build 1556

News	FAQ
Search	Home

pgplotmanager.record - Function

	Package	display
	Module	plotter
	Tool	pgplotmanager

set whether drawing commands are saved

Synopsis
record(newstate)

Description
This function gives you control of whether or not the plotting commands are saved in the internal display list or not. You might want to do this for efficiency concerns (e.g. the commands are coming frequently and contain a lot of pixels), or so that you can ``undraw'' some temporary plotting with a refresh.

The return value is the previous state of the function to make it easy to get back to the previous state. Alternatively, the recording() function can be used to determine the current state.

Arguments

newstate		if true, recording is turned on; otherwise, it is turned off
		Allowed:	boolean

Returns
boolean - the former recording state

Example

# Turn on saving of plot commands
pg.record(T); 

# Do "permanent" part of plot
pg.env(0, 2 * pi, -1, 1, 0, 0);

# Turn off saving of plot commands
pg.record(F); 

# Add "temporary" parts of plot
pg.arro(1, -1, 5, -0.5);

# Make the temporary stuff go away by replaying "permanent" commands
pg.refresh();