nngxImportCmdlist Function

NNGX_APICALL void NNGX_APIENTRY nngxImportCmdlist(
     GLuint cmdlist,
     GLvoid * data,
     GLsizei datasize
);

	Name	Description
in	cmdlist	Command list object into which you are importing data
in	data	Pointer to the exported data
in	datasize	Size (in bytes) of the exported data

No values are returned.

Imports an exported command list (binary data) to the specified command list.

Imports data exported by nngxExportCmdlist into a command list. Set cmdlist equal to the command list object to import. Set data equal to a pointer to the exported data. Set datasize equal to the size (in bytes) of the exported data.

You can set cmdlist equal to either the command list that is currently bound or to an unbound command list. If commands have already been accumulated in cmdlist, the imported commands are added after the accumulated commands.

If the first command request of the data that you are importing is not a 3D execution command, bind the destination command list as the current one before calling this function and then call nngxSplitDrawCmdlist to add a split command.

Calls to this function sometimes cause dummy commands to be generated for padding in the 3D command buffer of the command list into which you are importing data.

This function generates the following errors.

GL_ERROR_8041_DMP	Invalid value specified for cmdlist.
GL_ERROR_8042_DMP	Pointer to invalid data specified for data.
GL_ERROR_8043_DMP	Value specified for datasize does not match size of exported data.
GL_ERROR_8044_DMP	By adding the imported commands, you exceed the maximum size for the 3D command buffer or command requests.
GL_ERROR_8045_DMP	Imported the data whose first command request is not a 3D execution command when the 3D command buffer of the destination command list has not been split.

2010/03/12

Initial version.