Função glAreTexturesResident
A função glAreTexturesResident determina se os objetos de textura especificados residem na memória de textura.
Sintaxe
GLboolean WINAPI glAreTexturesResident(
GLsizei n,
const GLuint *textures,
GLboolean *residences
);
Parâmetros
-
n
-
O número de texturas a serem consultadas.
-
Texturas
-
O endereço de uma matriz que contém os nomes das texturas a serem consultadas.
-
Residências
-
O endereço de uma matriz na qual a residência de textura status é retornada. A residência status de uma textura denominada por um elemento de texturas é retornada no elemento correspondente de residências.
Códigos de erro
Os códigos de erro a seguir podem ser recuperados pela função glGetError .
| Nome | Significado |
|---|---|
|
n era um valor negativo, um elemento em texturas era zero ou um elemento em texturas não continha um identificador de textura. |
|
A função foi chamada entre uma chamada para glBegin e a chamada correspondente para glEnd. |
Comentários
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 com muito mais eficiência do que texturas que não são residentes.
A função glAreTexturesResident consulta a residência de textura status das n texturas nomeadas pelos elementos de texturas. Se todas as texturas nomeadas forem residentes, glAreTexturesResident retornará GL_TRUE e o conteúdo das residências não será perturbado. Se qualquer uma das texturas nomeadas não for residente, glAreTexturesResident retornará GL_FALSE e status detalhada será retornada nos nelementos de residências.
Se um elemento de residências for GL_TRUE, a textura nomeada pelo elemento correspondente de texturas será residente na memória de textura.
Para consultar a status de residência de uma única textura associada, chame glGetTexParameter com o parâmetro de destino definido como a textura de destino à qual o destino está associado e defina o parâmetro pname como GL_TEXTURE_RESIDENT. Você deve usar esse método para consultar a status residente de uma textura padrão.
Não é possível incluir glAreTexturesResident em listas de exibição.
A função glAreTexturesResident retorna a status de residência das texturas no momento da invocação. Não garante que as texturas permanecerão residentes em nenhum outro momento.
Se as texturas residirem na memória virtual (não há memória de textura), elas serão consideradas sempre residentes.
Observação
A função glAreTexturesResident só está disponível no OpenGL versão 1.1 ou posterior.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte |
Windows 2000 Server [somente aplicativos da área de trabalho] |
| Cabeçalho |
|
| Biblioteca |
|
| DLL |
|