Функция glAreTexturesResident

Функция glAreTexturesResident определяет, находятся ли указанные объекты текстуры в памяти текстуры.

Синтаксис

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

Параметры

n

Количество запрашиваемых текстур.

Текстуры

Адрес массива, содержащего имена запрашиваемых текстур.

Резиденции

Адрес массива, в котором возвращается состояние пребывания текстуры. Состояние проживания текстуры, именуемой элементом текстур, возвращается в соответствующем элементе резиденций.

Коды ошибок

Следующие коды ошибок могут быть получены функцией glGetError .

Имя	Значение
GL_INVALID_VALUE	n является отрицательным значением, элемент в текстурах равен нулю или элемент в текстурах не содержит идентификатора текстуры.
GL_INVALID_OPERATION	Функция была вызвана между вызовом glBegin и соответствующим вызовом glEnd.

Комментарии

На компьютерах с ограниченным объемом памяти текстур OpenGL создает рабочий набор текстур, которые находятся в памяти текстур. Эти текстуры могут быть привязаны к целевому объекту текстуры гораздо эффективнее, чем текстуры, которые не являются резидентными.

Функция glAreTexturesResident запрашивает состояние пребывания текстуры n текстур, именованных элементами текстур. Если все именованные текстуры являются резидентными, функция glAreTexturesResident возвращает GL_TRUE, а содержимое резиденций не нарушается. Если какая-либо из именованных текстур не является резидентной, glAreTexturesResident возвращает GL_FALSE, а подробное состояние возвращается в nэлементах резиденций.

Если элемент резиденции GL_TRUE, то текстура, именуемая соответствующим элементом текстур, находится в памяти текстуры.

Чтобы запросить состояние пребывания одной привязанной текстуры, вызовите метод glGetTexParameterс целевым параметром, заданным для целевой текстуры, к которой привязан целевой объект, и задайте для параметра pname значение GL_TEXTURE_RESIDENT. Этот метод необходимо использовать для запроса постоянного состояния текстуры по умолчанию.

Нельзя включить glAreTexturesResident в отображаемые списки.

Функция glAreTexturesResident возвращает состояние расположения текстур на момент вызова. Это не гарантирует, что текстуры останутся резидентными в любое другое время.

Если текстуры находятся в виртуальной памяти (нет памяти текстур), они всегда считаются резидентными.

Примечание

Функция glAreTexturesResident доступна только в OpenGL версии 1.1 или более поздней.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Заголовок	Gl.h
Библиотека	Opengl32.lib
DLL	Opengl32.dll

См. также раздел

glBegin

glBindTexture

glEnd

glGetTexParameter

glPrioritizeTextures

glTexImage1D

glTexImage2D