11 Creating and Managing Renderers

11 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 QuickDraw3D'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.

DESCRIPTION
SPECIAL CONSIDERATIONS
SEE ALSO

3D Graphics Programming with QuickDraw 3D - 17 OCT 1995

© Apple Computer, Inc.

Let us know what you think of these prototype pages.

Generated with Harlequin WebMaker