GLES3.0中文API-glGetObjectLabel

名称

glGetObjectLabel — 检索命名空间中标识的命名对象的标签

C 规范

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

参数

identifier
从中分配对象名称的名称空间。

name
要检索其标签的对象的名称。

bufSize
地址在标签中的缓冲区的长度。

length
变量的地址，以接收对象标签的长度。

label
将接收对象标签的字符串的地址。

描述

glGetObjectLabel在标识符给定的名称空间中检索由名称标识的对象的标签。标识符必须是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，包含程序的名字，程序名称，名称，名称，名称，名称，名称，名称分别转换反馈对象，采样器，纹理，渲染缓冲区和帧缓冲区。

label是将用于存储对象标签的字符串的地址。 bufSize指定由label标识的数组中的字符数。 length包含变量的地址，该变量将接收对象标签中的字符数。如果length为NULL，则将其忽略并且不写入任何数据。同样，如果label为NULL或bufSize为零，则不会将任何数据写入label。

错误

如果标识符不是可接受的对象类型之一，则生成GL_INVALID_ENUM。

如果name不是标识符指定类型的现有对象的名称，则生成GL_INVALID_OPERATION。

如果bufSize为零，则生成GL_INVALID_VALUE。

如果不为NULL，则长度和标签应为客户端具有写访问权限的地址，否则可能发生不确定的行为，包括进程终止。

相关Gets

glGet with argument GL_MAX_LABEL_LENGTH.

API支持版本

函数名	2.0	3.0	3.1	3.2
glGetObjectLabel	-	-	-	✔

另见

glPushDebugGroup, glPopDebugGroup, glObjectLabel, glGetObjectPtrLabel.

版权

https://www.khronos.org/registry/OpenGL-Refpages/es3/html/glGetObjectLabel.xhtml
Copyright © 2013-2015 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/.