Home · All Classes · Main Classes · Grouped Classes · Modules · Functions |
Класс QColor предстасляет цвета, основанные на RGB или HSV моделях. Далее...
#include <QColor>
Класс QColor предстасляет цвета, основанные на RGB или HSV моделях.
Цвет обычно задается в терминах RGB (красный, зеленый и синий) компонентов, но также может быть задан в HSV (оттенок, насыщенность и яркость) или быть установлен по имени цвета (название цвета может быть любым из имен цветов SVG 1.0).
QColor также поддерживает задание прозрачности с помощью альфа-канала. Значение альфа-компонена, равное 0, означает полностью прозрачный цвет, в то время как значение, равное 255 означает полностью непрозрачный цвет. Например:
// Задается полупрозрачный красный цвет painter.setBrush(QColor(255, 0, 0, 127)); painter.drawRect(0, 0, width()/2, height()); // Задается полупрозрачный синий цвет painter.setBrush(QColor(0, 0, 255, 127)); painter.drawRect(0, 0, width(), height()/2);
Вышеприведенный пример приводит к выводу следующего изображения:
Альфа-смешивание поддерживается Windows, Mac OS X и системами X11, в которых установлено расширение X Render.
Значение альфа-компоненты цвета может быть получено и установлено с помощью функций alpha() и setAlpha(), если это значение типа integer, и с помощью функций alphaF() и setAlphaF(), если это значение типа qreal (double).
Правильность QColor (isValid()) указывает, является ли его значение корректным. Например, цвет RGB со значениями RGB, выходящими из диапазона, некорректен. По разумным соображениям QColor, главным образом, игнорирует некорректные цвета. Поэтому, результат использования некорректного цвета неопределен.
Есть 20 предопределенных объектов QColor: Qt::white, Qt::black, Qt::red, Qt::darkRed, Qt::green, Qt::darkGreen, Qt::blue, Qt::darkBlue, Qt::cyan, Qt::darkCyan, Qt::magenta, Qt::darkMagenta, Qt::yellow, Qt::darkYellow, Qt::gray, Qt::darkGray, Qt::lightGray, Qt::color0, Qt::color1 и Qt::transparent.
Цвета Qt::color0 (нулевой пиксель) и Qt::color1 (не-нулевой пиксель) - это специальные цвета для рисования на QBitmaps. Рисование цветом Qt::color0 устанавливает биты битовой карты в 0 (прозначным, т.е. цветом фона), а рисование цветом Qt::color1 устанавливает биты в 1 (непрозрачным, т.е. цветом рисунка).
QColor платформенно и аппаратно независим. QColormap - Класс-карта цветов для аппаратных средств.
Цвет можно задать передав в setNamedColor() строку RGB (например "#112233") или имя цвета (например "blue"). Имена соответсвуют именам цветов в SVG 1.0. Получить более светлый или более темный цвет можно с помощью light() и dark() соответственно. Цвета также могут быть заданы с помощью setRgb() и setHsv(). К цветовым компонентам можно обращаться как к комплексному значению цвета, с помощью rgb() и hsv(), так и индивидуально, с помощью red(), green() и blue().
Поскольку большинство людей не имеют представления о цветовой модели HSV, мы дадим ее краткий обзор.
Модель RGB является аппаратно-ориентированной. Ее представление близко к тому, что отображают большинство мониторов. HSV, напротив, представляет цвет способом, больше подходящим для человеческого восприятия цвета. Например, отношения "насыщенней чем", "темнее чем" и "противоположный" легко выразимы в модели HSV, но их тяжело выразить в модели RGB.
HSV, подобно RGB, имеет три компонента:
Приведем несколько примеров: чисто-красный цвет - H=0, S=255, V=255; темно красный, переходящий в сиреневый, может быть выражен H=350 (эквивалентно -10), S=255, V=180; сероватый светлокрасный цвет может иметь H, близкий к 0 (350-359 или 0-10), S приблизительно равный 50-100, а V=255.
Для бесцветных цветов (серых) Qt возвращает значение оттенка, равное -1. Если Вы передаете значение слишком большое значение оттенка, Qt приводит его к значению, соответствующему диапазону. Насыщенность, равная 360 или 720, толкуется как 0; насыщенность, равная 540, толкуется как 180.
См. также QPalette и QApplication::setColorSpec().
Определяет цветовую модель: RGB, HSV или CMYK.
Константа | Значение |
---|---|
QColor::Rgb | 1 |
QColor::Hsv | 2 |
QColor::Cmyk | 3 |
QColor::Invalid | 0 |
Создает цвет с недействительным значением RGB (0, 0, 0). Недействительный цвет - цвет, не имеющий дожного представления в основной оконной системе.
Альфа-значение недействительного цвета не задано.
См. также isValid().
Создает цвет со значениями RGB-компонентов r, g, b, и значением альфа-компонента (прозрачности), равном a; другой способ задания цвета: setRgb().
Цвет становится недействительным, если какой-либо из его компонентов недействителен.
См. также setRgba().
Создает цвет со значением color. Альфа-компонент игнорируется и устанавливается в непрозачный.
См. также fromRgb().
Создает именованный цвет, подобно setNamedColor(), используя name.
Цвет становится недействительным, если name не распознано.
См. также setNamedColor().
Создает именованный цвет, подобно setNamedColor(), используя name.
Цвет становится недействительным, если name не распознано.
См. также setNamedColor().
Создает цвет, являющийся копией color.
Создает новый цвет со значением color.
Возвращает альфа-компонент данного цвета.
См. также setAlpha(), alphaF(), red(), green() и blue().
Возвращает альфа-компонент данного цвета.
См. также setAlphaF(), alpha(), redF(), greenF() и blueF().
Возвращает черный компонент данного цвета.
См. также blackF(), cyan(), magenta(), yellow(), and alpha().
Возвращает черный компонент данного цвета.
См. также black(), cyanF(), magentaF(), yellowF() и alphaF().
Возвращает синий компонент данного цвета.
См. также setBlue(), blueF(), red(), green() и alpha().
Возвращает синий компонент данного цвета.
См. также setBlueF(), blue(), redF(), greenF() и alphaF().
Возвращает QStringList, содержащий знакомые Qt имена цветов.
Конвертирует цвет в формат, заданный с помощью colorSpec.
Возвращает голубой компонент цвета.
См. также cyanF(), black(), magenta(), yellow() и alpha().
Возвращает голубой компонент цвета.
См. также cyan(), blackF(), magentaF(), yellowF() и alphaF().
Возвращает более темный (или более светлый) цвет, чем данный, не изменяя данного цвета.
Возвращает более темный цвет, если factor больше, чем 100. Если factor равно 300, то возвращается цвет, с яркостью, равной одной третьей яркости текущего цвета.
Возвращает более светлый цвет, если factor меньше, чем 100. Для этой цели Мы рекомендуем использовать light(). Если factor равен 0 или отрицателен, то возвращаемое значение неопределено.
(Данная функция конвертирует текущий цвет в модели RGB в модель HSV, делит V на factor и конвертирует обратно в модель RGB.)
См. также light().
Статическая вспомогательная функция, которая возвращает QColor, созданный из цвета в модели CMYK, с компонентами c (голубой), m (пурпурный), y (желтый), k (черный) и a (альфа-канал, т.е. прозрачность).
Все значения должны находиться в диапазоне 0-255.
См. также toCmyk(), fromHsv() и fromRgb().
Это статическая функция для удобства, которая возвращает QColor, созданный из цвета в модели CMYK, с компонентами c (голубой), m (пурпурный), y (желтый), k (черный) и a (альфа-канал, т.е. прозрачность).
Все значения должны находиться в диапазоне 0.0-1.0.
См. также toCmyk(), fromHsv() и fromRgb().
Это статическая функция для удобства, которая возвращает QColor, созданный из цвета в модели HSV, с компонентами h (оттенок), s (насыщенность), v (яркость) и a (альфа-канал, т.е. прозрачность).
Значения s, v и a должны находиться в диапазоне 0-255; значение h должно находиться в диапазоне 0-360.
См. также toHsv(), fromCmyk() и fromRgb().
Это статическая функция для удобства, которая возвращает QColor, созданный из цвета в модели HSV, с компонентами h (оттенок), s (насыщенность), v (яркость) и a (альфа-канал, т.е. прозрачность).
Значения h, s, v и a должны находиться в диапазоне 0.0-1.0.
См. также toHsv(), fromCmyk() и fromRgb().
Создает цвет из argb-значения rgb.
Альфа-компонент значения rgb игнорируется. Для конвертирования из RGBA-значения используется функция fromRgba().
См. также fromRgba().
Данная перегруженная функция-член предоставлена для удобства. Ее поведение аналогично поведению вышеприведенной функции.
Это статическая функция для удобства, которая возвращает QColor, созданный из цвета в модели RGB, с компонентами r (красный), g (зеленый), b (синий) и a (альфа-канал, т.е. прозрачность).
Все значения должны находиться в диапазоне 0-255.
См. также toRgb(), fromCmyk() и fromHsv().
Это статическая функция для удобства, которая возвращает QColor, созданный из цвета в модели RGB, с компонентами r (красный), g (зеленый), b (синий) и a (альфа-канал, т.е. прозрачность).
Все значения должны находиться в диапазоне 0.0-1.0.
См. также toRgb(), fromCmyk() и fromHsv().
Создает цвет из rgba-значения rgba.
См. также fromRgb().
Устанавливает содержимое указателей c, m, y, k и a, в значения голубого, пурпурного, желтого, черного компонентов и альфа-компонента (прозрачности) CMYK-значения.
См. также setCmyk(), getRgb() и getHsv().
Устанавливает содержимое указателей c, m, y, k и a, в значения голубого, пурпурного, желтого, черного компонентов и альфа-компонента (прозрачности) CMYK-значения.
См. также setCmyk(), getRgb() и getHsv().
Возвращает текущее RGB-значение как значение HSV. Содержимое указателей h, s и v устанавливается в значения HSV, а содержимое a устанавливается в значение альфа-канала (прозрачности). Если какой-либо из указателей нулевой, то функция ничего не делает.
Оттенок (в который устанавливается h) принимает значение -1, если цвет нецветной.
Предупреждение: Внутренне цвета хранятся в виде RGB-значение, поэтомуso getHSv() может возвращать значение, слегка отличное от установленного с помощью setHsv().
Возвращает текущее RGB-значение как значение HSV. Содержимое указателей h, s и v устанавливается в значения HSV, а содержимое a устанавливается в значение альфа-канала (прозрачности). Если какой-либо из указателей нулевой, то функция ничего не делает.
Устанавливает содержимое указателей r, g, b и a в значения красного, зеленого, синева компонентов и альфа-компонента (прозрачности) в значения RGB.
См. также rgb(), setRgb() и getHsv().
Устанавливает содержимое указателей r, g, b и a в значения красного, зеленого, синева компонентов и альфа-компонента (прозрачности) в значения RGB.
См. также rgb(), setRgb() и getHsv().
Возвращает зеленую компоненту данного цвета.
См. также setGreen(), greenF(), red(), blue() и alpha().
Возвращает зеленую компоненту данного цвета.
См. также setGreenF(), green(), redF(), blueF() и alphaF().
Возвращает компоненту оттенка данного цвета.
См. также hueF(), saturation(), value() и alpha().
Возвращает компоненту оттенка данного цвета.
См. также hue(), saturationF(), valueF() и alphaF().
Возвращает true, если цвет действителен; в противном случае возвращает false.
Если цвет создан с помощью конструктора по умолчанию, то возвращается false.
Возвращает более светлый (или более темный), чем данный, цвет, не изменяя данный объект.
Возвращается более светлный цвет, если factor больше, чем 100. Если factor равен 150, то возвращается цвет, который на 50% ярче.
Более темный цвет возвращается, если factor меньше, чем 100. Мы рекомендуем для этой цели использовать dark(). Если factor равен 0 или отрицательно, то возвращается неопределенное значение.
(Данная функция конвертирует текущее RGB-значение в HSV, умножает компонент V на factor и конвертирует результат обратно в RGB.)
См. также dark().
Возвращает пурпурный компонент данного цвета.
См. также magentaF(), cyan(), black(), yellow() и alpha().
Возвращает пурпурный компонент данного цвета.
См. также magenta(), cyanF(), blackF(), yellowF() и alphaF().
Возвращает обозначение цвета в формате "#AARRGGBB"; т.е. за символом "#" следуют три двузначных шестнадцатиричных числа.
См. также setNamedColor().
Возвращает красный компонент текущего цвета.
См. также setRed(), redF(), green(), blue() и alpha().
Возвращает красный компонент текущего цвета.
См. также setRedF(), red(), greenF(), blueF() и alphaF().
Возвращается RGB-значение данного цвета. Альфа компонент усекается для совместимости.
Возвращаемое значение QRgb эквивалентно unsigned int.
Для недействительлного цвета значение альфа-компонента возвращаемого цвета неопределено.
См. также setRgb(), getHsv(), qRed(), qBlue(), qGreen() и isValid().
Возвращает RGB-значение данного цвета. Обратите внимание, что в, отличие от rgb(), альфа-компонент не усекается.
Возвращаемое значение QRgb эквивалентно unsigned int.
Для недействительлного цвета значение альфа-компонента возвращаемого цвета неопределено.
См. также setRgb(), setRgba(), getHsv(), qRed(), qBlue(), qGreen() и isValid().
Возвращает значение компонента насыщенности данного цвета.
См. также saturationF(), hue(), value() и alpha().
Возвращает значение компонента насыщенности данного цвета.
См. также saturation(), hueF(), valueF() и alphaF().
Устанавливает значение альфа-компонента в alpha. alpha - это целое значение из диапазона 0-255.
См. также alpha().
Устанавливает значение альфа-компонента в alpha. alpha - это значение из диапазона 0-1.
См. также alphaF().
Устанавливает синий компонент данного цвета в значение blue. Компонент является целым числом из диапазона 0-255.
См. также blue().
Устанавливает синий компонент данного цвета в значение blue. Компонент является числом с плавающей точкой из диапазона 0-1./p>
См. также blueF().
Устанавливает цвет в CMYK-значение, с параметрами: c (голубой), m (пурпурный), y (желтый), k (черный) и a (альфа-канал, т.е. прозрачность).
Все значения должны находиться в диапазоне 0-255.
См. также getCmyk(), setRgb() и setHsv().
Устанавливает цвет в CMYK-значение, с парметрами: c (голубой), m (пурпурный), y (желтый), k (черный) и a (альфа-канал, т.е. прозрачность).
Все значения должны находиться в диапазоне 0.0-1.0.
См. также getCmyk(), setRgb() и setHsv().
Устанавливает зеленый компонент данного цвета в значение green. Компонент является целым числом из диапазона 0-255.
См. также green().
Устанавливает зеленый компонент данного цвета в значение green. Компонент является числом с плавающей точкой из диапазона 0-1.
См. также greenF().
Устанавливает цвет в HSV значение, с параметрами: h (оттенок), s (насыщенность), v (яркость) и a (альфа-канал, т.е. прозрачность).
Если s, v или a не попадают в диапазон от 0 до 255, или h < -1, то цвет не изменяется.
См. также hsv(), getHsv() и setRgb().
Значения h, s, v и a должны находиться в диапазоне 0.0-1.0.
Устанавливает RGB-значение цвета в цвет с именем name, которое может соответствовать одному из следующих форматов:
Цвет принимает недействительное значение, если name не может быть распознано.
Устанавливает красный компонент данного цвета в значение green. Компонент является целым числом из диапазона 0-255.
См. также red().
Устанавливает красный компонент данного цвета в значение green. Компонент является числом с плавающей точкой из диапазона 0-1.
См. также redF().
Устанавливает цвет в RGB-значение с параметрами r, g, b и значение альфа-компонента a. Аргументы r, g, b и a должны находиться в диапазоне от 0 до 255. Если значения параметров будут вне позволенного диапазона, то цвет примет недействительное значение.
Данная перегрузенная функция-член предоставлена для удобства. Ее поведение аналогично поведению вышеприведенной функции.
При установке RGB-значения в rgb, значение альфа-компонента игнорируется.
Тип QRgb эквивалентен типу unsigned int.
Устанавливает компоненты данного цвета в значения r (красный), g (зеленый), b (синий) и a (альфа, прозрачность).
Все значения должны находиться в диапазоне 0.0-1.0.
Устанавливает RGBA-значнение в rgba. В отличие от setRgb(QRgb rgb), данная функция не игнорирует значение альфа-компонента.
Тип QRgb эквивалентен типу unsigned int.
См. также rgba().
Возвращает способ задания цвета.
Возвращает CMYK-значение QColor основанное на данном цвете.
См. также fromCmyk(), toHsv() и toRgb().
Возвращает HSV-значение QColor основанное на данном цвете.
См. также fromHsv(), toCmyk() и toRgb().
Возвращает RGB-значение QColor основанное на данном цвете.
См. также fromRgb(), toCmyk() и toHsv().
Возвращает значение данного цвета.
См. также valueF(), hue(), saturation() и alpha().
Возвращает значение данного цвета.
См. также value(), hueF(), saturationF() и alphaF().
Возвращает желтый компонент данного цвета.
См. также yellowF(), cyan(), magenta(), black() и alpha().
Возвращает желтый компонент данного цвета.
См. также yellow(), cyanF(), magentaF(), blackF() и alphaF().
Возвращает цвет как QVariant.
Возвращает true если данный цвет отличается от RGB-значения цвета color; в противном случае возвращает false.
Делает данный цвет копией цвета color и возвращает ссылку на данный цвет.
Данная перегруженная функция-член предоставлена для удобства. Ее поведение аналогично поведению вышеприведенной функции.
Делает данный цвет копией цвета color и возвращает ссылку на данный цвет.
Возвращает true если данный цвет имеет то-же значение, что и RGB-значение цвета color; в противном случае возвращает false.
Возвращает альфа-компонент RGBA-значения rgba.
Возвращает синий компонент RGBA-значения RGBA rgb.
См. также qRgb() и QColor::blue().
Возвращает значение серого цвета (от 0 до 255), вычисленной по тройке (r, g, b).
Возвращает серый цвет вычисленный по формуле (r*11 + g*16 + b*5)/32.
Данная перегруженная функция-член предоставлена для удобства. Ее поведение аналогично поведению вышеприведенной функции.
Возвращает серый цвет (от 0 до 255) из RGB-значения rgb.
Возвращает зеленый компонент из RGBA-значения rgb.
См. также qRgb() и QColor::green().
Возвращает красный компонент из RGBA-значения rgb.
См. также qRgb() и QColor::red().
Возвращает RGB-значение из тройки параметров (r, g, b).
Возвращаемый тип QRgb эквивалентен типу unsigned int.
См. также qRgba(), qRed(), qGreen() и qBlue().
Возвращает RGBA-значение из четверки параметров (r, g, b, a).
Возвращаемый тип QRgba эквивалентен типу unsigned int.
См. также qRgb(), qRed(), qGreen() и qBlue().
Записывает цвет color в поток stream.
См. также Формат операторов QDataStream.
Читает цвет color из потока stream.
См. также Формат операторов QDataStream.
Copyright © 2005 Trolltech | Trademarks | Qt 4.1.0 |