A3DGlobalInsertGraphDottingPattern

A3DStatus A3DGlobalInsertGraphDottingPattern(const A3DGraphDottingPatternData *pData, A3DUns32 *puiIndexDottingPattern)
A3DStatus A3DGlobalInsertGraphDottingPattern(const A3DGraphDottingPatternData* pData, A3DUns32* puiIndexDottingPattern)

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

2.0

When given an A3DGraphDottingPatternData, the function clones the picture data for internal storage and returns a new index to further retrieval with A3DGlobalGetGraphPictureData. In case of failure *puiIndexDottingPattern is 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 pData is incorrectly initialized

A3D_INVALID_DATA_STRUCT_NULL: if pData is null.

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

A3DGraphDottingPatternData

A3DGlobalGetGraphDottingPatternData()

A3DGraphHatchingPatternData

A3DGraphSolidPatternData

A3DGraphVPicturePatternData

Parameters

pData: The pattern data to insert.

puiIndexDottingPattern: The resulting index for the inserted pattern data.

Returns

A3D_SUCCESS or an error code.