Compartir a través de


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