A3DGlobalInsertGraphPicture

A3DStatus A3DGlobalInsertGraphPicture(const A3DGraphPictureData *pData, A3DUns32 *puiPictureIndex)
A3DStatus A3DGlobalInsertGraphPicture(const A3DGraphPictureData* pData, A3DUns32* puiPictureIndex)

Insert a new picture into the global state, returning its index.

2.0

When given an A3DGraphPictureData, the function clones the picture data for internal storage and returns a new index to further retrieval with A3DGlobalGetGraphPictureData. In case of failure *puiPictureIndex is unchanged.

A3DGraphPictureData picture_data = A3D_MAKE_DATA(A3DGraphPictureData);
// Configure picture_data...
A3DUns32 idx = A3D_DEFAULT_MATERIAL_INDEX;

A3DStatus result = A3DGlobalInsertGraphPicture(&picture_data, &idx);
assert(result == A3D_SUCCESS);
assert(idx != A3D_DEFAULT_MATERIAL_INDEX);

Return Values

A3D_SUCCESS: in case of success.

A3D_INITIALIZE_NOT_CALLED: if the library is not initialized.

A3D_INVALID_DATA_STRUCT_SIZE: if pData is incorrectly initialized

A3D_INVALID_DATA_STRUCT_NULL: if pData is null.

A3D_ERROR: when an internal error is encountered while storing the image data.

Parameters

pData: The picture data to insert.

puiPictureIndex: The resulting index for the inserted picture data.

Returns

A3D_SUCCESS or an error code.