glSaveProgramsDMP Function

GL_APICALL GLsizei GL_APIENTRY glSaveProgramsDMP(
     GLuint n,
     GLuint * progs,
     GLuint flags,
     GLsizei bufsize,
     GLvoid * data
);

	Name	Description
in	n	Number of program objects.
in	progs	Pointer to an array storing the program objects.
in	flags	Setting for the state to save (GL_SAVE_PROGRAMS_DMP).
in	bufsize	Size (in bytes) of the region storing the save data.
out	data	Pointer to the region storing the save data.

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

Saves the program object state.

Set n to the number of program objects stored in progs. Set progs to a pointer to an array storing the program objects. GL_SAVE_PROGRAMS_DMP is the only possible value for the flags argument. Setting this saves the state for all program objects. If you set flags to a bitwise OR with GL_SAVE_PROGRAMS_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 array specified by data. A GL_INVALID_OPERATION error occurs when data is nonzero and less than the number of bytes of save data. Set data to a pointer to the region where the data should be saved. If you set it to 0, data is not saved. The return value gives the number of bytes of data to save.

The following errors occur in this function.

GL_INVALID_VALUE	n or progs is 0, or flags is not GL_SAVE_PROGRAMS_DMP.
GL_INVALID_OPERATION	An invalid or unlinked program object is stored in progs, or the save data exceeds the number of bytes specified by bufsize.
GL_OUT_OF_MEMORY	Failed to allocate memory that is used internally.

2010/01/07

Initial version.