Identifier: pre_dump { }

Type

callback

Description

During creation of a plot metafile in the dump command, graphic primitives are processed individually to produce the plot. The pre_dump procedure, if defined, will be executed before each primitive has been processed. This procedure does not take any parameters, but the system epointer this is set to point to the primitive in question.

This procedure, like all procedures, is a numeric function. By returning a non-zero value in funcval, the processing of the graphic primitive will be suppressed, thus omitting its graphics from the plot metafile.

pre_dump is a companion to the post_dump procedure.

When customizing plot metafiles, this procedure is often used to enter user data into the plot metafile under creation, or to filter out unwanted graphics from the plot.

Examples

The following might be used to monitor which entities get dumped to file.

pre_dump = { tell <'About to dump',this.name> }

See Also