Функция glPrioritizeTextures

  • Статья

Функция glPrioritizeTextures задает приоритет пребывания текстур.

Синтаксис

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

Параметры

n

Число текстур, для которых требуется установить приоритет.

Текстуры

Указатель на первый элемент массива, содержащий имена текстур для приоритета.

Приоритеты

Указатель на первый элемент массива, содержащий приоритеты текстуры. Приоритет, заданный в элементе параметра priorityes , применяется к текстуре, именуемой соответствующим элементом параметра textures .

Возвращаемое значение

Эта функция не возвращает значение.

Коды ошибок

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

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

Комментарии

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

Задав приоритет для каждой текстуры, функция glPrioritizeTextures позволяет определить, какие текстуры должны быть резидентными.

Элементы приоритетов текстуры в приоритетах перед назначением закрепляются в диапазоне [0,0, 1,0]. Нуль указывает на самый низкий приоритет; Таким образом, текстуры с нулевым приоритетом являются наименее резидентными. Значение 1.0 указывает на наивысший приоритет; таким образом, текстуры с приоритетом 1.0, скорее всего, будут резидентными. Однако текстуры не гарантированно будут резидентными до тех пор, пока они не будут привязаны.

Функция glPrioritizeTextures игнорирует попытки определить приоритет текстуры 0 или любое имя текстуры, которое не соответствует существующей текстуре. Ни одна из функций, именуемых параметром textures , не должна быть привязана к целевому объекту текстуры.

Если текстура в настоящее время привязана, можно также использовать функцию glTexParameter , чтобы задать ее приоритет. Это единственный способ задать приоритет текстуры по умолчанию.

Вы можете включить glPrioritizeTextures в списки отображения.

Следующая функция получает приоритет привязанной текстуры, связанной с glPrioritizeTextures:

Примечание

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

Требования

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

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

glAreTexturesResident

glBegin

glEnd

glGetTexParameter

glTexImage1D

glTexImage2D

glTexParameter