File: glGetVertexArrayiv.xml

package info (click to toggle)
khronos-opengl-man4 1.0~svn31251-1
  • links: PTS, VCS
  • area: main
  • in suites: stretch
  • size: 6,368 kB
  • ctags: 267
  • sloc: xml: 93,382; makefile: 730; python: 627; sh: 50; php: 4
file content (132 lines) | stat: -rw-r--r-- 4,340 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
<!DOCTYPE refentry [ <!ENTITY % mathent SYSTEM "math.ent"> %mathent; ]>

<refentry xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="glGetVertexArrayiv">
  <info>
    <copyright>
      <year>2014</year>

      <holder>Khronos Group</holder>
    </copyright>
  </info>

  <refmeta>
    <refentrytitle>glGetVertexArrayiv</refentrytitle>

    <manvolnum>3G</manvolnum>
  </refmeta>

  <refnamediv>
    <refname>glGetVertexArrayiv</refname>

    <refpurpose>retrieve parameters of a vertex array object</refpurpose>
  </refnamediv>

  <refsynopsisdiv>
    <title>C Specification</title>

    <funcsynopsis>
      <funcprototype>
        <funcdef>void <function>glGetVertexArrayiv</function></funcdef>

        <paramdef>GLuint <parameter>vaobj</parameter></paramdef>

        <paramdef>GLenum <parameter>pname</parameter></paramdef>

        <paramdef>GLint *<parameter>param</parameter></paramdef>
      </funcprototype>
    </funcsynopsis>
  </refsynopsisdiv>

  <refsect1 xml:id="parameters">
    <title>Parameters</title>

    <variablelist>
      <varlistentry>
        <term><parameter>vaobj</parameter></term>

        <listitem>
          <para>specifies the name of the vertex array object to use for the
          query.</para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term><parameter>pname</parameter></term>

        <listitem>
          <para>Name of the property to use for the query. Must be
          <constant>GL_ELEMENT_ARRAY_BUFFER_BINDING</constant>.</para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term><parameter>param</parameter></term>

        <listitem>
          <para>Returns the requested value.</para>
        </listitem>
      </varlistentry>
    </variablelist>
  </refsect1>

  <refsect1 xml:id="description">
    <title>Description</title>

    <para>This function provides a mean of querying properties of an existing
    vertex array object. The vertex array object does not have to be bound to
    the rendering context at the time of the call, but must have been bound at
    least once prior to this call.</para>

    <para><function>glGetVertexArrayiv</function> can be used to retrieve ID
    of a buffer object that will be bound to the
    <constant>GL_ELEMENT_ARRAY_BUFFER</constant> binding point whenever the
    queried vertex array object is bound to the rendering context. The binding
    can be changed for an active vertex array object with a
    <function>glBindBuffer</function> call.</para>
  </refsect1>

  <refsect1 xml:id="errors">
    <title>Errors</title>

    <para><constant>GL_INVALID_OPERATION</constant> error is generated if
    <parameter>vaobj</parameter> is not the name of an existing vertex array
    object.</para>

    <para><constant>GL_INVALID_ENUM</constant> error is generated if
    <parameter>pname</parameter> is not
    <constant>GL_ELEMENT_ARRAY_BUFFER_BINDING</constant>.</para>
  </refsect1>
  <refsect1 xml:id="versions"><title>Version Support</title>
        <informaltable>
            <tgroup cols="13" align="left">
                <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="apifunchead.xml" xpointer="xpointer(/*/*)"/>
                <tbody>
                    <row>
                        <entry><function>glGetVertexArrayiv</function></entry>
                        <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="apiversion.xml" xpointer="xpointer(/*/*[@role='45']/*)"/>
                    </row>
                </tbody>
            </tgroup>
        </informaltable>
  </refsect1>
  <refsect1 xml:id="seealso">
    <title>See Also</title>

    <para><citerefentry>
        <refentrytitle>glBindBuffer</refentrytitle>
      </citerefentry>, <citerefentry>
        <refentrytitle>glBindVertexArray</refentrytitle>
      </citerefentry>, <citerefentry>
        <refentrytitle>glGet</refentrytitle>
      </citerefentry></para>
  </refsect1>

  <refsect1 xml:id="Copyright">
    <title>Copyright</title>

    <para>Copyright <trademark class="copyright"/> 2014 Khronos Group. This
    material may be distributed subject to the terms and conditions set forth
    in the Open Publication License, v 1.0, 8 June 1999. <link
    xlink:href="http://opencontent.org/openpub/">http://opencontent.org/openpub/</link>.</para>
  </refsect1>
</refentry>