función glPrioritizeTextures

La función glPrioritizeTextures establece la prioridad de residencia de texturas.

Sintaxis

void WINAPI glPrioritizeTextures(
         GLsizei  n,
   const GLuint   *textures,
   const GLclampf *priorities
);

Parámetros

n

Número de texturas que se van a priorizar.

Texturas

Puntero al primer elemento de una matriz que contiene los nombres de las texturas que se van a priorizar.

Prioridades

Puntero al primer elemento de una matriz que contiene las prioridades de textura. Una prioridad dada en un elemento del parámetro priority se aplica a la textura denominada por el elemento correspondiente del parámetro textures .

Valor devuelto

Esta función no devuelve ningún valor.

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.
GL_INVALID_OPERATION	Se llamó a la función entre una llamada a glBegin y la llamada correspondiente a glEnd.

Comentarios

La función glPrioritizeTexturesasigna las n prioridades de textura especificadas en el parámetro priorities a las n texturas denominadas en el parámetro textures. En los equipos 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 de forma mucho más eficaz que las texturas que no son residentes.

Al especificar una prioridad para cada textura, la función glPrioritizeTextures permite determinar qué texturas deben residir.

Los elementos de prioridades de textura de las prioridades se sujetan al intervalo [0.0, 1.0] antes de asignarse. Cero indica la prioridad más baja; por lo tanto, es menos probable que las texturas con prioridad cero sean residentes. El valor 1.0 indica la prioridad más alta; por lo tanto, es más probable que las texturas con prioridad 1.0 sean residentes. Sin embargo, no se garantiza que las texturas sean residentes hasta que estén enlazadas.

La función glPrioritizeTextures omite los intentos de priorizar la textura 0 o cualquier nombre de textura que no corresponda a una textura existente. Ninguna de las funciones denominadas por el parámetro textures debe enlazarse a un destino de textura.

Si una textura está enlazada actualmente, también puede usar la función glTexParameter para establecer su prioridad. Esta es la única manera de establecer la prioridad de una textura predeterminada.

Puede incluir glPrioritizeTextures en las listas para mostrar.

La siguiente función recupera la prioridad de una textura enlazada actualmente relacionada con glPrioritizeTextures:

• glGetTexParameter con el nombre de parámetro GL_TEXTURE_PRIORITY

Nota

La función glPrioritizeTextures 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

glAreTexturesResident

glBegin

glEnd

glGetTexParameter

glTexImage1D

glTexImage2D

glTexParameter