CwStopRender

Syntax:

call CwStopRender viewHandle

        viewHandle      (handle) The handle to a view.

Description:

This procedure causes rendering to halt on the specified view, referenced by viewHandle. This is useful if you wish to create or adjust a large number of objects without the user seeing an unfinished product. P>G PRO will not render on that view until CwStartRender is called. Note, however, that a call to CwWaitOnRender is not affected by this call.

Example:

/* Draw something complex, switching rendering off for the duration
   of the process. */
vh = CwGetCurrentView()
call CwStopRender vh
call drawLotsOfStuff            /* Some REXX procedure. */
call CwStartRender vh

Remarks:

Initial testing (i.e. I used mandel.cwx and time()) indicates that long-running scripts will run approximately 25% faster if rendering is switched off while it runs.

Please note that if the script is halted for any reason before the render engine for the view is started again, refreshes will never happen. Hence CwStopRender is a function which can easily shoot you in the foot, particularly when used during script development when errors and operator interrupts are relatively common.

Functions by NAME

Index

Functions by PURPOSE