A3DGraphAmbientLightCreate

A3DStatus A3DGraphAmbientLightCreate(const A3DGraphAmbientLightData *pData, A3DGraphAmbientLight **ppLight)
A3DStatus A3DGraphAmbientLightCreate(const A3DGraphAmbientLightData* pData, A3DGraphAmbientLight** ppLight)

Creates a new ambient light source entity, returning its handle.

2.0

Once created, the new light entity can be referenced to by its handle, given by *ppLight. In case of failure, *ppLight is unchanged.

Return Values

A3D_SUCCESS: in case of success.

A3D_INITIALIZE_NOT_CALLED: if the library is not initialized

A3D_INVALID_DATA_STRUCT_NULL: if pData is null.

A3D_INVALID_DATA_STRUCT_SIZE: if pData is incorrectly initialized

A3DGraphAmbientLight handle = 0;
A3DGraphAmbientLightData data = A3D_MAKE_DATA(A3DGraphAmbientLightData);
// Configure data...
A3DStatus result = A3DGraphAmbientLightCreate(&data, &handle);
assert(handle != 0);

Parameters

pData: The data used for light creation.

ppLight: An address to the new handle after creation.

Returns

A3D_SUCCESS or an error code in case of failure.