C++ Syntax

MKI_ClipOpen( void );

Opens a provisional clipping surface for data block input. Once opened, the provisional clipping surface can be filled with data blocks and subsequently be terminated and appended to a memory list or to a block.

Up to MKI_NESTING_DEPTH_MAX provisional clipping surfaces are available at a time. Only the most recently opened clipping surface will be modified by the other methods. Anyway, other provisional entities like object, instance, block and group can be open simultaneously. After opening the provisional clipping surface, it must later be closed using MKI_ClipClose or MKI_ClipFastInsert.

Return Value

Address of the provisional clipping surface, if successful. This address can be used to modify the clipping surface's extended properties (located in ReturnValue->XProperty) and the display matrix (located in ReturnValue->DisplayMatrix). Please do not modify any other value! If nullptr is returned, this indicates that the allowed maximum number of provisional clipping surfaces is already open.