#
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