1 <?xml version=
"1.0" encoding=
"UTF-8"?>
2 <!DOCTYPE book PUBLIC
"-//OASIS//DTD DocBook MathML Module V1.1b1//EN"
3 "http://www.oasis-open.org/docbook/xml/mathml/1.1CR1/dbmathml.dtd">
4 <refentry id=
"glGenTextures">
9 <holder>Silicon Graphics, Inc.
</holder>
12 <refentrytitle>glGenTextures
</refentrytitle>
13 <manvolnum>3G
</manvolnum>
16 <refname>glGenTextures
</refname>
17 <refpurpose>generate texture names
</refpurpose>
19 <refsynopsisdiv><title>C Specification
</title>
22 <funcdef>void
<function>glGenTextures
</function></funcdef>
23 <paramdef>GLsizei
<parameter>n
</parameter></paramdef>
24 <paramdef>GLuint *
<parameter>textures
</parameter></paramdef>
28 <refsect1 id=
"parameters"><title>Parameters
</title>
31 <term><parameter>n
</parameter></term>
34 Specifies the number of texture names to be generated.
39 <term><parameter>textures
</parameter></term>
42 Specifies an array in which the generated texture names are stored.
48 <refsect1 id=
"description"><title>Description
</title>
50 <function>glGenTextures
</function> returns
<parameter>n
</parameter> texture names in
<parameter>textures
</parameter>.
51 There is no guarantee that the names form a contiguous set of integers;
52 however, it is guaranteed that none of the returned names was in use
53 immediately before the call to
<function>glGenTextures
</function>.
56 The generated textures have no dimensionality; they assume the dimensionality
57 of the texture target to which they are first bound
58 (see
<citerefentry><refentrytitle>glBindTexture
</refentrytitle></citerefentry>).
61 Texture names returned by a call to
<function>glGenTextures
</function> are not returned by
62 subsequent calls, unless they are first deleted with
63 <citerefentry><refentrytitle>glDeleteTextures
</refentrytitle></citerefentry>.
66 <refsect1 id=
"notes"><title>Notes
</title>
68 <function>glGenTextures
</function> is available only if the GL version is
1.1 or greater.
71 <refsect1 id=
"errors"><title>Errors
</title>
73 <constant>GL_INVALID_VALUE
</constant> is generated if
<parameter>n
</parameter> is negative.
76 <constant>GL_INVALID_OPERATION
</constant> is generated if
<function>glGenTextures
</function> is executed
77 between the execution of
<citerefentry><refentrytitle>glBegin
</refentrytitle></citerefentry> and the corresponding
78 execution of
<citerefentry><refentrytitle>glEnd
</refentrytitle></citerefentry>.
81 <refsect1 id=
"associatedgets"><title>Associated Gets
</title>
83 <citerefentry><refentrytitle>glIsTexture
</refentrytitle></citerefentry>
86 <refsect1 id=
"seealso"><title>See Also
</title>
88 <citerefentry><refentrytitle>glBindTexture
</refentrytitle></citerefentry>,
89 <citerefentry><refentrytitle>glCopyTexImage1D
</refentrytitle></citerefentry>,
90 <citerefentry><refentrytitle>glCopyTexImage2D
</refentrytitle></citerefentry>,
91 <citerefentry><refentrytitle>glDeleteTextures
</refentrytitle></citerefentry>,
92 <citerefentry><refentrytitle>glGet
</refentrytitle></citerefentry>,
93 <citerefentry><refentrytitle>glGetTexParameter
</refentrytitle></citerefentry>,
94 <citerefentry><refentrytitle>glTexImage1D
</refentrytitle></citerefentry>,
95 <citerefentry><refentrytitle>glTexImage2D
</refentrytitle></citerefentry>,
96 <citerefentry><refentrytitle>glTexImage3D
</refentrytitle></citerefentry>,
97 <citerefentry><refentrytitle>glTexParameter
</refentrytitle></citerefentry>
100 <refsect1 id=
"Copyright"><title>Copyright
</title>
102 Copyright
<trademark class=
"copyright"></trademark> 1991-
2006
103 Silicon Graphics, Inc. This document is licensed under the SGI
104 Free Software B License. For details, see
105 <ulink url=
"http://oss.sgi.com/projects/FreeB/">http://oss.sgi.com/projects/FreeB/
</ulink>.