Función glGetString

La función glGetString devuelve una cadena que describe la conexión openGL actual.

Sintaxis

const GLubyte* WINAPI glGetString(
   GLenum name
);

Parámetros

name

Una de las siguientes constantes simbólicas.

Value	Significado
GL_VENDOR	Devuelve la empresa responsable de esta implementación de OpenGL. Este nombre no cambia de versión a versión.
GL_RENDERER	Devuelve el nombre del representador. Este nombre suele ser específico de una configuración determinada de una plataforma de hardware. No cambia de versión a versión.
GL_VERSION	Devuelve una versión o un número de versión.
GL_EXTENSIONS	Devuelve una lista separada por espacios de extensiones admitidas en OpenGL.

Códigos de error

La función glGetError puede recuperar los siguientes códigos de error.

Nombre	Significado
GL_INVALID_ENUM	name no era un valor aceptado.
GL_INVALID_OPERATION	Se llamó a la función entre una llamada a glBegin y la llamada correspondiente a glEnd.

Comentarios

La función glGetString devuelve un puntero a una cadena estática que describe algún aspecto de la conexión openGL actual.

Dado que OpenGL no incluye consultas para las características de rendimiento de una implementación, se espera que algunas aplicaciones se escriban para reconocer plataformas conocidas y modificarán su uso de OpenGL en función de las características de rendimiento conocidas de estas plataformas. Las cadenas GL_VENDOR y GL_RENDERER juntas especifican de forma única una plataforma y no cambiarán de versión a versión. Los algoritmos de reconocimiento de plataforma deben usarse como tal.

El formato y el contenido de la cadena que glGetString devuelve dependen de la implementación, excepto que:

• Los nombres de extensión no incluirán caracteres de espacio y se separarán por caracteres de espacio en la cadena GL_EXTENSIONS.

• La cadena GL_VERSION comienza con un número de versión. El número de versión usa uno de estos formularios:

  major_number. minor_number

  major_number. minor_number. release_number

• La información específica del proveedor puede seguir el número de versión. Su formato depende de la implementación, pero un espacio siempre separa el número de versión y la información específica del proveedor.

• Todas las cadenas terminan en null.

Si se genera un error, glGetString devuelve cero.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado	Gl.h
Biblioteca	Opengl32.lib
Archivo DLL	Opengl32.dll

Consulte también

glBegin

glEnd