A3DGlobalInsertGraphHatchingPattern

A3DStatus A3DGlobalInsertGraphHatchingPattern(const A3DGraphHatchingPatternData *pData, A3DUns32 *puiIndexHatchingPattern)
A3DStatus A3DGlobalInsertGraphHatchingPattern(const A3DGraphHatchingPatternData* pData, A3DUns32* puiIndexHatchingPattern)

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

2.0

When given an A3DGraphHatchingPatternData, the function clones the content for internal storage and returns a new index for further retrieval with A3DGlobalGetGraphHatchingPatternData. In case of failure *puiIndexHatchingPattern is unchanged.

A3DGraphHatchingPatternData pattern_data = A3D_MAKE_DATA(A3DGraphHatchingPatternData);
// 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.

A3DGraphHatchingPatternData

A3DGraphHatchingPatternLineData

A3DGlobalGetGraphHatchingPatternData()

A3DGraphDottingPatternData

A3DGraphSolidPatternData

A3DGraphVPicturePatternData

Parameters

pData: The pattern data to insert.

puiIndexHatchingPattern: The resulting index for the inserted pattern data.

Returns

A3D_SUCCESS or an error code.