Color QML Type (Singleton)

색상에 대한 유틸리티 함수를 포함합니다. 더 보기...

참고: 이 타입은 QML 싱글톤입니다. QML 엔진 내에는 이 타입의 인스턴스가 단 하나만 존재합니다.

• 상속된 멤버를 포함한 모든 멤버 목록

메서드

• color blend(color a, color b, real factor)
• color darker(color baseColor, real factor)
• bool equal(color lhs, color rhs)
• color fromString(string name)
• color hsla(real hue, real saturation, real lightness, real alpha)
• color hsva(real hue, real saturation, real value, real alpha)
• color lighter(color baseColor, real factor)
• color rgba(real red, real green, real blue, real alpha)
• color tint(color baseColor, color tintColor)
• color transparent(color color, real opacity)

상세 설명

메서드 설명서

color blend(color a, color b, real factor)

a 와 b 를 혼합한 색상을 반환합니다. 결과 색상은 a 와 b 의 RGB 색상 채널에 대해 각각 독립적으로 선형 보간을 수행하여 생성됩니다.

factor 가 0.0보다 작으면 a 가 반환됩니다. factor가 1.0보다 크면 b 가 반환됩니다.

color darker(color baseColor, real factor)

지정된 factor 만큼 baseColor 보다 어두운 색상을 반환합니다.

이 함수는 현재 RGB 색상을 HSV로 변환한 후, 값(V) 성분을 factor로 나눈 다음, 색상을 다시 RGB로 변환합니다.

요인( )이 1.0보다 크면 이 함수는 더 어두운 색상을 반환합니다. factor를 3.0으로 설정하면 밝기가 3분의 1인 색상을 반환합니다. factor가 1.0보다 작으면 반환되는 색상은 더 밝아지지만, 이러한 목적으로는 Color::lighter() 함수를 사용하는 것이 좋습니다. factor가 0이거나 음수인 경우, 반환 값은 정의되지 않습니다.

bool equal(color lhs, color rhs)

lhs 와 rhs 가 같을 경우 true를 반환합니다. operator==()를 참조하십시오.

color fromString(string name)

지정된 name 에 해당하는 색상(예: red 또는 #ff0000)을 반환합니다. 해당 색상이 없는 경우 예외가 발생합니다.

color hsla(real hue, real saturation, real lightness, real alpha)

지정된 hue, saturation, lightness 및 alpha 성분을 가진 색상을 반환합니다. 모든 성분은 0~1(양쪽 끝 포함) 범위 내에 있어야 합니다.

color hsva(real hue, real saturation, real value, real alpha)

지정된 hue, saturation, value 및 alpha 성분을 가진 색상을 반환합니다. 모든 성분은 0~1(양쪽 끝 포함)의 범위 내에 있어야 합니다.

color lighter(color baseColor, real factor)

지정된 명도 계수( factor )만큼 baseColor 보다 밝은 색상을 반환합니다.

이 함수는 현재 RGB 색상을 HSV로 변환한 후, (V) 성분의 값에 factor를 곱하고, 다시 RGB 색상으로 변환합니다.

factor가 1.0보다 크면 이 함수는 더 밝은 색상을 반환합니다. factor를 1.5로 설정하면 50% 더 밝은 색상을 반환합니다. factor가 1.0보다 작으면 반환되는 색상은 더 어두워지지만, 이러한 용도에는 Color::darker() 함수를 사용하는 것이 좋습니다. factor가 0이거나 음수인 경우, 반환 값은 정의되지 않습니다.

color rgba(real red, real green, real blue, real alpha)

지정된 red, green, blue 및 alpha 성분을 가진 색상을 반환합니다. 모든 성분은 0에서 1 사이의 범위(양쪽 끝 포함)에 있어야 합니다.

color tint(color baseColor, color tintColor)

이 함수를 사용하면 한 색상(baseColor)에 다른 색상(tintColor)을 얇게 덧입힐 수 있습니다.

틴트 색상은 일반적으로 대부분 투명해야 하며, 그렇지 않으면 밑에 있는 색상을 볼 수 없습니다. 아래 예시에서는 틴트 색상을 불투명도가 1/16에 불과한 순수한 빨간색으로 설정하여 약간의 붉은색 틴트 효과를 주고 있습니다.

Item {
    Rectangle {
        x: 0
        width: 80
        height: 80
        color: "lightsteelblue"
    }
    Rectangle {
        x: 100; width: 80; height: 80
        color: Color.tint("lightsteelblue", "#10FF0000")
    }
}

틴팅은 특정 이벤트로 인해 미묘한 변화를 표현하고자 할 때 가장 유용하며, 틴팅을 통해 표시되는 색상을 보다 효과적으로 조정할 수 있습니다.

color transparent(color color, real opacity)

알파 값이 opacity 인 ` color `를 반환합니다. 이 값의 범위는 0(완전히 투명)에서 1(완전히 불투명)까지입니다.