nngxAddCmdlist Function

NNGX_APICALL void NNGX_APIENTRY nngxAddCmdlist(
     GLuint cmdlist
);

	Name	Description
in	cmdlist	Command list object to be added to the current command list object.

There is no return value.

Adds the content of the specified command list object to the current command list object.

Adds all commands accumulated in the command list object specified in cmdlist to the current command list object. If commands have already been accumulated in the current command list, the commands from cmdlist are added after the accumulated commands.

If it is not immediately after the current 3D command buffer has been split, and if the first command of the additional command requests is not a render command request, the nngxSplitDrawCmdlist function is called to split the command buffer. Then the commands are added.

If it is not immediately after the current 3D command buffer has been split, and if the first command of the additional command requests is a render command request, dummy commands are added as needed to adjust alignment. Then the commands are added.

The results of any later checks of the maximum size include the effects of internal calls to the nngxSplitDrawCmdlist function and of additional dummy commands.

The following errors occur in this function.

GL_ERROR_8054_DMP	Invalid value specified for cmdlist.
GL_ERROR_8055_DMP	The command list is not currently bound.
GL_ERROR_8056_DMP	The cmdlist argument specifies the current command list.
GL_ERROR_8057_DMP	The current command list is running.
GL_ERROR_8058_DMP	Running this function would cause the current command list command buffer or command request to exceed the maximum size.

2011/03/18

Deleted a note because support was added for values of cmdlist that reference an external 3D command buffer.

2011/02/18

Explained that there is no support for cmdlist when it references external 3D command buffers.

2010/04/02

Initial version.