A3DGlobalGetGraphPictureData

A3DStatus A3DGlobalGetGraphPictureData(const A3DUns32 uiIndexPicture, A3DGraphPictureData *pData)
A3DStatus A3DGlobalGetGraphPictureData(const A3DUns32 uiIndexPicture, A3DGraphPictureData* pData)

Retrieves an A3DGraphPictureData instance.

2.0

HOOPS stores picture information in a global state using indexes. When given an index, call A3DGlobalGetGraphPictureData to fill in an A3DGraphPictureData instance.

// Retrieves the picture data at index 3:
A3DGraphPictureData picture_data = A3D_MAKE_DATA(A3DGraphPictureData);
A3DStatus result = A3DGlobalGetGraphPictureData(3, &picture_data);
assert(result == A3D_SUCCESS);

Return Values

A3D_SUCCESS: in case of success.

A3D_INITIALIZE_NOT_CALLED: if the library is not initialized

A3D_INVALID_PICTURE_INDEX: if the picture index does not match any existing.

A3D_INVALID_PICTURE_FORMAT: if the internal image format is not supported.

A3D_INVALID_DATA_STRUCT_NULL: if pData is null.

A3D_INVALID_DATA_STRUCT_SIZE: if pData is incorrectly initialized

A3DGraphPictureData

A3DGlobalInsertGraphPicture()

Parameters

uiIndexPicture: The index of the picture data.

pData: The A3DGraphPictureData to fill in.

Returns

A3D_SUCCESS or an error code in case of failure.