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 invariably adds a command to complete the loading of 3D commands and a 3D execution command, even if no commands have accumulated in the 3D command buffer. The nngxFlush3DCommand function only adds the command to complete the loading of 3D commands and a 3D execution command when commands have accumulated in the 3D command buffer. We thus recommend you use nngxFlush3DCommand rather than this function so there is no unintentional adding of 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.