A3DGraphSpotLightCreate

A3DStatus A3DGraphSpotLightCreate(const A3DGraphSpotLightData *pData, A3DGraphSpotLight **ppLight)
A3DStatus A3DGraphSpotLightCreate(const A3DGraphSpotLightData* pData, A3DGraphSpotLight** ppLight)

Creates a new spotlight 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

A3DGraphSpotLight handle = 0;
A3DGraphSpotLightData data = A3D_MAKE_DATA(A3DGraphSpotLightData);
// Configure data...
A3DStatus result = A3DGraphSpotLightCreate(&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.