A3DGraphAmbientLightCreate
-
A3DStatus
A3DGraphAmbientLightCreate(const A3DGraphAmbientLightData *pData, A3DGraphAmbientLight **ppLight) A3DStatusA3DGraphAmbientLightCreate(constA3DGraphAmbientLightData* pData,A3DGraphAmbientLight** ppLight)Creates a new ambient light source entity, returning its handle.
2.0Once created, the new light entity can be referenced to by its handle, given by
*ppLight. In case of failure,*ppLightis 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
pDatais null.A3D_INVALID_DATA_STRUCT_SIZE: if
pDatais incorrectly initializedA3DGraphAmbientLight 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_SUCCESSor an error code in case of failure.