nngxSetGasAutoAccumulationUpdate Function

NNGX_APICALL void NNGX_APIENTRY nngxSetGasAutoAccumulationUpdate(
     GLint id
);

	Name	Description
in	id	ID of the command request for the interrupt handler to update.

There is no return value.

Updates the additive blending results from gas density rendering.

Updates the INVERTED_ACC_MAX1 value related to additive blending results from gas density rendering. For more details on INVERTED_ACC_MAX1, see the DMPGL 2.0 Specifications.

The nngxSetGasAutoAccumulationUpdate function first determines the maximum value of D1, which is a result of additive blending when gas density information is rendered. Upon completion of the idth command request in the bound command-list object, the interrupt handler that is invoked applies the maximum value to INVERTED_ACC_MAX1.

For example, when id is 1 this setting affects the first command request, when id is 2 this setting affects the second command request, and so on. You must specify a command request that is a 3D execution command.

This function is required to implement the functionality of the fragment shader uniform dmp_Gas.autoAcc using commands generated by the application. You must clear the maximum value saved for the additive blending result D1 to 0 before you start rendering gas density information. The maximum value is cleared (initialized) with bits [15:0] of register 0x125. After rendering the gas density information and before you start gas shading, call this function again to update INVERTED_ACC_MAX1.

INVERTED_ACC_MAX1 is updated correctly when this function is called by a command request that includes a command to render gas density information. However, note that it is impossible to update INVERTED_ACC_MAX1 before gas shading when this function is called by a command request that includes both a command to render gas density information and a command to start gas shading. If a value is written to bits [15:0] of register 0x0e5 after this function has updated INVERTED_ACC_MAX1, this function’s settings are overwritten and invalidated.

The following errors occur with this function.

GL_ERROR_806D_DMP	0 is bound to the command list object.
GL_ERROR_806E_DMP	The id value is invalid (due to the following reasons). The value is 0 or less. The value specified is greater than the number of accumulated command requests. The specified command request is not a 3D execution command.

2010/09/15

Initial version.