diagram
Sets the current diagram.
Syntax
-
diagram() -
diagram(S)-
Sis a non-empty string
-
Description
diagram(S) sets the current diagram to the one named S; if there is no diagram named S, a new diagram with this name is created.
All subsequent 2D chart drawing and plotting operations will take place in this diagram.
A reference to the diagram is returned.
diagram() instructs the front-end to put each new 2D chart or plot in its own, newly created, and temporary diagram. It is not possible to add other objects to this diagram later on.
A named diagram can be displayed either docked in the main IDE window or floating in its own window. By right-clicking the diagram, you can detach a docked diagram or dock a detached diagram:
Closing the diagram viewer will not destroy the diagram, but only hide the window; it can later be reopened using the Window manager or, in the case of a named diagram, the diagram function.
To discard a diagram (and regain computer memory), close the window while the Shift key is depressed. (For instance, hold down the Shift key and click the cross titlebar button.)
See also
-
scene (3D counterpart)