glCreateTextures

From OpenGL Reference
Jump to navigation Jump to search

Create texture objects.

C Specification[edit]

void glCreateTextures( GLenum target, GLsizei n, GLuint * textures );


Parameters[edit]

target - Specifies the effective texture target of each created texture.
n - Number of texture objects to create.
textures - Specifies an array in which names of the new texture objects are stored.


Description[edit]

 glCreateTextures returns n previously unused texture names in textures , each representing a new texture object of the dimensionality and type specified by target and initialized to the default values for that texture type.

 target must be one of GL_TEXTURE_1D , GL_TEXTURE_2D , GL_TEXTURE_3D , GL_TEXTURE_1D_ARRAY , GL_TEXTURE_2D_ARRAY , GL_TEXTURE_RECTANGLE , GL_TEXTURE_CUBE_MAP , GL_TEXTURE_CUBE_MAP_ARRAY , GL_TEXTURE_BUFFER , GL_TEXTURE_2D_MULTISAMPLE or GL_TEXTURE_2D_MULTISAMPLE_ARRAY .


Errors[edit]

 GL_INVALID_ENUM is generated if target is not one of the allowable values.

 GL_INVALID_VALUE is generated if n is negative.


Version Support[edit]

 glCreateTextures  4.5+

See Also[edit]

 glBindTexture , glDeleteTextures , glGenTextures , glGet , glGetTexParameter , glIsTexture , glTexBuffer , glTexImage1D , glTexImage2D , glTexImage2DMultisample , glTexImage3D , glTexImage3DMultisample , glTexParameter 


Copyright[edit]

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. http://opencontent.org/openpub/.