Method XbpPresSpace():configure() Foundation
Reconfigures an existing presentation space.
:configure( [<oDevice>], [<aPageSize>], [<nUnits>] ) --> self
This method returns the object executing the method (self).
The :configure() method reconfigures an existing presentation space. It can be used to link a different device context, modify the page size and/or change the coordinate system units. When a presentation space is no longer needed but additional output is to occur in another device context, it is better from a memory management standpoint to reconfigure an existing presentation space than to create a new one.
If only <oDevice> is passed all attributes for graphic primitives are reset to their default values, open graphical paths and segments are discarded, a clipping path is disabled, a transformation matrix is reset to initial state, and the pen position is set to the point {0,0}.
In addition, when <aPageSize> or <nUnits> is specified all existing graphical segments are deleted, the viewport is reset and the drawing mode is set to default (see the :drawMode() method).
If you see anything in the documentation that is not correct, does not match your experience with the particular feature or requires further clarification, please use this form to report a documentation issue.