glSaveTextureCollectionsDMP Function

GL_APICALL GLsizei GL_APIENTRY glSaveTextureCollectionsDMP(
     GLuint n,
     GLuint * txcolls,
     GLuint flags,
     GLsizei bufsize,
     GLvoid * data
);

	Name	Description
in	n	Number of texture collection objects
in	txcolls	Pointer to an array storing the texture collection objects
in	flags	Settings for the state to save
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 texture collection objects.

Set n to the number of texture collection objects stored in txcolls. Set txcolls to a pointer to an array storing the texture collection objects.

You can set flags to GL_SAVE_TEXTURE_COLLECTIONS_DMP to save the entire state of texture collection objects.

You can also set flags to the following values, or to a bitwise OR of any of the following values. In this case, a partial state is saved.

GL_SAVE_TEXTURE_COLLECTION_1D_TEXTURES_DMP	Lookup table objects are saved.
GL_SAVE_TEXTURE_COLLECTION_2D_TEXTURES_DMP	2D texture objects are saved.
GL_SAVE_TEXTURE_COLLECTION_CUBE_TEXTURES_DMP	Cube-map texture objects are saved.

If you also include GL_SAVE_TEXTURE_COLLECTIONS_CTR_FORMAT_DMP in the bitwise OR value specified for flags, you can save in the development hardware's data format from the PicaOnDesktop environment. 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 txcolls argument is 0, or a texture collection object stored in txcolls is set to an invalid value.
GL_INVALID_OPERATION	An invalid texture object is bound to the texture collection objects stored in txcolls, or the saved data 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.