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>glSaveVertexStateCollectionsDMP</title>
8  </head>
9  <body>
10<h1><CODE>glSaveVertexStateCollectionsDMP</CODE> Function</h1>
11<h2>Syntax</h2>
12    <div class="section">
13      <pre class="definition">
14GL_APICALL GLsizei GL_APIENTRY glSaveVertexStateCollectionsDMP(
15     GLuint n,
16     GLuint * vscolls,
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 vertex state collection objects</td>
37        </tr>
38        <tr>
39<td>in</td>
40<th>vscolls</th>
41<td>Pointer to an array storing the vertex state collection objects</td>
42        </tr>
43        <tr>
44<td>in</td>
45<th>flags</th>
46<td>Settings for the state to save (<CODE>GL_SAVE_VERTEX_STATE_COLLECTIONS_DMP</CODE>).</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 vertex state collection objects.</p><P>
64Set <span class="argument">n</span> to the number of vertex state collection objects stored in <span class="argument">vscolls</span>. Set <span class="argument">vscolls</span> to a pointer to an array storing the vertex state collection objects. You can set <span class="argument">flags</span> to <CODE>GL_SAVE_VERTEX_STATE_COLLECTIONS_DMP</CODE> to save the entire state of vertex state collection objects. If you set <span class="argument">flags</span> to a bitwise OR that includes <CODE>GL_SAVE_VERTEX_STATE_COLLECTIONS_CTR_FORMAT_DMP</CODE>, 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.
65            </P><P>
66Set <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.
67            </P><P>
68This function generates the following errors.
69<TABLE><TR><TH>GL_INVALID_VALUE</TH><TD>The <span class="argument">n</span> or <span class="argument">vscolls</span> argument is 0; <span class="argument">flags</span> is not <CODE>GL_SAVE_VERTEX_STATE_COLLECTIONS_DMP</CODE>; or the vertex state collection objects stored in <span class="argument">vscolls</span> are set to invalid values.</TD></TR><TR><TH>GL_INVALID_OPERATION</TH><TD>An invalid vertex buffer object is bound to the vertex state collection objects stored in <span class="argument">vscolls</span>, or the data to save 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、vscollsが0の場合、flagsがGL_SAVE_VERTEX_STATE_COLLECTIONS_DMPでない場合、 vscollsに格納されている頂点ステートコレクションオブジェクトが不正な値の場合エラーGL_INVALID_VALUEを生成します。 vscollsに格納されている頂点ステートコレクションオブジェクトに不正な頂点バッファオブジェクトが関連付けられている場合エラーGL_INVALID_OPERATIONを生成します。 内部で使用するメモリの確保に失敗した場合エラーGL_OUT_OF_MEMORYを生成します。                 --></P></div>
70<h2>Revision History</h2>
71    <div class="section">
72      <dl class="history">
73        <dt>2010/01/07</dt>
74<dd>Initial version.<br />
75        </dd>
76      </dl>
77    </div>
78  <hr><p>CONFIDENTIAL</p></body>
79</html>