Inside Macintosh: 3D Graphics Programming With QuickDraw 3D /

Chapter 13 - View Objects / View Objects Reference

View Objects Routines / Rendering in a View

Q3View_StartRendering

You can use the Q3View_StartRendering function to start rendering an image of a model.

TQ3Status Q3View_StartRendering (TQ3ViewObject view);

view

A view.

DESCRIPTION

The Q3View_StartRendering function begins the process of rendering an image of a model in the view specified by the view parameter. After calling Q3View_StartRendering, you specify the model to be drawn (for instance, by calling Q3Geometry_Submit). When you have completely specified that model, you should call Q3View_EndRendering to complete the rendering of the image. Because the renderer attached to the specified view might need to reprocess the model data, you should always call Q3View_StartRendering and Q3View_EndRendering in a rendering loop.

Calling Q3View_StartRendering automatically clears the buffer into which the rendered image is drawn.

SPECIAL CONSIDERATIONS

You should not call Q3View_StartRendering while rendering is already occurring.

ERRORS

kQ3ErrorRenderingIsActive

SEE ALSO

See "Rendering an Image" on page 13-4 for more information about a rendering loop.