Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   29550 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

GLGETOBJECTLABEL(3G)		 OpenGL Manual		  GLGETOBJECTLABEL(3G)

NAME
       glGetObjectLabel - retrieve the label of a named object identified
       within a namespace

C SPECIFICATION
       void glGetObjectLabel(GLenum identifier, GLuint name, GLsizei bifSize,
			     GLsizei * length, char * label);

PARAMETERS
       identifier
	   The namespace from which the name of the object is allocated.

       name
	   The name of the object whose label to retrieve.

       bufSize
	   The length of the buffer whose address is in label.

       length
	   The address of a variable to receive the length of the object
	   label.

       label
	   The address of a string that will receive the object label.

DESCRIPTION
       glGetObjectLabel retrieves the label of the object identified by name
       within the namespace given by identifier.  identifier must be one of
       GL_BUFFER, GL_SHADER, GL_PROGRAM, GL_VERTEX_ARRAY, GL_QUERY,
       GL_PROGRAM_PIPELINE, GL_TRANSFORM_FEEDBACK, GL_SAMPLER, GL_TEXTURE,
       GL_RENDERBUFFER, GL_FRAMEBUFFER, to indicate the namespace containing
       the names of buffers, shaders, programs, vertex array objects, query
       objects, program pipelines, transform feedback objects, samplers,
       textures, renderbuffers and frame buffers, respectively.

       label is the address of a string that will be used to store the object
       label.  bufSize specifies the number of characters in the array
       identified by label.  length contains the address of a variable which
       will receive the the number of characters in the object label. If
       length is NULL, then it is ignored and no data is written. Likewise, if
       label is NULL, or if bufSize is zero then no data is written to label.

ERRORS
       GL_INVALID_ENUM is generated if identifier is not one of the accepted
       object types.

       GL_INVALID_OPERATION is generated if name is not the name of an
       existing object of the type specified by identifier.

       GL_INVALID_VALUE is generated if bufSize is zero.

       If not NULL, length and label should be addresses to which the client
       has write access, otherwise undefined behavior, including process
       termination may occur.

ASSOCIATED GETS
       glGet() with argument GL_MAX_LABEL_LENGTH.

SEE ALSO
       glPushDebugGroup(), glPopDebugGroup(), glObjectLabel(),
       glGetObjectPtrLabel().

COPYRIGHT
       Copyright © 2012 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/.

AUTHORS
       opengl.org

opengl.org			  03/16/2013		  GLGETOBJECTLABEL(3G)

Vote for polarhome