glSaveVertexStateCollectionsDMP Function

GL_APICALL GLsizei GL_APIENTRY glSaveVertexStateCollectionsDMP(
     GLuint n,
     GLuint * vscolls,
     GLuint flags,
     GLsizei bufsize,
     GLvoid * data
);

	Name	Description
in	n	Number of vertex state collection objects
in	vscolls	Pointer to an array storing the vertex state collection objects
in	flags	Settings for the state to save (GL_SAVE_VERTEX_STATE_COLLECTIONS_DMP).
in	bufsize	Size (in bytes) of the region storing the saved data
out	data	Pointer to the region storing the saved data

Returns the size (in bytes) of the saved data.

Saves the state of vertex state collection objects.

Set n to the number of vertex state collection objects stored in vscolls. Set vscolls to a pointer to an array storing the vertex state collection objects. You can set flags to GL_SAVE_VERTEX_STATE_COLLECTIONS_DMP to save the entire state of vertex state collection objects. If you set flags to a bitwise OR that includes GL_SAVE_VERTEX_STATE_COLLECTIONS_CTR_FORMAT_DMP, you can save in the development hardware's data format from PicaOnDesktop. You cannot restore the development hardware's data format from the PicaOnDesktop environment.

Set bufsize to the size (in bytes) of the region specified by data. A GL_INVALID_OPERATION error occurs when data is nonzero and less than the number of bytes of saved data. Set data to a pointer to the region storing the saved data. If you set it to 0, data is not saved. The return value gives the number of bytes of saved data.

This function generates the following errors.

GL_INVALID_VALUE	The n or vscolls argument is 0; flags is not GL_SAVE_VERTEX_STATE_COLLECTIONS_DMP; or the vertex state collection objects stored in vscolls are set to invalid values.
GL_INVALID_OPERATION	An invalid vertex buffer object is bound to the vertex state collection objects stored in vscolls, or the data to save is larger than the number of bytes specified by bufsize.
GL_OUT_OF_MEMORY	Failed to allocate memory that is used internally.

2010/01/07

Initial version.