A3DGlobalInsertGraphSolidPattern
-
A3DStatus
A3DGlobalInsertGraphSolidPattern(const A3DGraphSolidPatternData *pData, A3DUns32 *puiIndexSolidPattern) A3DStatusA3DGlobalInsertGraphSolidPattern(constA3DGraphSolidPatternData* pData,A3DUns32* puiIndexSolidPattern)Insert a new solid fill pattern into the global state, returning its index for further retrieval.
2.0When given an
A3DGraphSolidPatternData, the function clones the content for internal storage and returns a new index for further retrieval withA3DGlobalGetGraphSolidPatternData. In case of failure*puiIndexSolidPatternis unchanged.A3DGraphSolidPatternData pattern_data = A3D_MAKE_DATA(A3DGraphSolidPatternData); // Configure pattern_data... A3DUns32 idx = A3D_DEFAULT_PATTERN_INDEX; A3DStatus result = A3DGlobalInsertGraphHatchingPattern(&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.
puiIndexSolidPattern: The resulting index for the inserted pattern data.
Returns
A3D_SUCCESS or an error code.