Функция glPrioritizeTextures
Функция glPrioritizeTextures задает приоритет пребывания текстур.
Синтаксис
void WINAPI glPrioritizeTextures(
GLsizei n,
const GLuint *textures,
const GLclampf *priorities
);
Параметры
-
n
-
Число текстур, для которых требуется установить приоритет.
-
Текстуры
-
Указатель на первый элемент массива, содержащий имена текстур для приоритета.
-
Приоритеты
-
Указатель на первый элемент массива, содержащий приоритеты текстуры. Приоритет, заданный в элементе параметра priorityes , применяется к текстуре, именуемой соответствующим элементом параметра textures .
Возвращаемое значение
Эта функция не возвращает значение.
Коды ошибок
Следующие коды ошибок могут быть получены функцией glGetError .
| Имя | Значение |
|---|---|
|
n — отрицательное значение. |
|
Функция была вызвана между вызовом glBegin и соответствующим вызовом glEnd. |
Комментарии
Функция glPrioritizeTextures назначает n приоритетов текстур, указанных в параметре priorities , n текстурам, указанным в параметре textures . На компьютерах с ограниченным объемом памяти текстур OpenGL устанавливает "рабочий набор" текстур, которые находятся в памяти текстур. Эти текстуры можно привязать к целевому объекту текстуры гораздо эффективнее, чем к текстурам, которые не являются резидентными.
Задав приоритет для каждой текстуры, функция glPrioritizeTextures позволяет определить, какие текстуры должны быть резидентными.
Элементы приоритетов текстуры в приоритетах перед назначением закрепляются в диапазоне [0,0, 1,0]. Нуль указывает на самый низкий приоритет; Таким образом, текстуры с нулевым приоритетом являются наименее резидентными. Значение 1.0 указывает на наивысший приоритет; таким образом, текстуры с приоритетом 1.0, скорее всего, будут резидентными. Однако текстуры не гарантированно будут резидентными до тех пор, пока они не будут привязаны.
Функция glPrioritizeTextures игнорирует попытки определить приоритет текстуры 0 или любое имя текстуры, которое не соответствует существующей текстуре. Ни одна из функций, именуемых параметром textures , не должна быть привязана к целевому объекту текстуры.
Если текстура в настоящее время привязана, можно также использовать функцию glTexParameter , чтобы задать ее приоритет. Это единственный способ задать приоритет текстуры по умолчанию.
Вы можете включить glPrioritizeTextures в списки отображения.
Следующая функция получает приоритет привязанной текстуры, связанной с glPrioritizeTextures:
- glGetTexParameter с именем параметра GL_TEXTURE_PRIORITY
Примечание
Функция glPrioritizeTextures доступна только в OpenGL версии 1.1 или более поздней.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента |
Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера |
Windows 2000 Server [только классические приложения] |
| Заголовок |
|
| Библиотека |
|
| DLL |
|