3 Managing Objects

3 Q3Object_Dispose

You can use the Q3Object_Dispose function to dispose of a QuickDraw3D object.

TQ3Status Q3Object_Dispose (TQ3Object object);
object A QuickDraw3D object.

DESCRIPTION


The Q3Object_Dispose function disposes of the QuickDraw3D object specified by the object parameter. If the specified object is not a shared object, QuickDraw3D disposes of any memory occupied by that object. If the specified object is a shared object, QuickDraw3D reduces by 1 the reference count associated with that object. When the reference count is reduced to 0, Q3Object_Dispose disposes of the memory occupied by the object.

In general, you need to call Q3Object_Dispose for any objects returned by a Get call (for example, Q3View_GetDrawContext). Failure to call Q3Object_Dispose on such objects will result in a memory leak.

ERRORS


kQ3ErrorInvalidObject

DESCRIPTION
ERRORS

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

© Apple Computer, Inc.

Let us know what you think of these prototype pages.

Generated with Harlequin WebMaker