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 |
|---|---|
|
n era un valor negativo. |
|
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 |
|
| Biblioteca |
|
| Archivo DLL |
|