A3DGlobalInsertGraphMaterial

A3DStatus A3DGlobalInsertGraphMaterial(const A3DGraphMaterialData *pData, A3DUns32 *puiIndexMaterial)

A3DStatus A3DGlobalInsertGraphMaterial(const A3DGraphMaterialData* pData, A3DUns32* puiIndexMaterial)

Creates a new material, returning its index.

2.0

When given an``A3DGraphMaterialData``, the function searches for an already existing material data of the same value and returns its index. If the material does not exist, it is created and a new index is returned. In case of failure``*puiIndexMaterial``is unchanged.

A3DGraphMaterialDatamaterial_data=A3D_MAKE_DATA(A3DGraphMaterialData);
A3DUns32idx_0=A3D_DEFAULT_MATERIAL_INDEX;

A3DStatusresult=A3DGlobalInsertGraphMaterial(&material_data,&idx_0);
assert(result==A3D_SUCCESS);

Secondinsertionwiththesamedata,expectindextobethesame.
A3DUns32idx_1=A3D_DEFAULT_MATERIAL_INDEX;
result=A3DGlobalInsertGraphMaterial(&material_data,&idx_1);
assert(result==A3D_SUCCESS);
assert(idx_0==idx_1);

Parameters

pData: The material data to insert.

puiIndexMaterial: The resulting index for the input color.

Returns

A3D_SUCCESS or an error code.