A3DGlobalInsertGraphSolidPattern

A3DStatus A3DGlobalInsertGraphSolidPattern(const A3DGraphSolidPatternData *pData, A3DUns32 *puiIndexSolidPattern)
A3DStatus A3DGlobalInsertGraphSolidPattern(const A3DGraphSolidPatternData* pData, A3DUns32* puiIndexSolidPattern)

Insert a new solid fill pattern into the global state, returning its index for further retrieval.

2.0

When given an A3DGraphSolidPatternData, the function clones the content for internal storage and returns a new index for further retrieval with A3DGlobalGetGraphSolidPatternData. In case of failure *puiIndexSolidPattern is 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 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.

A3DGraphSolidPatternData

A3DGlobalGetGraphSolidPatternData()

A3DGraphDottingPatternData

A3DGraphSolidPatternData

A3DGraphVPicturePatternData

Parameters

pData: The pattern data to insert.

puiIndexSolidPattern: The resulting index for the inserted pattern data.

Returns

A3D_SUCCESS or an error code.