Función glAreTexturesResident

La función glAreTexturesResident determina si los objetos de textura especificados residen en la memoria de textura.

Sintaxis

GLboolean WINAPI glAreTexturesResident(
         GLsizei   n,
   const GLuint    *textures,
         GLboolean *residences
);

Parámetros

n

Número de texturas que se van a consultar.

Texturas

Dirección de una matriz que contiene los nombres de las texturas que se van a consultar.

Residencias

Dirección de una matriz en la que se devuelve el estado de residencia de textura. El estado de residencia de una textura denominada por un elemento de texturas se devuelve en el elemento correspondiente de residencias.

Códigos de error

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

Nombre	Significado
GL_INVALID_VALUE	n era un valor negativo, un elemento de texturas era cero o un elemento de texturas no contenía un identificador de textura.
GL_INVALID_OPERATION	Se llamó a la función entre una llamada a glBegin y la llamada correspondiente a glEnd.

Comentarios

En las máquinas con una cantidad limitada de memoria de textura, OpenGL establece un conjunto de trabajo de texturas que residen en la memoria de textura. Estas texturas se pueden enlazar a un destino de textura mucho más eficaz que las texturas que no son residentes.

La función glAreTexturesResident consulta el estado de residencia de textura de las n texturas denominadas por los elementos de las texturas. Si todas las texturas con nombre son residentes, glAreTexturesResident devuelve GL_TRUE y el contenido de las residencias no se modifica. Si alguna de las texturas con nombre no es residente, glAreTexturesResident devuelve GL_FALSE y el estado detallado se devuelve en los n elementos de residencias.

Si se GL_TRUE un elemento de residencias , la textura denominada por el elemento correspondiente de texturas reside en la memoria de textura.

Para consultar el estado de residencia de una sola textura enlazada, llame a glGetTexParameter con el parámetro de destino establecido en la textura de destino a la que está enlazado el destino y establezca el parámetro pname en GL_TEXTURE_RESIDENT. Debe usar este método para consultar el estado residente de una textura predeterminada.

No se puede incluir glAreTexturesResident en las listas de visualización.

La función glAreTexturesResident devuelve el estado de residencia de las texturas en el momento de la invocación. No garantiza que las texturas permanezcan residentes en cualquier otro momento.

Si las texturas residen en la memoria virtual (no hay memoria de textura), se consideran siempre residentes.

Nota

La función glAreTexturesResident solo está disponible en OpenGL versión 1.1 o posterior.

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

glBindTexture

glEnd

glGetTexParameter

glPrioritizeTextures

glTexImage1D

glTexImage2D