Inside Macintosh: /

QuickDraw 3D RAVE / QuickDraw 3D RAVE Reference

QuickDraw 3D RAVE Routines / Manipulating Draw Contexts

QARenderAbort

You can use the QARenderAbort function to cancel any asynchronous drawing requests for a draw context.

#define QARenderAbort(drawContext) \
                  (drawContext)->renderAbort (drawContext)

drawContext

A draw context.

DESCRIPTION

The QARenderAbort function immediately stops the draw context specified by the drawContext parameter from processing any asynchronous drawing commands it is currently processing and causes it to discard any queued commands.

The QARenderAbort function returns a result code (of type TQAError) indicating whether any errors have occurred since the previous call to QARenderStart. If all rendering commands completed successfully, the value kQANoErr is returned. If any other value is returned, you should assume that the rendered image is incorrect.

SPECIAL CONSIDERATIONS

You should call either QARenderEnd or QARenderAbort, but not both.