Reference manual

The reference manual documents the procedures and global variables that the user can and should access.

This applies to the prototype, and is incomplete.

Routines meant for internal use only should be documented in the design document.

Plot list management

The plot list is a Gnudl construct. It is a list of all the individual plot rectangles available in a given postscript interpreter.

Data type: plot-entry rect hook skip-flag ps-code

Each entry in the plot list contains:

a rectangle specifying where it gets drawn
a hook procedure hook that should be invoked before this entry is redrawn (currently unused)
a boolean flag skip-flag which specifies if it should be drawn during a refresh. (this is usuall #f for the root entry, but #t for normal plots)
a vector of postscript code strings, which contains the instructions to draw that plot.

Data type: plot-list [entry ...]: The plot list is the list of all plot entries.

Plot list management: showpage: Forces the postscript interpreter to process a showpage command.

Plot list management: flushpage: Sends a flushpage command to the postscript interpreter. This is usually ignored by printers, and instead recognized by interpreters like ghostscript: it means "draw everything you have so far".

Plot list management: clear [args ...]: Clears out the plot list for all the plot numbers specified in the args.