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

Chapter 11 - Renderer Objects / Renderer Objects Reference

Renderer Objects Routines / Creating and Managing Renderers

Q3Renderer_NewFromType

You can use the Q3Renderer_NewFromType function to create an instance of a certain type of renderer.

TQ3RendererObject Q3Renderer_NewFromType (
TQ3ObjectType rendererObjectType);

rendererObjectType

A value that specifies a renderer type.

DESCRIPTION

The Q3Renderer_NewFromType function returns, as its function result, a new renderer of the type specified by the rendererObjectType parameter. You can use these values to specify QuickDraw 3D's wireframe and interactive renderers:

kQ3RendererTypeWireFrame
kQ3RendererTypeInteractive

You can also pass the value kQ3RendererTypeGeneric to create a generic renderer. A generic renderer does not render any image, but you can use it to collect state information.

If Q3Renderer_NewFromType is not able to create an instance of the specified renderer type, it returns NULL.

SPECIAL CONSIDERATIONS

You should create a renderer object once and associate it with a view (by calling Q3View_SetRenderer); you should not recreate a renderer object for each frame.

SEE ALSO

You can call the Q3View_SetRendererByType function to create a new renderer of a specified type and attach it to a view. See the chapter "View Objects" for complete information.