A3DGlobalInsertGraphVPicturePattern
-
A3DStatus
A3DGlobalInsertGraphVPicturePattern(const A3DGraphVPicturePatternData *pData, A3DUns32 *puiIndexVPicturePattern) A3DStatusA3DGlobalInsertGraphVPicturePattern(constA3DGraphVPicturePatternData* pData,A3DUns32* puiIndexVPicturePattern)Insert a new vectorized picture fill pattern into the global state, returning its index for further retrieval.
2.0When given an
A3DGraphVPicturePatternData, the function clones the content for internal storage and returns a new index for further retrieval withA3DGlobalGetGraphHatchingPatternData. In case of failure*puiIndexVPicturePatternis unchanged.A3DGraphVPicturePatternData pattern_data = A3D_MAKE_DATA(A3DGraphVPicturePatternData); // Configure pattern_data... A3DUns32 idx = A3D_DEFAULT_PATTERN_INDEX; A3DStatus result = A3DGlobalInsertGraphVPicturePattern(&pattern_data, &idx); assert(result == A3D_SUCCESS); assert(idx != A3D_DEFAULT_PATTERN_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 pattern data.
Parameters
pData: The pattern data to insert.
puiIndexVPicturePattern: The resulting index for the inserted pattern data.
Returns
A3D_SUCCESS or an error code.