Q3View_EndRendering
You can use theQ3View_EndRendering
function to stop rendering an image of a model.
TQ3ViewStatus Q3View_EndRendering (TQ3ViewObject view);
view
- A view.
DESCRIPTION
TheQ3View_EndRendering
function returns, as its function result, a view status value that indicates the current state of the rendering of an image of a model in the view specified by theview
parameter.Q3View_EndRendering
returns one of these four values:
typedef enum TQ3ViewStatus { kQ3ViewStatusDone, kQ3ViewStatusRetraverse, kQ3ViewStatusError, kQ3ViewStatusCancelled } TQ3ViewStatus;IfQ3View_EndRendering
returnskQ3ViewStatusDone
, the rendering of the image has been completed and the specified view is no longer in rendering mode. At that point, it is safe to exit your rendering loop. If double-buffering is active, the front buffer is updated with the rendered image.
If
- IMPORTANT
- If the renderer associated with the specified view relies on a hardware accelerator for some or all of its operation,
Q3View_EndRendering
may returnkQ3ViewStatusDone
even though the rendering has not yet completed. (When a hardware accelerator is present, rendering occurs asynchronously.) If you must know when the rendering has actually finished, call theQ3Renderer_Sync
function (described in the chapter "Renderer Objects").![]()
Q3View_EndRendering
returnskQ3ViewStatusRetraverse
, the rendering of the image has not yet been completed. You should respecify the model by reentering your rendering loop.If
Q3View_EndRendering
returnskQ3ViewStatusError
, the rendering of the image has failed because the renderer associated with the view encountered an error in processing the model. You should exit the rendering loop.If
Q3View_EndRendering
returnskQ3ViewStatusCancelled
, the rendering of the image has been canceled. You should exit the rendering loop.SPECIAL CONSIDERATIONS
You should callQ3View_EndRendering
only if rendering is already occurring.SEE ALSO
See "Rendering an Image" on page 13-4 for a sample rendering loop.
Main | Top of Section | What's New | Apple Computer, Inc. | Find It | Feedback | Help