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

Chapter 5 - Attribute Objects / Attribute Objects Reference

Attribute Objects Routines / Creating and Managing Attribute Sets

Q3AttributeSet_Get

You can use the Q3AttributeSet_Get function to get the data associated with an attribute in an attribute set.

TQ3Status Q3AttributeSet_Get (
TQ3AttributeSet attributeSet, 
TQ3AttributeType type, 
void *data);

attributeSet

An attribute set.

type

An attribute type.

data

On entry, a pointer to a structure large enough to hold the attribute data associated with attributes of the specified type. On exit, a pointer to the attribute data of the attribute having the specified type.

DESCRIPTION

The Q3AttributeSet_Get function returns, in the data parameter, the data currently associated with the attribute whose type is specified by the type parameter in the attribute set specified by the attributeSet parameter. If no attribute of that type is in the attribute set, Q3AttributeSet_Get returns kQ3Failure and posts the error kQ3ErrorAttributeNotContained.

If you pass the value NULL in the data parameter, no data is copied back to your application.

ERRORS

kQ3ErrorAttributeNotContained