A3DGraphPointLightCreate

A3DStatus A3DGraphPointLightCreate(const A3DGraphPointLightData *pData, A3DGraphPointLight **ppLight)
A3DStatus A3DGraphPointLightCreate(const A3DGraphPointLightData* pData, A3DGraphPointLight** ppLight)

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

A3DGraphPointLight handle = 0;
A3DGraphPointLightData data = A3D_MAKE_DATA(A3DGraphPointLightData);
// Configure data...
A3DStatus result = A3DGraphPointLightCreate(&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.