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_INITIALIZE_DATA(A3DGraphMaterialData,material_data);
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.