Função glPrioritizeTextures

A função glPrioritizeTextures define a prioridade de residência das texturas.

Sintaxe

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

Parâmetros

n

O número de texturas a serem priorizadas.

Texturas

Um ponteiro para o primeiro elemento de uma matriz que contém os nomes das texturas a serem priorizadas.

Prioridades

Um ponteiro para o primeiro elemento de uma matriz que contém as prioridades de textura. Uma prioridade dada em um elemento do parâmetro priorities se aplica à textura nomeada pelo elemento correspondente do parâmetro textures .

Retornar valor

Essa função não retorna um valor.

Códigos de erro

Os códigos de erro a seguir podem ser recuperados pela função glGetError .

Comentários

A função glPrioritizeTextures atribui as n prioridades de textura especificadas no parâmetro priorities às n texturas nomeadas no parâmetro textures . Em computadores com uma quantidade limitada de memória de textura, o OpenGL estabelece um "conjunto de trabalho" de texturas residentes na memória de textura. Essas texturas podem ser associadas a um destino de textura muito mais eficiente do que texturas que não são residentes.

Ao especificar uma prioridade para cada textura, a função glPrioritizeTextures permite determinar quais texturas devem ser residentes.

Os elementos de prioridades de textura em prioridades são fixados no intervalo [0.0, 1.0] antes de serem atribuídos. Zero indica a prioridade mais baixa; assim, texturas com prioridade zero são menos propensas a serem residentes. O valor 1.0 indica a prioridade mais alta; assim, texturas com prioridade 1.0 são mais propensas a serem residentes. No entanto, não há garantia de que as texturas sejam residentes até que sejam associadas.

A função glPrioritizeTextures ignora as tentativas de priorizar a textura 0 ou qualquer nome de textura que não corresponda a uma textura existente. Nenhuma das funções nomeadas pelo parâmetro textures precisa ser associada a um destino de textura.

Se uma textura estiver associada no momento, você também poderá usar a função glTexParameter para definir sua prioridade. Essa é a única maneira de definir a prioridade de uma textura padrão.

Você pode incluir glPrioritizeTextures em listas de exibição.

A função a seguir recupera a prioridade de uma textura associada no momento relacionada a glPrioritizeTextures:

• glGetTexParameter com o nome do parâmetro GL_TEXTURE_PRIORITY

Requisitos

Confira também

glAreTexturesResident

glBegin

glEnd

glGetTexParameter

glTexImage1D

glTexImage2D

glTexParameter