Managing Interactive Renderers
QuickDraw 3D provides routines that you can use to manage interactive renderers.
Q3Renderer_IsInteractive
You can use the Q3Renderer_IsInteractive function to determine whether a renderer is interactive.
TQ3Boolean Q3Renderer_IsInteractive (TQ3RendererObject renderer);
-
renderer
-
A renderer.
DESCRIPTION
The Q3Renderer_IsInteractive function returns
kQ3True
if renderer is an interactive renderer and
kQ3False
otherwise.
Q3InteractiveRenderer_GetPreferences
You can use the
Q3InteractiveRenderer_GetPreferences
function to get the current preference settings of an interactive renderer.
TQ3Status Q3InteractiveRenderer_GetPreferences (
TQ3RendererObject renderer,
long *vendorID,
long *engineID);
-
renderer
-
An interactive renderer.
-
vendorID
-
On exit, the vendor ID currently associated with the interactive renderer. See
"Vendor IDs"
for the values that can be returned in this parameter.
-
engineID
-
On exit, the engine ID currently associated with the interactive renderer. See
"Engine IDs"
for the values that can be returned in this parameter.
DESCRIPTION
The
Q3InteractiveRenderer_GetPreferences
function returns, in the
vendorID
and
engineID
parameters, the vendor and engine IDs currently associated with the interactive renderer specified by the
renderer
parameter.
Q3InteractiveRenderer_SetPreferences
You can use the
Q3InteractiveRenderer_SetPreferences
function to set the preference settings of the interactive renderer.
TQ3Status Q3InteractiveRenderer_SetPreferences (
TQ3RendererObject renderer,
long vendorID,
long engineID);
-
renderer
-
An interactive renderer.
-
vendorID
-
A vendor ID. See
"Vendor IDs"
for the values you can pass in this parameter.
-
engineID
-
An engine ID. See
"Engine IDs"
for the values you can pass in this parameter.
DESCRIPTION
The
Q3InteractiveRenderer_SetPreferences
function sets the default vendor and engine to be used by the interactive renderer specified by the
renderer
parameter to the values passed in the
vendorID
and
engineID
parameters.
Q3InteractiveRenderer_GetCSGEquation
You can use the
Q3InteractiveRenderer_GetCSGEquation
function to get the CSG equation used by the interactive renderer.
TQ3Status Q3InteractiveRenderer_GetCSGEquation (
TQ3RendererObject renderer,
TQ3CSGEquation *equation);
-
renderer
-
An interactive renderer.
-
equation
-
On exit, the CSG equation currently associated with the interactive renderer. See
"CSG Equations"
for the values that can be returned in this parameter.
DESCRIPTION
The
Q3InteractiveRenderer_GetCSGEquation
function returns, in the
equation
parameter, the CSG equation currently associated with the interactive renderer specified by the
renderer
parameter.
Q3InteractiveRenderer_SetCSGEquation
You can use the
Q3InteractiveRenderer_SetCSGEquation
function to set the CSG equation used by the interactive renderer.
TQ3Status Q3InteractiveRenderer_SetCSGEquation (
TQ3RendererObject renderer,
TQ3CSGEquation equation);
-
renderer
-
An interactive renderer.
-
equation
-
A CSG equation. See
"CSG Equations"
for the values you can pass in this parameter.
DESCRIPTION
The
Q3InteractiveRenderer_SetCSGEquation
function sets the CSG equation to be used by the interactive renderer specified by the
renderer
parameter to the equation specified by the
equation
parameter.
Q3InteractiveRenderer_GetDoubleBufferBypass
You can use the
Q3InteractiveRenderer_GetDoubleBufferBypass
function to get the current double buffer bypass state of the interactive renderer.
TQ3Status Q3InteractiveRenderer_GetDoubleBufferBypass (
TQ3RendererObject renderer,
TQ3Boolean *bypass);
-
renderer
-
An interactive renderer.
-
bypass
-
On exit, a Boolean value that indicates the current double buffer bypass state of the specified interactive renderer.
DESCRIPTION
The
Q3InteractiveRenderer_GetDoubleBufferBypass
function returns, in the
bypass
parameter, a Boolean value that indicates the current double buffer bypass state of the interactive renderer specified by the
renderer
parameter. If
bypass
is
kQ3True
, double buffering is currently being bypassed.
Q3InteractiveRenderer_SetDoubleBufferBypass
You can use the
Q3InteractiveRenderer_SetDoubleBufferBypass
function to set the double buffer bypass state of the interactive renderer.
TQ3Status Q3InteractiveRenderer_SetDoubleBufferBypass (
TQ3RendererObject renderer,
TQ3Boolean bypass);
-
renderer
-
An interactive renderer.
-
bypass
-
A Boolean value that indicates the desired double buffer bypass state of the specified interactive renderer.
DESCRIPTION
The
Q3InteractiveRenderer_SetDoubleBufferBypass
function sets the state of double buffer bypassing for the interactive renderer specified by the
renderer
parameter to the Boolean value specified by the
bypass
parameter.
© 1997 Apple Computer, Inc.