A3DGlobalInsertGraphDottingPattern
-
A3DStatus
A3DGlobalInsertGraphDottingPattern(const A3DGraphDottingPatternData *pData, A3DUns32 *puiIndexDottingPattern) A3DStatusA3DGlobalInsertGraphDottingPattern(constA3DGraphDottingPatternData* pData,A3DUns32* puiIndexDottingPattern)Insert a new dotting pattern into the global state, returning its index.
2.0When given an
A3DGraphDottingPatternData, the function clones the picture data for internal storage and returns a new index to further retrieval withA3DGlobalGetGraphPictureData. In case of failure*puiIndexDottingPatternis unchanged.A3DGraphDottingPatternData pattern_data = A3D_MAKE_DATA(A3DGraphDottingPatternData); // Configure pattern_data... A3DUns32 idx = A3D_DEFAULT_PATTERN_INDEX; A3DStatus result = A3DGlobalInsertGraphDottingPattern(&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.
puiIndexDottingPattern: The resulting index for the inserted pattern data.
Returns
A3D_SUCCESS or an error code.