QColor Class
QColor 클래스는 RGB, HSV 또는 CMYK 값을 기반으로 색상을 제공합니다. 더 보기...
| 헤더: | #include <QColor> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
- 상속된 멤버를 포함한 모든 멤버 목록
- 사용 중단된 멤버
- QColor는 페인팅 클래스의 일부입니다.
공개 유형
| enum | NameFormat { HexRgb, HexArgb } |
| enum | Spec { Rgb, Hsv, Cmyk, Hsl, ExtendedRgb, Invalid } |
공개 함수
| QColor() | |
| QColor(QRgb color) | |
| QColor(QRgba64 rgba64) | |
| QColor(const QString &name) | |
| QColor(int r, int g, int b, int a = 255) | |
| QColor(QLatin1StringView name) | |
| QColor(Qt::GlobalColor color) | |
| QColor(const char *name) | |
| int | alpha() const |
| float | alphaF() const |
| int | black() const |
| float | blackF() const |
| int | blue() const |
| float | blueF() const |
| QColor | convertTo(QColor::Spec colorSpec) const |
| int | cyan() const |
| float | cyanF() const |
| QColor | darker(int factor = 200) const |
| void | getCmyk(int *c, int *m, int *y, int *k, int *a = nullptr) const |
| void | getCmykF(float *c, float *m, float *y, float *k, float *a = nullptr) const |
| void | getHsl(int *h, int *s, int *l, int *a = nullptr) const |
| void | getHslF(float *h, float *s, float *l, float *a = nullptr) const |
| void | getHsv(int *h, int *s, int *v, int *a = nullptr) const |
| void | getHsvF(float *h, float *s, float *v, float *a = nullptr) const |
| void | getRgb(int *r, int *g, int *b, int *a = nullptr) const |
| void | getRgbF(float *r, float *g, float *b, float *a = nullptr) const |
| int | green() const |
| float | greenF() const |
| int | hslHue() const |
| float | hslHueF() const |
| int | hslSaturation() const |
| float | hslSaturationF() const |
| int | hsvHue() const |
| float | hsvHueF() const |
| int | hsvSaturation() const |
| float | hsvSaturationF() const |
| int | hue() const |
| float | hueF() const |
| bool | isValid() const |
| QColor | lighter(int factor = 150) const |
| int | lightness() const |
| float | lightnessF() const |
| int | magenta() const |
| float | magentaF() const |
| QString | name(QColor::NameFormat format = HexRgb) const |
| int | red() const |
| float | redF() const |
| QRgb | rgb() const |
| QRgba64 | rgba64() const |
| QRgb | rgba() const |
| int | saturation() const |
| float | saturationF() const |
| void | setAlpha(int alpha) |
| void | setAlphaF(float alpha) |
| void | setBlue(int blue) |
| void | setBlueF(float blue) |
| void | setCmyk(int c, int m, int y, int k, int a = 255) |
| void | setCmykF(float c, float m, float y, float k, float a = 1.0) |
| void | setGreen(int green) |
| void | setGreenF(float green) |
| void | setHsl(int h, int s, int l, int a = 255) |
| void | setHslF(float h, float s, float l, float a = 1.0) |
| void | setHsv(int h, int s, int v, int a = 255) |
| void | setHsvF(float h, float s, float v, float a = 1.0) |
| void | setRed(int red) |
| void | setRedF(float red) |
| void | setRgb(int r, int g, int b, int a = 255) |
| void | setRgb(QRgb rgb) |
| void | setRgba64(QRgba64 rgba) |
| void | setRgbF(float r, float g, float b, float a = 1.0) |
| void | setRgba(QRgb rgba) |
| QColor::Spec | spec() const |
| QColor | toCmyk() const |
| QColor | toExtendedRgb() const |
| QColor | toHsl() const |
| QColor | toHsv() const |
| QColor | toRgb() const |
| int | value() const |
| float | valueF() const |
| int | yellow() const |
| float | yellowF() const |
| operator QVariant() const | |
| bool | operator!=(const QColor &color) const |
| QColor & | operator=(Qt::GlobalColor color) |
| bool | operator==(const QColor &color) const |
정적 공용 멤버
| QStringList | colorNames() |
| QColor | fromCmyk(int c, int m, int y, int k, int a = 255) |
| QColor | fromCmykF(float c, float m, float y, float k, float a = 1.0) |
| QColor | fromHsl(int h, int s, int l, int a = 255) |
| QColor | fromHslF(float h, float s, float l, float a = 1.0) |
| QColor | fromHsv(int h, int s, int v, int a = 255) |
| QColor | fromHsvF(float h, float s, float v, float a = 1.0) |
| QColor | fromRgb(QRgb rgb) |
| QColor | fromRgb(int r, int g, int b, int a = 255) |
| QColor | fromRgba64(QRgba64 rgba64) |
| QColor | fromRgba64(ushort r, ushort g, ushort b, ushort a = USHRT_MAX) |
| QColor | fromRgbF(float r, float g, float b, float a = 1.0) |
| QColor | fromRgba(QRgb rgba) |
(since 6.4) QColor | fromString(QAnyStringView name) |
(since 6.4) bool | isValidColorName(QAnyStringView name) |
관련 비멤버
| QRgb | |
| int | qAlpha(QRgb rgba) |
| uint | qAlpha(QRgba64 rgba64) |
| int | qBlue(QRgb rgb) |
| uint | qBlue(QRgba64 rgba64) |
| int | qGray(int r, int g, int b) |
| int | qGray(QRgb rgb) |
| int | qGreen(QRgb rgb) |
| uint | qGreen(QRgba64 rgba64) |
| QRgb | qPremultiply(QRgb rgb) |
| QRgba64 | qPremultiply(QRgba64 rgba64) |
| int | qRed(QRgb rgb) |
| uint | qRed(QRgba64 rgba64) |
| QRgb | qRgb(int r, int g, int b) |
| QRgba64 | qRgba64(quint64 c) |
| QRgba64 | qRgba64(quint16 r, quint16 g, quint16 b, quint16 a) |
| QRgb | qRgba(int r, int g, int b, int a) |
| QRgb | qUnpremultiply(QRgb rgb) |
| QRgba64 | qUnpremultiply(QRgba64 rgba64) |
| QDataStream & | operator<<(QDataStream &stream, const QColor &color) |
| QDataStream & | operator>>(QDataStream &stream, QColor &color) |
상세 설명
색상은 일반적으로 RGB(빨강, 녹색, 파랑) 성분으로 지정되지만, HSV(색조, 채도, 명도) 및 CMYK(시안, 마젠타, 노랑, 검정) 성분으로도 지정할 수 있습니다. 또한 색상 이름을 사용하여 색상을 지정할 수도 있습니다. 색상 이름은 SVG 1.0 색상 이름 중 아무 것이나 사용할 수 있습니다.
| RGB | HSV | CMYK |
|---|---|---|
![]() | ![]() | ![]() |
QColor 생성자는 RGB 값을 기반으로 색상을 생성합니다. HSV 또는 CMYK 값을 기반으로 QColor를 생성하려면 각각 toHsv() 및 toCmyk() 함수를 사용하십시오. 이 함수들은 원하는 형식을 사용하는 색상의 복사본을 반환합니다. 또한 정적 함수인 fromRgb(), fromHsv() 및 fromCmyk()는 지정된 값을 사용하여 색상을 생성합니다. 또는 convertTo() 함수(원하는 형식의 색상 복사본을 반환)나, setRgb(), setHsv(), setCmyk() 함수 중 하나를 사용하여 색상의 형식을 변경함으로써 색상을 세 가지 형식 중 하나로 변환할 수 있습니다. spec() 함수는 색상이 어떻게 지정되었는지를 알려줍니다.
색상은 RGB 문자열(예: "#112233"), ARGB 문자열(예: "#ff112233") 또는 색상 이름(예: "blue")을 fromString() 함수에 전달하여 설정할 수 있습니다. 색상 이름은 SVG 1.0 색상 이름에서 가져옵니다. ` name()` 함수는 "#RRGGBB" 형식의 색상 이름을 반환합니다. 색상은 ` setRgb()`, ` setHsv()` 및 ` setCmyk()`을 사용하여 설정할 수도 있습니다. 더 밝은 색상이나 더 어두운 색상을 얻으려면 각각 ` lighter()` 및 ` darker()` 함수를 사용하십시오.
isValid() 함수는 QColor가 유효한지 여부를 나타냅니다. 예를 들어, RGB 값이 허용 범위를 벗어난 RGB 색상은 유효하지 않습니다. 성능상의 이유로 QColor는 대부분 유효하지 않은 색상을 무시하며, 그로 인해 유효하지 않은 색상을 사용했을 때의 결과는 정의되지 않습니다.
색상 구성 요소는 red(), hue(), cyan() 등을 통해 개별적으로 가져올 수 있습니다. 또한 getRgb(), getHsv(), getCmyk() 함수를 사용하여 색상 구성 요소의 값을 한 번에 가져올 수도 있습니다. RGB 색상 모델을 사용할 경우, rgb()을 통해 색상 구성 요소에 추가로 접근할 수 있습니다.
이와 관련된 비회원 항목이 몇 가지 있습니다. ` QRgb `는 RGB 값 3원색(r, g, b)을 나타내는 부호 없는 정수(unsigned int)에 대한 typedef입니다. 이 값은 알파 채널의 값도 포함할 수 있다는 점에 유의하십시오(자세한 내용은 ‘ Alpha-Blended Drawing ’ 섹션을 참조하십시오). qRed(), qBlue() 및 qGreen() 함수는 주어진 QRgb 값의 각 성분을 반환하는 반면, qRgb() 및 qRgba() 함수는 주어진 성분 값을 기반으로 QRgb 3원색 값을 생성하여 반환합니다. 마지막으로, qAlpha() 함수는 제공된 QRgb 의 알파 성분을 반환하며, qGray() 함수는 주어진 값을 기반으로 회색값을 계산하여 반환합니다.
QColor는 플랫폼 및 기기에 구애받지 않습니다.
일반적인 페인팅에 대한 자세한 내용은 페인트 시스템 문서를 참조하십시오.
정수 대 부동 소수점 정밀도
QColor는 부동 소수점 정밀도를 지원하며, 모든 색상 구성 요소 함수(예: getRgbF(), hueF() 및 fromCmykF())의 부동 소수점 버전을 제공합니다. 구성 요소는 16비트 정수로 저장되므로, 예를 들어 ` setRgbF()`를 사용하여 설정한 값과 ` getRgbF()` 함수가 반환하는 값 사이에는 반올림으로 인해 사소한 차이가 발생할 수 있습니다.
정수 기반 함수는 0~255 범위의 값을 취하는 반면(단, hue()은 0~359 범위의 값이어야 함), 부동 소수점 함수는 0.0~1.0 범위의 값을 허용합니다.
알파 블렌딩을 이용한 그리기
QColor는 알파 블렌딩을 적용한 윤곽선 그리기 및 채우기 기능도 지원합니다. 색상의 알파 채널은 투명도 효과를 지정하며, 0은 완전히 투명한 색상을, 255는 완전히 불투명한 색상을 나타냅니다. 예를 들어:
// Specify semi-transparent red
painter.setBrush(QColor(255, 0, 0, 127));
painter.drawRect(0, 0, width() / 2, height());
// Specify semi-transparent blue
painter.setBrush(QColor(0, 0, 255, 127));
painter.drawRect(0, 0, width(), height() / 2);위의 코드는 다음과 같은 출력을 생성합니다:

색상의 알파 채널은 값이 정수일 경우 ` alpha()` 및 ` setAlpha()` 함수를 사용하여 가져오고 설정할 수 있으며, 값이 부동 소수점일 경우 ` alphaF()` 및 ` setAlphaF()` 함수를 사용합니다. 기본적으로 알파 채널은 255(불투명)로 설정됩니다. 알파 채널을 포함한 모든 RGB 색상 구성 요소를 한 번에 가져오거나 설정하려면 rgba() 및 setRgba() 함수를 사용하십시오.
사전 정의된 색상
QColorConstants 네임스페이스에는 검은색, 흰색, 기본색 및 보조색, 이 색상들의 어두운 버전, 그리고 세 가지 회색 음영을 포함하여 20개의 사전 정의된 QColor 객체가 있습니다. 또한, QColorConstants::Svg 네임스페이스에서는 표준 SVG 색상 키워드 이름에 해당하는 QColor 객체를 정의합니다.

QColorConstants::Color0, QColorConstants::Color1 및 QColorConstants::Transparent 색상은 특수한 용도로 사용됩니다.
QColorConstants::Color0 (픽셀 값 0)과 QColorConstants::Color1 (픽셀 값 0이 아님)은 QBitmap에서 그리기 위한 특수 색상입니다. QColorConstants::Color0 로 그리면 비트맵 비트가 0(투명, 즉 배경)으로 설정되고, c{QColorConstants::Color1}로 그리면 비트가 1(불투명, 즉 전경)로 설정됩니다.
QColorConstants::Transparent 은 투명한 픽셀을 나타내는 데 사용됩니다. 이 값으로 그리면 사용 중인 기본 픽셀 형식에 적합한 픽셀 값이 사용됩니다.
역사적인 이유로, Qt::GlobalColor 열거형에서도 20개의 미리 정의된 색상을 사용할 수 있습니다.
마지막으로, QColor는 다양한 색상 이름(문자열)을 인식하며, 정적 함수 colorNames()는 QColor가 인식하는 색상 이름의 QStringList 을 반환합니다.
확장 RGB 색상 모델
scRGB 색상 공간이라고도 하는 확장 RGB 색상 모델은 0.0 미만이거나 1.0을 초과하는 값을 허용한다는 점을 제외하면 RGB 색상 모델과 동일합니다. 이를 통해 RGB 색상 공간의 범위를 벗어날 수 있는 색상을 표현할 수 있지만, RGB 색상 공간 내의 색상에는 여전히 동일한 값을 사용할 수 있습니다.
HSV 색상 모델
RGB 모델은 하드웨어 중심입니다. 이 모델의 표현 방식은 대부분의 모니터가 보여주는 색상과 유사합니다. 반면, HSV는 인간의 색 지각에 더 적합한 방식으로 색을 표현합니다. 예를 들어, “~보다 더 강하다”, “~보다 어둡다”, “~의 반대”와 같은 관계는 HSV에서는 쉽게 표현할 수 있지만, RGB에서는 표현하기가 훨씬 어렵습니다.
HSV는 RGB와 마찬가지로 세 가지 구성 요소를 갖습니다:
- H는 색상(hue)을 나타내며, 색상이 채도가 있는 색(회색이 아닌 경우)일 때는 0에서 359 사이의 값을 가지며, 회색일 때는 의미가 없습니다. 이는 대부분의 사람들에게 친숙한 색상환상의 각도를 나타냅니다. 빨간색은 0도, 녹색은 120도, 파란색은 240도입니다.

- 채도(S)는 0에서 255 사이의 범위를 가지며, 수치가 클수록 색상이 더 강해집니다. 회색빛이 도는 색상은 채도가 0에 가깝고, 매우 선명한 색상은 채도가 255에 가깝습니다.

- V는 명도(value)를 나타내며, 0에서 255 사이의 값을 가집니다. 이 값은 색의 명도나 밝기를 나타냅니다. 0은 검은색이며, 255는 검은색에서 최대한 멀리 떨어진 색을 의미합니다.

다음은 몇 가지 예시입니다. 순수한 빨간색은 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는 무채색의 경우 색상(hue) 값으로 -1을 반환합니다. 너무 큰 색상 값을 전달하면 Qt는 이를 허용 범위로 강제 조정합니다. 색상 360이나 720은 0으로, 색상 540은 180으로 처리됩니다.
표준 HSV 모델 외에도, Qt는 알파 채널을 제공하여 alpha-blended drawing 기능을 지원합니다.
HSL 색상 모델
HSL은 HSV와 유사하지만, Value 매개변수 대신 HSL은 색상의 밝기와 다소 다르게 매핑되는 Lightness 매개변수를 지정합니다.
마찬가지로, 동일한 색상에 대해 HSL 채도 값은 일반적으로 HSV 채도 값과 동일하지 않습니다. hslSaturation()는 색상의 HSL 채도 값을 반환하는 반면, saturation() 및 hsvSaturation()는 HSV 채도 값을 반환합니다.
색상(hue) 값은 HSL과 HSV에서 동일하게 정의됩니다.
CMYK 색상 모델
RGB 및 HSV 색상 모델은 컴퓨터 모니터에 표시하는 데 사용되는 반면, CMYK 모델은 인쇄기 및 일부 하드카피 장치의 4색 인쇄 공정에 사용됩니다.
CMYK는 0~255 범위의 네 가지 구성 요소, 즉 시안(C), 마젠타(M), 노랑(Y) 및 검정(K)으로 이루어져 있습니다. 시안, 마젠타, 노랑은 감산 색상이라고 불리며, CMYK 색상 모델은 흰색 표면을 기본으로 하여 적절한 구성 요소를 적용해 색상을 감산함으로써 색상을 생성합니다. 시안, 마젠타, 노랑을 혼합하면 검은색이 되지만, 이 중 하나 이상을 빼면 다른 모든 색상을 얻을 수 있습니다. 이 세 가지 색상을 다양한 비율로 혼합하면 모든 색상 스펙트럼을 만들어낼 수 있습니다.
시안, 마젠타, 노랑을 100%씩 혼합하면 검은색이 만들어지기는 하지만, 잉크가 낭비되고 건조 시간이 길어지며 인쇄 시 색이 탁해지기 때문에 결과는 만족스럽지 못합니다. 이러한 이유로 전문 인쇄에서는 선명한 검은색 톤을 내기 위해 검은색을 추가하며, 이를 ‘4색 인쇄법’이라고 합니다.
표준 CMYK 모델 외에도 Qt는 투명도( alpha-blended drawing) 기능을 지원하기 위해 알파 채널을 제공합니다.
QPalette, QBrush 및 QColorConstants도 참조하십시오 .
멤버 유형 문서
enum QColor::NameFormat
name() 함수의 출력 형식을 지정하는 방법
| 상수 | 값 | 설명 |
|---|---|---|
QColor::HexRgb | 0 | #RRGGBB "#" 문자에 이어 세 자리의 2자리 16진수 숫자가 나옵니다(예: #RRGGBB). |
QColor::HexArgb | 1 | #AARRGGBB "#" 문자에 이어 4개의 두 자리 16진수 숫자가 오는 형식입니다(예: #AARRGGBB). |
name()도 참조하십시오 .
enum QColor::Spec
지정된 색상 유형(RGB, 확장 RGB, HSV, CMYK 또는 HSL).
| 상수 | 값 |
|---|---|
QColor::Rgb | 1 |
QColor::Hsv | 2 |
QColor::Cmyk | 3 |
QColor::Hsl | 4 |
QColor::ExtendedRgb | 5 |
QColor::Invalid | 0 |
멤버 함수 설명서
[constexpr noexcept] QColor::QColor()
RGB 값 (0, 0, 0)을 사용하여 유효하지 않은 색상을 생성합니다. 유효하지 않은 색상이란 기본 윈도우 시스템에 대해 올바르게 설정되지 않은 색상을 말합니다.
무효 색상의 알파 값은 정의되지 않습니다.
isValid()도 참조하십시오 .
[noexcept] QColor::QColor(QRgb color)
color 값을 가진 색상을 생성합니다. 알파 성분은 무시되고 불투명하게 설정됩니다.
fromRgb() 및 isValid()도 참조하십시오 .
[noexcept] QColor::QColor(QRgba64 rgba64)
rgba64 값을 가진 색상을 생성합니다.
fromRgba64()도 참조하십시오 .
QColor::QColor(const QString &name)
지정된 ` name`을 사용하여 ` fromString()`와 동일한 방식으로 이름이 지정된 색상을 생성합니다.
name 을 파싱할 수 없는 경우, 해당 색상은 유효하지 않은 상태로 남습니다.
fromString(), name() 및 isValid()도 참조하십시오 .
[constexpr noexcept] QColor::QColor(int r, int g, int b, int a = 255)
RGB 값 r, g, b 및 알파 채널(투명도) 값 a 을 사용하여 색상을 생성합니다.
인수 중 하나라도 유효하지 않은 경우, 해당 색상은 무효로 처리됩니다.
setRgba() 및 isValid()도 참조하십시오 .
QColor::QColor(QLatin1StringView name)
주어진 ` name`를 사용하여 ` fromString()`와 동일한 방식으로 이름이 지정된 색상을 생성합니다.
이 함수는 오버로드된 함수입니다.
fromString(), name() 및 isValid()도 참조하십시오 .
[noexcept] QColor::QColor(Qt::GlobalColor color)
color 의 색상 값을 가진 새로운 색상을 생성합니다.
이 함수는 오버로드된 함수입니다.
isValid() 및 Predefined Colors도 참조하십시오 .
QColor::QColor(const char *name)
주어진 ` name`를 사용하여 ` fromString()`와 동일한 방식으로 이름이 지정된 색상을 생성합니다.
이 함수는 오버로드된 함수입니다.
fromString(), name() 및 isValid()도 참조하십시오 .
[noexcept] int QColor::alpha() const
이 색상의 알파 색상 성분을 반환합니다.
setAlpha(), alphaF() 및 Alpha-Blended Drawing도 참조하십시오 .
[noexcept] float QColor::alphaF() const
이 색상의 알파 색상 성분을 반환합니다.
setAlphaF(), alpha() 및 Alpha-Blended Drawing도 참조하십시오 .
[noexcept] int QColor::black() const
이 색상의 검은색 성분을 반환합니다.
blackF(), getCmyk() 및 The CMYK Color Model도 참조하십시오 .
[noexcept] float QColor::blackF() const
이 색상의 검은색 색상 성분을 반환합니다.
black(), getCmykF(), The CMYK Color Model도 참조하십시오 .
[noexcept] int QColor::blue() const
이 색상의 파란색 색상 성분을 반환합니다.
setBlue(), blueF(), getRgb()도 참조하십시오 .
[noexcept] float QColor::blueF() const
이 색상의 파란색 색상 성분을 반환합니다.
setBlueF(), blue(), getRgbF()도 참조하십시오 .
[static] QStringList QColor::colorNames()
Qt가 인식하는 색상 이름이 포함된 ` QStringList ` 객체를 반환합니다.
Predefined Colors도 참조하십시오 .
[noexcept] QColor QColor::convertTo(QColor::Spec colorSpec) const
colorSpec 에서 지정한 형식으로 이 색상의 복사본을 생성합니다.
spec(), toCmyk(), toHsv(), toRgb() 및 isValid()도 참조하십시오 .
[noexcept] int QColor::cyan() const
이 색상의 청록색 색상 성분을 반환합니다.
cyanF(), getCmyk() 및 The CMYK Color Model도 참조하십시오 .
[noexcept] float QColor::cyanF() const
이 색상의 청록색 색상 성분을 반환합니다.
cyan(), getCmykF() 및 The CMYK Color Model도 참조하십시오 .
[noexcept] QColor QColor::darker(int factor = 200) const
더 어두운(또는 더 밝은) 색상을 반환하지만, 이 객체 자체는 변경하지 않습니다.
factor 의 값이 100보다 크면, 이 함수는 더 어두운 색상을 반환합니다. factor 를 300으로 설정하면 밝기가 3분의 1인 색상을 반환합니다. factor 가 100보다 작으면 반환되는 색상은 더 밝아지지만, 이러한 목적으로는 lighter() 함수를 사용하는 것이 좋습니다. factor 가 0이거나 음수인 경우, 반환 값은 정의되지 않습니다.
이 함수는 현재 색상을 HSV로 변환한 후, V 성분의 값을 factor 로 나누어 다시 원래의 색상 사양으로 변환합니다.
lighter() 및 isValid()함수도 참조하십시오 .
[static] QColor QColor::fromCmyk(int c, int m, int y, int k, int a = 255)
주어진 CMYK 색상 값( c (시안), m (마젠타), y (노랑), k (검정), a (알파 채널, 즉 투명도))을 바탕으로 생성된 ` QColor ` 객체를 반환하는 정적 편의 함수입니다.
모든 값은 0~255 범위 내에 있어야 합니다.
toCmyk(), fromCmykF(), isValid(), The CMYK Color Model도 참조하십시오 .
[static] QColor QColor::fromCmykF(float c, float m, float y, float k, float a = 1.0)
주어진 CMYK 색상 값( c (시안), m (마젠타), y (노랑), k (검정), a (알파 채널, 즉 투명도))을 바탕으로 생성된 ` QColor ` 객체를 반환하는 정적 편의 함수입니다.
모든 값은 0.0~1.0 범위 내에 있어야 합니다.
toCmyk(), fromCmyk(), isValid() 및 The CMYK Color Model도 참조하십시오 .
[static] QColor QColor::fromHsl(int h, int s, int l, int a = 255)
HSV 색상 값인 h (색조), s (채도), l (명도), a (알파 채널, 즉 투명도)로 구성된 ` QColor ` 객체를 반환하는 정적 편의 함수입니다.
s, l 및 a 의 값은 모두 0~255 범위 내에 있어야 하며, h 의 값은 0~359 범위 내에 있어야 합니다.
toHsl(), fromHslF(), isValid(), The HSL Color Model도 참조하십시오 .
[static] QColor QColor::fromHslF(float h, float s, float l, float a = 1.0)
HSV 색상 값인 h (색조), s (채도), l (명도), a (알파 채널, 즉 투명도)를 기반으로 생성된 QColor 객체를 반환하는 정적 편의 함수입니다.
모든 값은 0.0~1.0 범위 내에 있어야 합니다.
toHsl(), fromHsl(), isValid(), The HSL Color Model도 참조하십시오 .
[static] QColor QColor::fromHsv(int h, int s, int v, int a = 255)
HSV 색상 값인 h (색조), s (채도), v (명도), a (알파 채널, 즉 투명도)로 구성된 QColor 객체를 반환하는 정적 편의 함수입니다.
s, v 및 a 의 값은 모두 0~255 범위 내에 있어야 하며, h 의 값은 0~359 범위 내에 있어야 합니다.
toHsv(), fromHsvF(), isValid(), The HSV Color Model도 참조하십시오 .
[static] QColor QColor::fromHsvF(float h, float s, float v, float a = 1.0)
HSV 색상 값인 h (색조), s (채도), v (명도), a (알파 채널, 즉 투명도)로 구성된 ` QColor ` 객체를 반환하는 정적 편의 함수입니다.
모든 값은 0.0~1.0 범위 내에 있어야 합니다.
toHsv(), fromHsv(), isValid(), The HSV Color Model도 참조하십시오 .
[static noexcept] QColor QColor::fromRgb(QRgb rgb)
주어진 QRgb 값 rgb 로 구성된 QColor 를 반환하는 정적 편의 함수입니다.
rgb 의 알파 성분은 무시됩니다(즉, 자동으로 255로 설정됨). 주어진 QRgb 값으로 지정된 알파 채널을 포함하려면 fromRgba() 함수를 사용하십시오.
fromRgba(), fromRgbF(), toRgb() 및 isValid()도 참조하십시오 .
[static] QColor QColor::fromRgb(int r, int g, int b, int a = 255)
RGB 색상 값인 r (빨강), g (초록), b (파랑), a (알파 채널, 즉 투명도)로 구성된 ` QColor ` 객체를 반환하는 정적 편의 함수입니다.
모든 값은 0~255 범위 내에 있어야 합니다.
toRgb(), fromRgba64(), fromRgbF(), isValid()도 참조하십시오 .
[static noexcept] QColor QColor::fromRgba64(QRgba64 rgba64)
주어진 QRgba64 값 rgba64 로 구성된 QColor 를 반환하는 정적 편의 함수입니다.
fromRgb(), fromRgbF(), toRgb(), isValid()도 참조하십시오 .
[static noexcept] QColor QColor::fromRgba64(ushort r, ushort g, ushort b, ushort a = USHRT_MAX)
RGBA64 색상 값인 r (빨강), g (초록), b (파랑), a (알파 채널, 즉 투명도)로 구성된 ` QColor ` 객체를 반환하는 정적 편의 함수입니다.
fromRgb(), fromRgbF(), toRgb(), isValid()도 참조하십시오 .
[static] QColor QColor::fromRgbF(float r, float g, float b, float a = 1.0)
RGB 색상 값인 r (빨강), g (초록), b (파랑), a (알파 채널, 즉 투명도)로 구성된 ` QColor `를 반환하는 정적 편의 함수입니다.
알파 값은 0.0~1.0 범위 내에 있어야 합니다. 다른 값 중 하나라도 0.0~1.0 범위를 벗어나면 색상 모델은 ExtendedRgb 로 설정됩니다.
fromRgb(), fromRgba64(), toRgb(), isValid()도 참조하십시오 .
[static noexcept] QColor QColor::fromRgba(QRgb rgba)
주어진 QRgb 값 rgba 을 기반으로 생성된 QColor 을 반환하는 정적 편의 함수입니다.
fromRgb() 함수와 달리, 주어진 QRgb 값으로 지정된 알파 채널이 포함됩니다.
fromRgb(), fromRgba64(), isValid()도 참조하십시오 .
[static noexcept, since 6.4] QColor QColor::fromString(QAnyStringView name)
name 에서 파싱된 RGB QColor 를 반환합니다. 해당 값은 다음 형식 중 하나일 수 있습니다:
- #RGB (R, G, B 각각은 1자리 16진수)
- #RRGGBB
- #AARRGGBB (5.2부터)
- #RRRGGGBBB
- #RRRRGGGGBBBB
- World Wide Web Consortium에서 제공하는 SVG 색상 키워드 이름 목록에 정의된 색상 이름; 예를 들어, "steelblue" 또는 "gainsboro". 이러한 색상 이름은 모든 플랫폼에서 작동합니다. 이러한 색상 이름은 Qt::GlobalColor 열거형에서 정의된 것과는 다르다는 점에 유의하십시오. 예를 들어, "green"과 Qt::green 은 같은 색상을 가리키지 않습니다.
transparent- 색상이 없음을 나타냅니다.
name 를 파싱할 수 없는 경우 유효하지 않은 색상을 반환합니다.
이 함수는 Qt 6.4에서 도입되었습니다.
isValidColorName()도 참조하십시오 .
void QColor::getCmyk(int *c, int *m, int *y, int *k, int *a = nullptr) const
c, m, y, k 및 a 가 가리키는 내용을 해당 색상의 CMYK 값 중 시안(cyan), 마젠타(magenta), 노랑(yellow), 검정(black) 및 알파 채널(투명도) 구성 요소로 설정합니다.
이러한 구성 요소는 cyan(), magenta(), yellow(), black() 및 alpha() 함수를 사용하여 개별적으로 가져올 수 있습니다.
setCmyk() 및 The CMYK Color Model도 참조하십시오 .
void QColor::getCmykF(float *c, float *m, float *y, float *k, float *a = nullptr) const
c, m, y, k 및 a 가 가리키는 내용을 색상의 CMYK 값 중 시안, 마젠타, 노랑, 검정 및 알파 채널(투명도) 구성 요소로 설정합니다.
이러한 구성 요소는 cyanF(), magentaF(), yellowF(), blackF() 및 alphaF() 함수를 사용하여 개별적으로 가져올 수 있습니다.
setCmykF() 및 The CMYK Color Model도 참조하십시오 .
void QColor::getHsl(int *h, int *s, int *l, int *a = nullptr) const
h, s, l 및 a 가 가리키는 내용을 색상의 HSL 값 중 색조(hue), 채도(saturation), 명도(lightness) 및 알파 채널(투명도) 성분으로 설정합니다.
이러한 구성 요소는 hslHue(), hslSaturation(), lightness() 및 alpha() 함수를 사용하여 개별적으로 가져올 수 있습니다.
getHslF(), setHsl() 및 The HSL Color Model도 참조하십시오 .
void QColor::getHslF(float *h, float *s, float *l, float *a = nullptr) const
h, s, l 및 a 가 가리키는 내용을 색상의 HSL 값 중 색조(hue), 채도(saturation), 명도(lightness) 및 알파 채널(투명도) 성분으로 설정합니다.
이러한 구성 요소는 hslHueF(), hslSaturationF(), lightnessF() 및 alphaF() 함수를 사용하여 개별적으로 가져올 수 있습니다.
getHsl(), setHslF() 및 The HSL Color Model도 참조하십시오 .
void QColor::getHsv(int *h, int *s, int *v, int *a = nullptr) const
h, s, v 및 a 가 가리키는 내용을 색상의 HSV 값 중 색조(hue), 채도(saturation), 명도(value) 및 알파 채널(투명도) 구성 요소로 설정합니다.
이러한 구성 요소는 hue(), saturation(), value() 및 alpha() 함수를 사용하여 개별적으로 가져올 수 있습니다.
setHsv() 및 The HSV Color Model도 참조하십시오 .
void QColor::getHsvF(float *h, float *s, float *v, float *a = nullptr) const
h, s, v 및 a 가 가리키는 내용을 색상의 HSV 값 중 색조(hue), 채도(saturation), 명도(value) 및 알파 채널(투명도) 성분으로 설정합니다.
이러한 구성 요소는 hueF(), saturationF(), valueF() 및 alphaF() 함수를 사용하여 개별적으로 가져올 수 있습니다.
setHsv() 및 The HSV Color Model도 참조하십시오 .
void QColor::getRgb(int *r, int *g, int *b, int *a = nullptr) const
r, g, b 및 a 가 가리키는 내용을 해당 색상의 RGB 값 중 적색, 녹색, 청색 및 알파 채널(투명도) 성분으로 설정합니다.
이러한 구성 요소는 red(), green(), blue() 및 alpha() 함수를 사용하여 개별적으로 가져올 수 있습니다.
void QColor::getRgbF(float *r, float *g, float *b, float *a = nullptr) const
r, g, b 및 a 가 가리키는 내용을 색상의 RGB 값 중 빨강, 녹색, 파랑 및 알파 채널(투명도) 성분으로 설정합니다.
이러한 구성 요소는 redF(), greenF(), blueF() 및 alphaF() 함수를 사용하여 개별적으로 가져올 수 있습니다.
[noexcept] int QColor::green() const
이 색상의 녹색 색상 성분을 반환합니다.
setGreen(), greenF(), getRgb()도 참조하십시오 .
[noexcept] float QColor::greenF() const
이 색상의 녹색 색상 성분을 반환합니다.
setGreenF(), green(), getRgbF()도 참조하십시오 .
[noexcept] int QColor::hslHue() const
이 색상의 HSL 색조(hue) 색상 성분을 반환합니다.
hslHueF(), hsvHue(), getHsl(), The HSL Color Model도 참조하십시오 .
[noexcept] float QColor::hslHueF() const
이 색상의 HSL 색조(hue) 색상 성분을 반환합니다.
hslHue(), hsvHueF(), getHslF()도 참조하십시오 .
[noexcept] int QColor::hslSaturation() const
이 색상의 HSL 채도 색상 성분을 반환합니다.
hslSaturationF(), hsvSaturation(), getHsl() 및 The HSL Color Model도 참조하십시오 .
[noexcept] float QColor::hslSaturationF() const
이 색상의 HSL 채도 색상 성분을 반환합니다.
hslSaturation(), hsvSaturationF(), getHslF() 및 The HSL Color Model도 참조하십시오 .
[noexcept] int QColor::hsvHue() const
이 색상의 HSV 색조(hue) 색상 성분을 반환합니다.
hueF(), hslHue(), getHsv() 및 The HSV Color Model도 참조하십시오 .
[noexcept] float QColor::hsvHueF() const
이 색상의 색조(hue) 색상 성분을 반환합니다.
hue(), hslHueF(), getHsvF(), The HSV Color Model도 참조하십시오 .
[noexcept] int QColor::hsvSaturation() const
이 색상의 HSV 채도 색상 성분을 반환합니다.
saturationF(), hslSaturation(), getHsv() 및 The HSV Color Model도 참조하십시오 .
[noexcept] float QColor::hsvSaturationF() const
이 색상의 HSV 채도 색상 성분을 반환합니다.
saturation(), hslSaturationF(), getHsvF() 및 The HSV Color Model도 참조하십시오 .
[noexcept] int QColor::hue() const
이 색상의 HSV 색조 색상 성분을 반환합니다.
색상은 암시적으로 HSV로 변환됩니다.
hsvHue(), hslHue(), hueF(), getHsv() 및 The HSV Color Model도 참조하십시오 .
[noexcept] float QColor::hueF() const
이 색상의 HSV 색조 색상 성분을 반환합니다.
색상은 암시적으로 HSV로 변환됩니다.
hsvHueF(), hslHueF(), hue(), getHsvF() 및 The HSV Color Model도 참조하십시오 .
[noexcept] bool QColor::isValid() const
색상이 유효한 경우 ` true `를 반환하고, 그렇지 않은 경우 ` false`를 반환합니다.
[static noexcept, since 6.4] bool QColor::isValidColorName(QAnyStringView name)
name 가 유효한 색상 이름이며, 이를 사용하여 유효한 QColor 객체를 생성할 수 있는 경우 true 를 반환하고, 그렇지 않은 경우 false를 반환합니다.
이 함수는 fromString()에서 사용되는 것과 동일한 알고리즘을 사용합니다.
이 함수는 Qt 6.4에서 도입되었습니다.
fromString()도 참조하십시오 .
[noexcept] QColor QColor::lighter(int factor = 150) const
더 밝은(또는 더 어두운) 색상을 반환하지만, 이 객체 자체는 변경하지 않습니다.
factor 가 100보다 크면, 이 함수는 더 밝은 색상을 반환합니다. factor 를 150으로 설정하면 50% 더 밝은 색상이 반환됩니다. factor 가 100보다 작으면 반환되는 색상은 더 어두워지지만, 이러한 용도로는 darker() 함수를 사용하는 것이 좋습니다. factor 가 0이거나 음수인 경우, 반환 값은 정의되지 않습니다.
이 함수는 현재 색상을 HSV로 변환한 후, V 성분의 값에 factor 를 곱하여 색상을 원래의 색상 사양으로 다시 변환합니다.
darker() 및 isValid()함수도 참조하십시오 .
[noexcept] int QColor::lightness() const
이 색상의 명도 색상 성분을 반환합니다.
lightnessF() 및 getHsl()도 참조하십시오 .
[noexcept] float QColor::lightnessF() const
이 색상의 명도 색상 성분을 반환합니다.
[noexcept] int QColor::magenta() const
이 색상의 마젠타 색상 성분을 반환합니다.
magentaF(), getCmyk() 및 The CMYK Color Model도 참조하십시오 .
[noexcept] float QColor::magentaF() const
이 색상의 마젠타 색상 성분을 반환합니다.
magenta(), getCmykF() 및 The CMYK Color Model도 참조하십시오 .
QString QColor::name(QColor::NameFormat format = HexRgb) const
지정된 format 에 포함된 색상의 이름을 반환합니다.
fromString() 및 NameFormat도 참조하십시오 .
[noexcept] int QColor::red() const
이 색상의 빨간색 색상 성분을 반환합니다.
setRed(), redF(), getRgb()도 참조하십시오 .
[noexcept] float QColor::redF() const
이 색상의 빨간색 색상 성분을 반환합니다.
setRedF(), red(), getRgbF()도 참조하십시오 .
[noexcept] QRgb QColor::rgb() const
색상의 RGB 값을 반환합니다. 알파 값은 불투명합니다.
setRgb(), getRgb(), rgba()도 참조하십시오 .
[noexcept] QRgba64 QColor::rgba64() const
색상의 알파 값을 포함한 RGB64 값을 반환합니다.
유효하지 않은 색상의 경우, 반환된 색상의 알파 값은 정의되지 않습니다.
setRgba64(), rgba() 및 rgb()도 참조하십시오 .
[noexcept] QRgb QColor::rgba() const
색상의 알파 값을 포함한 RGB 값을 반환합니다.
유효하지 않은 색상의 경우, 반환된 색상의 알파 값은 정의되지 않습니다.
setRgba(), rgb(), rgba64()도 참조하십시오 .
[noexcept] int QColor::saturation() const
이 색상의 HSV 채도 성분을 반환합니다.
색상은 암시적으로 HSV로 변환됩니다.
hsvSaturation(), hslSaturation(), saturationF(), getHsv() 및 The HSV Color Model도 참조하십시오 .
[noexcept] float QColor::saturationF() const
이 색상의 HSV 채도 성분을 반환합니다.
색상은 암묵적으로 HSV로 변환됩니다.
hsvSaturationF(), hslSaturationF(), saturation(), getHsvF(), The HSV Color Model도 참조하십시오 .
void QColor::setAlpha(int alpha)
이 색상의 알파 값을 alpha 로 설정합니다. 정수형 알파 값은 0~255 범위 내에서 지정됩니다.
alpha(), alphaF(), Alpha-Blended Drawing도 참조하십시오 .
void QColor::setAlphaF(float alpha)
이 색상의 알파 값을 alpha 로 설정합니다. float alpha는 0.0~1.0 범위 내에서 지정됩니다.
alphaF(), alpha() 및 Alpha-Blended Drawing도 참조하십시오 .
void QColor::setBlue(int blue)
이 색상의 청색 성분을 blue 로 설정합니다. 정수 성분은 0~255 범위 내에서 지정됩니다.
blue(), blueF(), setRgb()도 참조하십시오 .
void QColor::setBlueF(float blue)
이 색상의 파란색 색상 성분을 blue 로 설정합니다. blue 가 0.0~1.0 범위 밖인 경우, 색상 모델이 ExtendedRgb 로 변경됩니다.
blueF(), blue() 및 setRgbF()도 참조하십시오 .
void QColor::setCmyk(int c, int m, int y, int k, int a = 255)
색상을 CMYK 값인 c (시안), m (마젠타), y (노랑), k (검정), a (알파 채널, 즉 투명도)로 설정합니다.
모든 값은 0~255 범위 내에 있어야 합니다.
getCmyk(), setCmykF() 및 The CMYK Color Model도 참조하십시오 .
void QColor::setCmykF(float c, float m, float y, float k, float a = 1.0)
색상을 CMYK 값인 c (시안), m (마젠타), y (노랑), k (검정), a (알파 채널, 즉 투명도)로 설정합니다.
모든 값은 0.0~1.0 범위 내에 있어야 합니다.
getCmykF(), setCmyk() 및 The CMYK Color Model도 참조하십시오 .
void QColor::setGreen(int green)
이 색상의 녹색 색상 성분을 green 로 설정합니다. 정수 성분은 0~255의 범위 내에서 지정됩니다.
green(), greenF() 및 setRgb()도 참조하십시오 .
void QColor::setGreenF(float green)
이 색상의 녹색 색상 성분을 green 로 설정합니다. green 가 0.0~1.0 범위를 벗어날 경우, 색상 모델이 ExtendedRgb 로 변경됩니다.
greenF(), green() 및 setRgbF()도 참조하십시오 .
void QColor::setHsl(int h, int s, int l, int a = 255)
HSL 색상 값을 설정합니다. h 는 색상(hue), s 는 채도(saturation), l 는 명도(lightness), a 는 HSL 색상의 알파(alpha) 성분입니다.
채도, 명도 및 알파 채널 값은 0~255 범위 내에 있어야 하며, 색상 값은 -1보다 커야 합니다.
getHsl() 및 setHslF()도 참조하십시오 .
void QColor::setHslF(float h, float s, float l, float a = 1.0)
HSL 색상의 명도를 설정합니다. h 는 색조(hue), s 는 채도(saturation), l 는 명도(lightness), a 는 HSL 색상의 알파 성분입니다.
모든 값은 0.0~1.0 범위 내에 있어야 합니다.
getHslF() 및 setHsl()도 참조하십시오 .
void QColor::setHsv(int h, int s, int v, int a = 255)
HSV 색상 값을 설정합니다. h 는 색조(hue), s 는 채도(saturation), v 는 명도(value), a 는 HSV 색상의 알파 성분입니다.
채도, 명도 및 알파 채널 값은 0~255 범위 내에 있어야 하며, 색상 값은 -1보다 커야 합니다.
getHsv(), setHsvF() 및 The HSV Color Model도 참조하십시오 .
void QColor::setHsvF(float h, float s, float v, float a = 1.0)
HSV 색상 값을 설정합니다. h 는 색조(hue), s 는 채도(saturation), v 는 명도(value), a 는 HSV 색상의 알파 성분입니다.
모든 값은 0.0~1.0 범위 내에 있어야 합니다.
getHsvF(), setHsv() 및 The HSV Color Model도 참조하십시오 .
void QColor::setRed(int red)
이 색상의 적색 성분을 red 로 설정합니다. 정수 성분은 0~255 범위 내에서 지정됩니다.
red(), redF(), setRgb()도 참조하십시오 .
void QColor::setRedF(float red)
이 색상의 적색 색상 성분을 red 로 설정합니다. red 가 0.0~1.0 범위를 벗어날 경우, 색상 모델이 ExtendedRgb 로 변경됩니다.
redF(), red() 및 setRgbF()도 참조하십시오 .
void QColor::setRgb(int r, int g, int b, int a = 255)
RGB 값을 r, g, b 로, 알파 값을 a 로 설정합니다.
모든 값은 0~255 범위 내에 있어야 합니다.
rgb(), getRgb() 및 setRgbF()도 참조하십시오 .
[noexcept] void QColor::setRgb(QRgb rgb)
RGB 값을 rgb 로 설정합니다. 알파 값은 불투명하게 설정됩니다.
이 함수는 오버로드된 함수입니다.
[noexcept] void QColor::setRgba64(QRgba64 rgba)
RGB64 값을 알파 값을 포함하여 rgba 로 설정합니다.
setRgba() 및 rgba64()도 참조하십시오 .
void QColor::setRgbF(float r, float g, float b, float a = 1.0)
이 색상의 색상 채널을 r (빨강), g (초록), b (파랑), a (알파, 투명도)로 설정합니다.
알파 값은 0.0~1.0 범위 내에 있어야 합니다. 다른 값 중 하나라도 0.0~1.0 범위를 벗어날 경우, 색상 모델은 ExtendedRgb 로 설정됩니다.
rgb(), getRgbF(), setRgb()도 참조하십시오 .
[noexcept] void QColor::setRgba(QRgb rgba)
RGB 값을 알파 값을 포함하여 rgba 로 설정합니다.
rgba(), rgb(), setRgba64()도 참조하십시오 .
[noexcept] QColor::Spec QColor::spec() const
색상이 어떻게 지정되었는지 반환합니다.
[noexcept] QColor QColor::toCmyk() const
이 색상을 기반으로 CMYK QColor 를 생성하여 반환합니다.
fromCmyk(), convertTo(), isValid(), The CMYK Color Model도 참조하십시오 .
[noexcept] QColor QColor::toExtendedRgb() const
이 색상을 기반으로 확장된 RGB QColor 를 생성하여 반환합니다.
[noexcept] QColor QColor::toHsl() const
이 색상을 기반으로 HSL QColor 객체를 생성하여 반환합니다.
fromHsl(), convertTo(), isValid(), The HSL Color Model도 참조하십시오 .
[noexcept] QColor QColor::toHsv() const
이 색상을 기반으로 HSV QColor 를 생성하여 반환합니다.
fromHsv(), convertTo(), isValid(), The HSV Color Model도 참조하십시오 .
[noexcept] QColor QColor::toRgb() const
이 색상을 기반으로 RGB QColor 를 생성하여 반환합니다.
fromRgb(), convertTo() 및 isValid()도 참조하십시오 .
[noexcept] int QColor::value() const
이 색상의 색상 구성 요소 값을 반환합니다.
valueF(), getHsv() 및 The HSV Color Model도 참조하십시오 .
[noexcept] float QColor::valueF() const
이 색상의 색상 구성 요소 값을 반환합니다.
value(), getHsvF() 및 The HSV Color Model도 참조하십시오 .
[noexcept] int QColor::yellow() const
이 색상의 노란색 색상 성분을 반환합니다.
yellowF(), getCmyk() 및 The CMYK Color Model도 참조하십시오 .
[noexcept] float QColor::yellowF() const
이 색상의 노란색 성분을 반환합니다.
yellow(), getCmykF(), The CMYK Color Model도 참조하십시오 .
QColor::operator QVariant() const
색상을 다음과 같은 형식으로 반환합니다. QVariant
[noexcept] bool QColor::operator!=(const QColor &color) const
이 색상의 색상 명세 또는 구성 요소 값이 color 와 다를 경우 true 를 반환하고, 그렇지 않은 경우 false 를 반환합니다.
ExtendedRgb 이 문맥에서는 Rgb 명세들이 일치하는 것으로 간주됩니다.
spec()도 참조하십시오 .
[noexcept] QColor &QColor::operator=(Qt::GlobalColor color)
color 의 복사본을 할당하고, 이 색상에 대한 참조를 반환합니다.
[noexcept] bool QColor::operator==(const QColor &color) const
이 색상이 color 과 동일한 색상 사양 및 구성 요소 값을 갖는 경우 true 를 반환하고, 그렇지 않은 경우 false 를 반환합니다.
ExtendedRgb 이 문맥에서 Rgb 명세들은 일치하는 것으로 간주됩니다.
spec()도 참조하십시오 .
관련 비회원
QRgb
#AARRGGBB 형식의 ARGB 4원색으로, unsigned int와 동일합니다.
이 유형은 알파 채널의 값도 포함합니다. 기본 알파 채널은 ff, 즉 불투명(opaque)입니다. 자세한 내용은 ' Alpha-Blended Drawing ' 섹션을 참조하십시오.
다음은 QRgb 값을 생성하는 방법에 대한 몇 가지 예시입니다:
const QRgb rgb1 = 0x88112233;
const QRgb rgb2 = QColor("red").rgb();
const QRgb rgb3 = qRgb(qRed(rgb1), qGreen(rgb2), qBlue(rgb2));
const QRgb rgb4 = qRgba(qRed(rgb1), qGreen(rgb2), qBlue(rgb2), qAlpha(rgb1));qRgb(), qRgba(), QColor::rgb(), QColor::rgba()도 참조하십시오 .
[constexpr] int qAlpha(QRgb rgba)
ARGB 4원색 rgba 의 알파 성분을 반환합니다.
qRgb() 및 QColor::alpha()도 참조하십시오 .
[constexpr] uint qAlpha(QRgba64 rgba64)
rgba64 의 알파 성분을 8비트 값으로 반환합니다.
QRgba64::alpha8() 및 QColor::alpha()도 참조하십시오 .
[constexpr] int qBlue(QRgb rgb)
ARGB 4원색 rgb 의 청색 성분을 반환합니다.
qRgb() 및 QColor::blue()도 참조하십시오 .
[constexpr] uint qBlue(QRgba64 rgba64)
rgba64 의 청색 성분을 8비트 값으로 반환합니다.
QRgba64::blue8() 및 QColor::blue()도 참조하십시오 .
[constexpr] int qGray(int r, int g, int b)
(r, g, b) 3원조에서 회색값(0~255)을 반환합니다.
회색값은 다음 공식(r * 11 + g * 16 + b * 5)/32을 사용하여 계산됩니다.
[constexpr] int qGray(QRgb rgb)
주어진 ARGB 4원색 튜플 rgb 로부터 그레이 값(0~255)을 반환합니다.
회색값은 (R * 11 + G * 16 + B * 5)/32라는 공식을 사용하여 계산되며, 알파 채널은 무시됩니다.
이 함수는 오버로드된 함수입니다.
[constexpr] int qGreen(QRgb rgb)
ARGB 4원색 rgb 의 녹색 성분을 반환합니다.
qRgb() 및 QColor::green()도 참조하십시오 .
[constexpr] uint qGreen(QRgba64 rgba64)
rgba64 의 녹색 성분을 8비트 값으로 반환합니다.
QRgba64::green8() 및 QColor::green()도 참조하십시오 .
[constexpr] QRgb qPremultiply(QRgb rgb)
전치 곱셈이 적용되지 않은 ARGB 4원 튜플 rgb 을 전치 곱셈이 적용된 ARGB 4원 튜플로 변환합니다.
qUnpremultiply()도 참조하십시오 .
[constexpr] QRgba64 qPremultiply(QRgba64 rgba64)
전치 곱이 적용되지 않은 QRgba64 4원조 rgba64 를 전치 곱이 적용된 QRgba64 4원조로 변환합니다.
QRgba64::premultiplied() 및 qUnpremultiply()도 참조하십시오 .
[constexpr] int qRed(QRgb rgb)
ARGB 4원색 rgb 의 적색 성분을 반환합니다.
qRgb() 및 QColor::red()도 참조하십시오 .
[constexpr] uint qRed(QRgba64 rgba64)
rgba64 의 적색 성분을 8비트 값으로 반환합니다.
QRgba64::red8() 및 QColor::red()도 참조하십시오 .
[constexpr] QRgb qRgb(int r, int g, int b)
ARGB 4원조 (255, r, g, b)를 반환합니다.
qRgba(), qRed(), qGreen(), qBlue() 및 qAlpha()도 참조하십시오 .
[constexpr] QRgba64 qRgba64(quint64 c)
c 를 QRgba64 구조체로 반환합니다.
qRgba()도 참조하십시오 .
[constexpr] QRgba64 qRgba64(quint16 r, quint16 g, quint16 b, quint16 a)
QRgba64 의 4개 요소로 구성된 쿼드럽렛(r, g, b, a)을 반환합니다.
qRgba()도 참조하십시오 .
[constexpr] QRgb qRgba(int r, int g, int b, int a)
ARGB 4원조(a, r, g, b)를 반환합니다.
qRgb(), qRed(), qGreen(), qBlue() 및 qAlpha()도 참조하십시오 .
QRgb qUnpremultiply(QRgb rgb)
사전 곱셈이 적용된 ARGB 4원색 튜플 rgb 을 사전 곱셈이 적용되지 않은 ARGB 4원색 튜플로 변환합니다.
qPremultiply()도 참조하십시오 .
[constexpr] QRgba64 qUnpremultiply(QRgba64 rgba64)
사전 곱셈이 적용된 QRgba64 4원조 rgba64 를 사전 곱셈이 적용되지 않은 QRgba64 4원조로 변환합니다.
QRgba64::unpremultiplied() 및 qPremultiply()도 참조하십시오 .
QDataStream &operator<<(QDataStream &stream, const QColor &color)
color 를 stream 에 기록합니다.
'Qt 데이터 유형 직렬화'항목도 참조하십시오 .
QDataStream &operator>>(QDataStream &stream, QColor &color)
stream 에서 color 를 읽어옵니다.
'Qt 데이터 유형의 직렬화' 항목도 참조하십시오 .
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.


