ColorConversionExtensions

변환 ColorConversionExtensions , 수정 또는 검사를 지원하는 일련의 확장 메서드를 Color제공합니다.

ColorConversionExtensions 네임스페이 CommunityToolkit.Maui.Core.Extensions 스 아래에서 찾을 수 있으므로 시작하려면 다음 줄을 추가하기만 하면 됩니다.

using CommunityToolkit.Maui.Core.Extensions;

색 변환

다음 메서드를 사용하여 .를 변환할 수 있습니다 Color.

ToBlackOrWhite

메서드는 ToBlackOrWhite 모노크롬 값 Colors.Black 또는 Colors.White.로 변환합니다Color.

다음 예제에서는 단색 값으로 변환 Colors.Red 하는 방법을 보여줍니다.

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToBlackOrWhite();

ToBlackOrWhiteForText

이 메서드는 ToBlackOrWhiteForText 사람의 눈에 어둡게 결정되는지 여부에 Color 따라 단색 값 Colors.Black 으로 변환 Color 합니다Colors.White.

다음 예제에서는 단색 값으로 변환 Colors.Red 하는 방법을 보여줍니다.

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToBlackOrWhiteForText();

ToGrayScale

메서드는 ToGrayScale 회색 눈금Color으로 변환합니다Color.

다음 예제에서는 회색 배율 값으로 변환 Colors.Red 하는 방법을 보여줍니다.

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToGrayScale();

ToInverseColor

메서드는 ToInverseColor .를 반전합니다 Color.

다음 예제에서는 반전 Colors.Red하는 방법을 보여줍니다.

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToInverseColor();

색 어둠 결정

다음 메서드를 사용하면 어두운 것으로 간주되는지 여부를 Color 확인할 수 있습니다.

IsDark

IsDark 어둡게 표시되면 Color 메서드입니다.

다음 예제에서는 어둡게 간주되는지 확인하는 Colors.Red 방법을 보여줍니다.

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.IsDark();

IsDarkForTheEye

IsDarkForTheEye 사람의 눈에 어두운 경우 Color 의 메서드입니다.

다음 예제에서는 사람의 눈에 어둡게 간주되는지 여부를 Colors.Red 확인하는 방법을 보여줍니다.

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.IsDarkForTheEye();

색 구성 요소 가져오기

다음 메서드를 사용하면 .의 Color구성 요소 중 하나를 가져올 수 있습니다.

GetByteRed

메서드는 GetByteRed 0에서 255 사이의 값으로 빨간색 구성 요소를 Color 가져옵니다.

다음 예제에서는 다음의 Colors.Red빨간색 구성 요소를 가져오는 방법을 보여줍니다.

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetByteRed();

GetByteGreen

이 메서드는 GetByteGreen 0에서 255 사이의 값으로 녹색 구성 요소를 Color 가져옵니다.

다음 예제에서는 다음의 Colors.Red녹색 구성 요소를 가져오는 방법을 보여줍니다.

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetByteGreen();

GetByteBlue

메서드는 GetByteBlue 0에서 255 사이의 값으로 파란색 구성 요소를 Color 가져옵니다.

다음 예제에서는 다음의 Colors.Red파란색 구성 요소를 가져오는 방법을 보여줍니다.

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetByteBlue();

GetDegreeHue

메서드는 GetDegreeHue 0에서 360 사이의 값으로 색상 구성 요소를 Color 가져옵니다.

다음 예제에서는 다음의 Colors.Red색조 구성 요소를 가져오는 방법을 보여줍니다.

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetDegreeHue();

GetPercentCyan

메서드는 GetPercentCyan 0에서 1 사이의 값으로 시안 구성 요소를 Color 가져옵니다.

다음 예제에서는 다음의 시안 구성 요소를 Colors.Red가져오는 방법을 보여줍니다.

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetPercentCyan();

GetPercentMagenta

메서드는 GetPercentMagenta 0에서 1 사이의 값으로 magentaColor 구성 요소를 가져옵니다.

다음 예제에서는 다음의 magenta 구성 요소를 Colors.Red가져오는 방법을 보여줍니다.

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetPercentMagenta();

GetPercentYellow

메서드는 GetPercentYellow 0에서 1 사이의 값으로 노란색 구성 요소를 Color 가져옵니다.

다음 예제에서는 다음과 같은 노란색 구성 요소를 Colors.Red가져오는 방법을 보여줍니다.

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetPercentYellow();

GetPercentBlackKey

메서드는 GetPercentBlackKey 0에서 1 사이의 값으로 검정 키 구성 요소를 Color 가져옵니다.

다음 예제에서는 다음의 검은색 키 구성 요소를 Colors.Red가져오는 방법을 보여줍니다.

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetPercentBlackKey();

GetByteAlpha

메서드는 GetByteAlpha 0에서 255 사이의 값으로 알파 구성 요소를 Color 가져옵니다.

다음 예제에서는 다음의 Colors.Red알파 구성 요소를 가져오는 방법을 보여줍니다.

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetByteAlpha();

색 문자열로

다음 메서드를 사용하면 색 구성표로 변환 Color 할 수 있습니다 string.

ToCmykaString

메서드는 ToCmykaString 시안, 자홍, 노란색 및 키 구성 요소를 포함하는 것으로 변환 Colorstring 합니다. 결과는 cyan, magenta, yellow 및 key가 0%에서 100% 사이의 값이고 알파는 0에서 1 사이의 값(예: Colors.RedCMYKA(0%,100%,100%,0%,1) )인 형식 CMYKA(cyan,magenta,yellow,key,alpha)입니다.string

다음 예제에서는 CMYKA 문자열로 변환 Colors.Red 하는 방법을 보여줍니다.

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToCmykaString();

문화권 설정 에 따라 알파 값에 다른 구분 기호가 있을 수 있습니다.

new Color(0, 0, 0, 0.5f).ToCmykaString(new System.Globalization.CultureInfo("en-US")); // returns "CMYKA(0%,0%,0%,100%,0.5)"
new Color(0, 0, 0, 0.5f).ToCmykaString(new System.Globalization.CultureInfo("uk-UA")); // returns "CMYKA(0%,0%,0%,100%,0,5)"

ToCmykString

메서드는 ToCmykString 시안, 자홍, 노란색 및 키 구성 요소를 포함하는 것으로 변환 Colorstring 합니다. 결과는 cyan, magenta, yellow 및 key가 0%에서 100% 사이의 값(예: Colors.RedCMYK(0%,100%,100%,0%))인 형식 CMYK(cyan,magenta,yellow,key)입니다.string

다음 예제에서는 CMYK 문자열로 변환 Colors.Red 하는 방법을 보여줍니다.

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToCmykString();

ToHslaString

메서드는 ToHslaString 시안, 자홍, 노란색 및 키 구성 요소를 포함하는 것으로 변환 Colorstring 합니다. 결과는 string 형식 HSLA(hue,saturation,lightness,alpha) 입니다. 여기서 색조 는 0에서 360 사이의 값이고 채 도 와 채도 는 0%에서 100% 사이의 값이 되고 알파 는 0에서 1 사이의 값(예: HSLA(0,100%,50%,1)Colors.Red)입니다.

다음 예제에서는 HSLA 문자열로 변환 Colors.Red 하는 방법을 보여 줍니다.

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToHslaString();

문화권 설정 에 따라 알파 값에 다른 구분 기호가 있을 수 있습니다.

new Color(0, 0, 0, 0.5f).ToHslaString(new System.Globalization.CultureInfo("en-US")); // returns "HSLA(0%,0%,0%,100%,0.5)"
new Color(0, 0, 0, 0.5f).ToHslaString(new System.Globalization.CultureInfo("uk-UA")); // returns "HSLA(0%,0%,0%,100%,0,5)"

ToHslString

메서드는 ToHslString 시안, 자홍, 노란색 및 키 구성 요소를 포함하는 것으로 변환 Colorstring 합니다. 결과는 string 형식 HSL(hue,saturation,lightness) 입니다. 여기서 색조 는 0에서 360 사이의 값이 되고 채 도 와 채도 는 0%에서 100%(예: HSL(0,100%,50%)Colors.Red)의 값이 됩니다.

다음 예제에서는 HSL 문자열로 변환 Colors.Red 하는 방법을 보여 줍니다.

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToHslString();

ToRgbaString

메서드 Color 는 ToRgbaString 빨강, 녹색, 파랑 및 알파 구성 요소를 포함 하는 string 변환 합니다. 결과는 빨강, 녹색 및 파랑이 0에서 255 사이의 값이고 알파는 0에서 1 사이의 값(예: Colors.RedRGBA(255,0,0,1))인 형식 RGB(red,green,blue,alpha)입니다.string

다음 예제에서는 RGBA 문자열로 변환 Colors.Red 하는 방법을 보여줍니다.

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToRgbaString();

문화권 설정 에 따라 알파 값에 다른 구분 기호가 있을 수 있습니다.

new Color(0, 0, 0, 0.5f).ToRgbaString(new System.Globalization.CultureInfo("en-US")); // returns "RGBA(0,0,0,0.5)"
new Color(0, 0, 0, 0.5f).ToRgbaString(new System.Globalization.CultureInfo("uk-UA")); // returns "RGBA(0,0,0,0,5)"

ToRgbString

메서드는 ToRgbStringColorstring 빨간색, 녹색 및 파란색 구성 요소를 포함하는 구성 요소로 변환합니다. 결과는 string 형식 RGB(red,green,blue) 입니다. 여기서 빨간색, 녹색 및 파랑 은 0에서 255 사이의 값(예: RGB(255,0,0) ) Colors.Red입니다.

다음 예제에서는 RGB 문자열로 변환 Colors.Red 하는 방법을 보여줍니다.

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToRgbString();

색 구성 요소와 함께

다음 메서드를 사용하면 .의 Color구성 요소 중 하나를 바꿀 수 있습니다.

WithRed

이 메서드는 WithRed 제공된 redComponent 메서드를 적용합니다 Color. redComponent 0에서 double 1 사이 또는 byte 0에서 255 사이일 수 있습니다.

다음 예제에서는 빨간색 구성 요소를 적용하는 방법을 보여줍니다.Colors.Red

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.WithRed(0.5);

WithGreen

이 메서드는 WithGreen 제공된 greenComponent 메서드를 적용합니다 Color. greenComponent 0에서 double 1 사이 또는 byte 0에서 255 사이일 수 있습니다.

다음 예제에서는 녹색 구성 요소를 적용하는 방법을 보여줍니다.Colors.Red

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.WithGreen(0.5);

WithBlue

이 메서드는 WithBlue 제공된 blueComponent 메서드를 적용합니다 Color. blueComponent 0에서 double 1 사이 또는 byte 0에서 255 사이일 수 있습니다.

다음 예제에서는 파란색 구성 요소를 적용하는 방법을 보여줍니다.Colors.Red

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.WithBlue(0.5);

WithCyan

이 메서드는 WithCyan 제공된 cyanComponent 메서드를 적용합니다 Color. cyanComponent 0에서 1 사이의 값이어야 합니다.

다음 예제에서는 시안 구성 요소를 Colors.Red적용하는 방법을 보여줍니다.

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.WithCyan(0.5);

WithMagenta

이 메서드는 WithMagenta 제공된 magentaComponent 메서드를 적용합니다 Color. magentaComponent 0에서 1 사이의 값이어야 합니다.

다음 예제에서는 magenta 구성 요소를 적용하는 방법을 보여줍니다.Colors.Red

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.WithMagenta(0.5);

WithYellow

이 메서드는 WithYellow 제공된 yellowComponent 메서드를 적용합니다 Color. yellowComponent 0에서 1 사이의 값이어야 합니다.

다음 예제에서는 노란색 구성 요소를 다음과 같이 적용하는 Colors.Red방법을 보여줍니다.

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.WithYellow(0.5);

WithBlackKey

이 메서드는 WithBlackKey 제공된 blackKeyComponent 메서드를 적용합니다 Color. blackKeyComponent 0에서 1 사이의 값이어야 합니다.

다음 예제에서는 검정 키 구성 요소를 적용하는 방법을 보여줍니다.Colors.Red

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.WithBlackKey(0.5);

예제

.NET MAUI 커뮤니티 도구 키트 샘플 애플리케이션에서 작동 중인 이 확장의 예를 찾을 수 있습니다.

API

.NET MAUI 커뮤니티 도구 키트 GitHub 리포지토리에서 오버에 대한 ColorConversionExtensions 소스 코드를 찾을 수 있습니다.