|
| |||||||
| Function | LtStatus
| ||||||
| Synopsis |
Pre-process an emission set for use by a goniometric light source shader.
| ||||||
| Location | lishpro | ||||||
| Parameters |
| ||||||
| Return Value |
A status value.
| ||||||
| Description | In order for a goniometric light to be able to render emission set data, this data needs to be pre-processed. This pre-processing ensures that the data held by the emission set is in a form which is optimal for any rendering which uses the goniometric light. The pre-processing can be performed explicitly by calling LiEmissionSetPreProcess, but if it is not done for an emission set which is being used with a goniometric light, the light will perform the pre-processing itself. Note that calling this function for an emission set may change the contents of that emission set. If the original emission set data is still required then a copy must be taken (using LiEmissionSetCopy) before any calls to LiEmissionSetPreProcess are made. Attempting to pre-process a NULL emission set will result in an error status being returned. | ||||||
| Example |
LtEmissionSet tbp = (LtEmissionSet)NULL ; LtStatus status = LI_STATUS_OK ; /* * Create an emission set using LiEmissionSetCreate * then pre-process it. */ ... if ( tbp != (LtEmissionSet)NULL ) status = LiEmissionSetPreProcess( tbp ) ; | ||||||
| See Also |
LiEmissionSetCopy LiEmissionSetCreate LiEmissionSetDebug LiEmissionSetDestroy LiEmissionSetEnquire LiEmissionSetRead LiEmissionSetWrite | ||||||
|
Copyright © 1990-1998, 1999 LightWork Design Limited. All rights reserved | |||||||