rename upstream-man-pages to upstream-doc
[clinton/guile-figl.git] / upstream-doc / man4 / glInvalidateBufferData.xml
CommitLineData
7faf1d71
AW
1<?xml version="1.0" encoding="UTF-8"?>\r
2<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook MathML Module V1.1b1//EN"\r
3 "http://www.oasis-open.org/docbook/xml/mathml/1.1CR1/dbmathml.dtd">\r
4<refentry id="glInvalidateBufferData">\r
5 <refmeta>\r
6 <refmetainfo>\r
7 <copyright>\r
8 <year>2012</year>\r
9 <holder>Khronos Group</holder>\r
10 </copyright>\r
11 </refmetainfo>\r
12 <refentrytitle>glInvalidateBufferData</refentrytitle>\r
13 <manvolnum>3G</manvolnum>\r
14 </refmeta>\r
15 <refnamediv>\r
16 <refname>glInvalidateBufferData</refname>\r
17 <refpurpose>invalidate the content of a buffer object's data store</refpurpose>\r
18 </refnamediv>\r
19 <refsynopsisdiv><title>C Specification</title>\r
20 <funcsynopsis>\r
21 <funcprototype>\r
22 <funcdef>void <function>glInvalidateBufferData</function></funcdef>\r
23 <paramdef>GLuint <parameter>buffer</parameter></paramdef>\r
24 </funcprototype>\r
25 </funcsynopsis>\r
26 </refsynopsisdiv>\r
27 <refsect1 id="parameters"><title>Parameters</title>\r
28 <variablelist>\r
29 <varlistentry>\r
30 <term><parameter>buffer</parameter></term>\r
31 <listitem>\r
32 <para>\r
33 The name of a buffer object whose data store to invalidate.\r
34 </para>\r
35 </listitem>\r
36 </varlistentry>\r
37 </variablelist>\r
38 </refsect1>\r
39 <refsect1 id="description"><title>Description</title>\r
40 <para>\r
41 <function>glInvalidateBufferData</function> invalidates all of the\r
42 content of the data store of a buffer object. After invalidation, the content\r
43 of the buffer's data store becomes undefined.\r
44 </para>\r
45 </refsect1>\r
46 <refsect1 id="errors"><title>Errors</title>\r
47 <para>\r
48 <constant>GL_INVALID_VALUE</constant> is generated if <parameter>buffer</parameter> is not the\r
49 name of an existing buffer object.\r
50 </para>\r
51 <para>\r
52 <constant>GL_INVALID_OPERATION</constant> is generated if any part of <parameter>buffer</parameter>\r
53 is currently mapped.\r
54 </para>\r
55 </refsect1>\r
56 <refsect1 id="associatedgets"><title>Associated Gets</title>\r
57 <para>\r
58 <citerefentry><refentrytitle>glGetBufferParameter</refentrytitle></citerefentry> with argument <constant>GL_BUFFER_SIZE</constant>\r
59 </para>\r
60 </refsect1>\r
61 <refsect1 id="seealso"><title>See Also</title>\r
62 <para>\r
63 <citerefentry><refentrytitle>glInvalidateTexSubImage</refentrytitle></citerefentry>,,\r
64 <citerefentry><refentrytitle>glInvalidateTexImage</refentrytitle></citerefentry>,\r
65 <citerefentry><refentrytitle>glInvalidateBufferSubData</refentrytitle></citerefentry>,\r
66 <citerefentry><refentrytitle>glInvalidateFramebuffer</refentrytitle></citerefentry>,\r
67 <citerefentry><refentrytitle>glInvalidateSubFramebuffer</refentrytitle></citerefentry>.\r
68 </para>\r
69 </refsect1>\r
70 <refsect1 id="Copyright"><title>Copyright</title>\r
71 <para>\r
72 Copyright <trademark class="copyright"></trademark> 2012 Khronos Group. \r
73 This material may be distributed subject to the terms and conditions set forth in \r
74 the Open Publication License, v 1.0, 8 June 1999.\r
75 <ulink url="http://opencontent.org/openpub/">http://opencontent.org/openpub/</ulink>.\r
76 </para>\r
77 </refsect1>\r
78</refentry>\r