nngxStartCmdlistSave Function
NNGX_APICALL void NNGX_APIENTRY nngxStartCmdlistSave(
void
);
None.
Starts saving command list objects.
Starts saving the current command list object.
Use nngxStopCmdlistSave to get the saved information. It is assumed that saved commands will be reused. Because there is no way of knowing what the PICA register values will be when the 3D command buffer is reused, you must save all commands that will need to be reset at that time. If you save commands and then call functions as usual to generate commands, only the commands that are different from the saved commands will be generated. Because only differing commands are generated, it follows that the generated commands correspond only to states whose settings have changed. This means that sometimes not all necessary commands are generated. To generate all of the necessary commands, either use complete commands or configure the command output mode.
Complete commands refers to generating the entire set of commands for each state. Complete commands can result in excessive command generation because it generates all commands for each feature.
You can configure the command output mode to always generate commands related to functions that have been called, regardless of whether their settings changed.
This combination of features allows you to generate and save the appropriate commands as necessary and sufficient.
Calls to this function sometimes cause dummy commands to be generated in the 3D command buffer for padding.
This function generates the following errors.
| GL_ERROR_8034_DMP | This function was called again before the previous call to this function finished saving the command list. |
|---|---|
| GL_ERROR_8035_DMP | 0 is bound to the current command list. |
CONFIDENTIAL