nngxSetGasAutoAccumulationUpdate Function

NNGX_APICALL void NNGX_APIENTRY nngxSetGasAutoAccumulationUpdate(
     GLint id
);

	Name	Description
in	id	Command request ID for specifying the interrupt handler for updates.

There is no return value.

Updates the additive blending results from gas density rendering.

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

When called, the nngxSetGasAutoAccumulationUpdate function configures the maximum value of D1—a result of additive blending when gas density information is rendered—to be applied to INVERTED_ACC_MAX1 within the interrupt handler that is invoked upon completion of the idth command request accumulated in the bound command list object.

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 as necessary 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, use this function again to update INVERTED_ACC_MAX1 before you start gas shading.

INVERTED_ACC_MAX1 is updated correctly when this function is called on 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 on 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 in 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.