Прочитать на английском

Поделиться через


Функция glColor3fv

Задает текущий цвет из уже существующего массива значений цвета.

Синтаксис

void WINAPI glColor3fv(
   const GLfloat *v
);

Параметры

V

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

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

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

Комментарии

В GL хранятся как текущий однозначный индекс цвета, так и текущий четырехзначный цвет RGBA. glcolor задает новый четырехзначный цвет RGBA. Glcolor имеет два основных варианта: glcolor3 и glcolor4. Варианты glcolor3 явно указывают новые красные, зеленые и синие значения и неявно устанавливают текущее альфа-значение 1,0 (полная интенсивность). Варианты glcolor4 явно указывают все четыре компонента цвета.

glcolor3b, glcolor4b, glcolor3s, glcolor4s, glcolor3i и glcolor4i принимают три или четыре подписанных байта, короткие или длинные целые числа в качестве аргументов. При добавлении v к имени команды color могут принимать указатель на массив таких значений.

Текущие значения цвета хранятся в формате с плавающей запятой с неопределенными размерами мантиссы и экспоненты. Компоненты целочисленного цвета без знака, если они указаны, линейно сопоставляются со значениями с плавающей запятой таким образом, что наибольшее представляющее значение сопоставляется с 1,0 (полная интенсивность), а 0 — с 0,0 (нулевой интенсивностью). Компоненты цвета со знаком с целыми числами, если они указаны, линейно сопоставляются со значениями с плавающей запятой таким образом, что наиболее положительное из них сопоставляется с 1,0, а наиболее отрицательное из них — с -1,0. (Обратите внимание, что это сопоставление не преобразует 0 точно в 0,0.) Значения с плавающей запятой сопоставляются напрямую.

Ни целочисленные значения с плавающей запятой, ни целочисленные значения со знаком не зажимаются в диапазоне [0,1] до обновления текущего цвета. Однако компоненты цвета зажимаются в этом диапазоне перед интерполяцией или записью в буфер цвета.

Требования

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

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

glBegin

glEnd

glGetBooleanv, glGetDoublev, glGetFloatv, glGetIntegerv

glIndex