A3DGlobalInsertGraphVPicturePattern

A3DStatus A3DGlobalInsertGraphVPicturePattern(const A3DGraphVPicturePatternData *pData, A3DUns32 *puiIndexVPicturePattern)
A3DStatus A3DGlobalInsertGraphVPicturePattern(const A3DGraphVPicturePatternData* pData, A3DUns32* puiIndexVPicturePattern)

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

2.0

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

A3DGraphVPicturePatternData pattern_data = A3D_MAKE_DATA(A3DGraphVPicturePatternData);
// Configure pattern_data...
A3DUns32 idx = A3D_DEFAULT_PATTERN_INDEX;

A3DStatus result = A3DGlobalInsertGraphVPicturePattern(&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.

A3DGraphVPicturePatternData

A3DGlobalGetGraphVPicturePatternData()

A3DTessBaseSet()

A3DTessMarkupCreate()

A3DTessBaseData

A3DTessMarkupData

A3DGraphDottingPatternData

A3DGraphSolidPatternData

A3DGraphVPicturePatternData

Parameters

pData: The pattern data to insert.

puiIndexVPicturePattern: The resulting index for the inserted pattern data.

Returns

A3D_SUCCESS or an error code.