1<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
2<html xml:lang="en-US" lang="en-US" xmlns="http://www.w3.org/1999/xhtml">
3  <head>
4    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
5    <meta http-equiv="Content-Style-Type" content="text/css" />
6    <link rel="stylesheet" href="../css/manpage.css" type="text/css" />
7<title>glSaveTextureCollectionsDMP</title>
8  </head>
9  <body>
10<h1><CODE>glSaveTextureCollectionsDMP</CODE> Function</h1>
11<h2>Syntax</h2>
12    <div class="section">
13      <pre class="definition">
14GL_APICALL GLsizei GL_APIENTRY glSaveTextureCollectionsDMP(
15     GLuint n,
16     GLuint * txcolls,
17     GLuint flags,
18     GLsizei bufsize,
19     GLvoid * data
20);
21</pre>
22    </div>
23<h2>Arguments</h2>
24    <div class="section">
25      <table class="arguments">
26        <thead>
27          <tr>
28            <td width="15" />
29<th>Name</th>
30<td>Description</td>
31          </tr>
32        </thead>
33        <tr>
34<td>in</td>
35<th>n</th>
36<td>Number of texture collection objects</td>
37        </tr>
38        <tr>
39<td>in</td>
40<th>txcolls</th>
41<td>Pointer to an array storing the texture collection objects</td>
42        </tr>
43        <tr>
44<td>in</td>
45<th>flags</th>
46<td>Settings for the state to save</td>
47        </tr>
48        <tr>
49<td>in</td>
50<th>bufsize</th>
51<td>Size (in bytes) of the region storing the saved data</td>
52        </tr>
53        <tr>
54<td>out</td>
55<th>data</th>
56<td>Pointer to the region storing the saved data</td>
57        </tr> </table>
58    </div>
59<h2>Return Values</h2>
60<div class="section">Returns the size (in bytes) of the saved data. </div>
61<h2>Description</h2>
62    <div class="section">
63<p>Saves the state of texture collection objects.</p><P>
64Set <span class="argument">n</span> to the number of texture collection objects stored in <span class="argument">txcolls</span>. Set <span class="argument">txcolls</span> to a pointer to an array storing the texture collection objects.
65            </P><P>
66You can set <span class="argument">flags</span> to <CODE>GL_SAVE_TEXTURE_COLLECTIONS_DMP</CODE> to save the entire state of texture collection objects.
67            </P><P>
68You can also set <span class="argument">flags</span> to the following values, or to a bitwise OR of any of the following values. In this case, a partial state is saved.
69<TABLE><TR><TH>GL_SAVE_TEXTURE_COLLECTION_1D_TEXTURES_DMP</TH><TD>Lookup table objects are saved.</TD></TR><TR><TH>GL_SAVE_TEXTURE_COLLECTION_2D_TEXTURES_DMP</TH><TD>2D texture objects are saved.</TD></TR><TR><TH>GL_SAVE_TEXTURE_COLLECTION_CUBE_TEXTURES_DMP</TH><TD>Cube-map texture objects are saved.</TD></TR></TABLE><!-- source                      GL_SAVE_TEXTURE_COLLECTION_1D_TEXTURES_DMPを指定した場合、参照テーブルオブジェクトが保存されます。 GL_SAVE_TEXTURE_COLLECTION_2D_TEXTURES_DMPを指定した場合、2Dテクスチャオブジェクトが保存されます。 GL_SAVE_TEXTURE_COLLECTION_CUBE_TEXTURES_DMPを指定した場合、キューブマップテクスチャオブジェクトが保存されます。                 --></P><P>
70If you also include <CODE>GL_SAVE_TEXTURE_COLLECTIONS_CTR_FORMAT_DMP</CODE> in the bitwise OR value specified for <span class="argument">flags</span>, 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.
71            </P><P>
72Set <span class="argument">bufsize</span> to the size (in bytes) of the region specified by <span class="argument">data</span>. A <CODE>GL_INVALID_OPERATION</CODE> error occurs when <span class="argument">data</span> is nonzero and less than the number of bytes of saved data. Set <span class="argument">data</span> 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.
73            </P><P>
74This function generates the following errors.
75<TABLE><TR><TH>GL_INVALID_VALUE</TH><TD>The <span class="argument">n</span> or <span class="argument">txcolls</span> argument is 0, or a texture collection object stored in <span class="argument">txcolls</span> is set to an invalid value.</TD></TR><TR><TH>GL_INVALID_OPERATION</TH><TD>An invalid texture object is bound to the texture collection objects stored in <span class="argument">txcolls</span>, or the saved data is larger than the number of bytes specified by <span class="argument">bufsize</span>.</TD></TR><TR><TH>GL_OUT_OF_MEMORY</TH><TD>Failed to allocate memory that is used internally.</TD></TR></TABLE><!-- source                      n、txcollsが0の場合、およびtxcollsに格納されるテクスチャコレクションオブジェクトが不正な値の場合エラーGL_INVALID_VALUEを生成します。 txcollsに格納されているテクスチャコレクションオブジェクトに不正なテクスチャオブジェクトが関連付けられている場合エラーGL_INVALID_OPERATIONを生成します。 内部で使用するメモリの確保に失敗した場合エラーGL_OUT_OF_MEMORYを生成します。                 --></P></div>
76<h2>Revision History</h2>
77    <div class="section">
78      <dl class="history">
79        <dt>2010/01/07</dt>
80<dd>Initial version.<br />
81        </dd>
82      </dl>
83    </div>
84  <hr><p>CONFIDENTIAL</p></body>
85</html>