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 3D execution command, 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 3D render command request when 3D commands have accumulated in the 3D command buffer. Nintendo recommends you use the nngxFlush3DCommand function 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.

nngxFlush3DCommand

2011/10/04

Added See Also section.

2010/10/07

Added an explanation about the nngxFlush3DCommand function.

2010/03/12

Added extended error code(s).

2010/01/07

Initial version.