A3DGlobalInsertGraphPicture
-
A3DStatus
A3DGlobalInsertGraphPicture(const A3DGraphPictureData *pData, A3DUns32 *puiPictureIndex) Insert a new picture into the global state, returning its index.
2.0When given an
A3DGraphPictureData, the function clones the picture data for internal storage and returns a new index to further retrieval withA3DGlobalGetGraphPictureData. In case of failure*puiPictureIndexis 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
pDatais incorrectly initializedA3D_INVALID_DATA_STRUCT_NULL: if
pDatais 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.