nngxSplitDrawCmdlist Function

NNGX_APICALL void NNGX_APIENTRY nngxSplitDrawCmdlist(
     void
);

None.

No values are returned.

Splits the 3D command buffer for the current command list.

By splitting the 3D command buffer, you can stop the command list and invoke an interrupt handler when execution has finished up to the split point. If commands are run as they are accumulated, the 3D commands accumulated up to the split point set using this function are run.

This function always adds a command to complete loading 3D commands and a command for 3D execution, even if no commands have accumulated in the 3D command buffer. The nngxFlush3DCommand function only adds the command to complete loading 3D commands and a command for 3D execution when commands have accumulated in the 3D command buffer. We thus recommend you use nngxFlush3DCommand rather than this function to avoid unintentionally adding unnecessary commands.

This function generates the following errors.

GL_ERROR_800C_DMP	0 is bound to the current command list.
GL_ERROR_800D_DMP	The number of accumulated command requests has reached the maximum number of command requests.
GL_ERROR_800E_DMP	The command buffer exceeded its capacity when a "loading completion command" for 3D commands was added to the accumulated 3D command buffer.

2010/10/07

Added an explanation about the nngxFlush3DCommand function.

2010/03/12

Added extended error code(s).

2010/01/07

Initial version.