ColorConversionExtensions

menyediakan ColorConversionExtensions serangkaian metode ekstensi yang mendukung konversi, modifikasi, atau pemeriksaan Color.

ColorConversionExtensions dapat ditemukan di CommunityToolkit.Maui.Core.Extensions bawah namespace layanan jadi cukup tambahkan baris berikut untuk memulai:

using CommunityToolkit.Maui.Core.Extensions;

Mengonversi Warna

Metode berikut memungkinkan Anda untuk mengonversi Color.

ToBlackOrWhite

Metode mengonversi ToBlackOrWhite ke Color nilai monokrom Colors.Black atau Colors.White.

Contoh berikut menunjukkan cara mengonversi Colors.Red ke nilai monokrom:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToBlackOrWhite();

ToBlackOrWhiteForText

Metode ini ToBlackOrWhiteForText mengonversi Color ke nilai Colors.Black monokrom atau Colors.White berdasarkan apakah Color ditentukan sebagai gelap untuk mata manusia.

Contoh berikut menunjukkan cara mengonversi Colors.Red ke nilai monokrom:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToBlackOrWhiteForText();

ToGrayScale

Metode mengonversi ToGrayScale ke Color skala Colorabu-abu .

Contoh berikut menunjukkan cara mengonversi Colors.Red ke nilai skala abu-abu:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToGrayScale();

ToInverseColor

Metode ini ToInverseColor menginversi Color.

Contoh berikut menunjukkan cara menginversi Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToInverseColor();

Menentukan Kegelapan warna

Metode berikut memungkinkan Anda menentukan apakah Color dianggap gelap.

IsDark

Metode IsDark jika Color gelap.

Contoh berikut menunjukkan cara menentukan apakah Colors.Red dianggap gelap:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.IsDark();

IsDarkForTheEye

Metode IsDarkForTheEye jika Color gelap untuk mata manusia.

Contoh berikut menunjukkan cara menentukan apakah Colors.Red dianggap gelap untuk mata manusia:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.IsDarkForTheEye();

Mendapatkan komponen Warna

Metode berikut memungkinkan Anda untuk mendapatkan salah satu komponen dari Color.

GetByteRed

Metode ini GetByteRed mendapatkan komponen Color merah sebagai nilai antara 0 dan 255.

Contoh berikut menunjukkan cara mendapatkan komponen merah dari Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetByteRed();

GetByteGreen

Metode ini GetByteGreen mendapatkan komponen Color hijau sebagai nilai antara 0 dan 255.

Contoh berikut menunjukkan cara mendapatkan komponen hijau dari Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetByteGreen();

GetByteBlue

Metode ini GetByteBlue mendapatkan komponen Color biru sebagai nilai antara 0 dan 255.

Contoh berikut menunjukkan cara mendapatkan komponen biru dari Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetByteBlue();

GetDegreeHue

Metode ini GetDegreeHue mendapatkan komponen Color hue sebagai nilai antara 0 dan 360.

Contoh berikut menunjukkan cara mendapatkan komponen hue dari Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetDegreeHue();

GetPercentCyan

Metode ini GetPercentCyan mendapatkan komponen Color sian sebagai nilai antara 0 dan 1.

Contoh berikut menunjukkan cara mendapatkan komponen sian dari Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetPercentCyan();

GetPercentMagenta

Metode ini GetPercentMagenta mendapatkan komponen magenta sebagai Color nilai antara 0 dan 1.

Contoh berikut menunjukkan cara mendapatkan komponen magenta dari Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetPercentMagenta();

GetPercentYellow

Metode ini GetPercentYellow mendapatkan komponen kuning sebagai Color nilai antara 0 dan 1.

Contoh berikut menunjukkan cara mendapatkan komponen kuning dari Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetPercentYellow();

GetPercentBlackKey

Metode ini GetPercentBlackKey mendapatkan komponen Color kunci hitam sebagai nilai antara 0 dan 1.

Contoh berikut menunjukkan cara mendapatkan komponen kunci hitam dari Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetPercentBlackKey();

GetByteAlpha

Metode ini GetByteAlpha mendapatkan komponen Color alfa sebagai nilai antara 0 dan 255.

Contoh berikut menunjukkan cara mendapatkan komponen alfa dari Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.GetByteAlpha();

Ke String warna

Metode berikut memungkinkan Anda mengonversi ke Color skema stringwarna .

ToCmykaString

Metode ini ToCmykaString mengonversi Color ke yang string berisi komponen sian, magenta, kuning, dan kunci. Yang dihasilkan string akan dalam format: CMYKA(cyan,magenta,yellow,key,alpha) di mana sian, magenta, kuning dan kunci akan menjadi nilai antara 0% dan 100%, dan alfa akan menjadi nilai antara 0 dan 1 (misalnya CMYKA(0%,100%,100%,0%,1) untuk Colors.Red).

Contoh berikut menunjukkan cara mengonversi Colors.Red ke string CMYKA:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToCmykaString();

Tergantung pada pengaturan budaya, nilai alfa mungkin memiliki pemisah yang berbeda:

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

Metode ini ToCmykString mengonversi Color ke yang string berisi komponen sian, magenta, kuning, dan kunci. Yang dihasilkan string akan dalam format: CMYK(cyan,magenta,yellow,key) di mana sian, magenta, kuning dan kunci akan menjadi nilai antara 0% dan 100% (misalnya CMYK(0%,100%,100%,0%) untuk Colors.Red).

Contoh berikut menunjukkan cara mengonversi Colors.Red ke string CMYK:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToCmykString();

ToHslaString

Metode ini ToHslaString mengonversi Color ke yang string berisi komponen sian, magenta, kuning, dan kunci. Yang dihasilkan string akan dalam format: HSLA(hue,saturation,lightness,alpha) di mana warna akan menjadi nilai antara 0 dan 360, saturasi dan saturasi akan menjadi nilai antara 0% dan 100%, dan alfa akan menjadi nilai antara 0 dan 1 (misalnya HSLA(0,100%,50%,1) untuk Colors.Red).

Contoh berikut menunjukkan cara mengonversi Colors.Red ke string HSLA:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToHslaString();

Tergantung pada pengaturan budaya, nilai alfa mungkin memiliki pemisah yang berbeda:

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

Metode ini ToHslString mengonversi Color ke yang string berisi komponen sian, magenta, kuning, dan kunci. Yang dihasilkan string akan dalam format: HSL(hue,saturation,lightness) di mana warna akan menjadi nilai antara 0 dan 360, saturasi dan saturasi akan menjadi nilai antara 0% dan 100% (misalnya HSL(0,100%,50%) untuk Colors.Red).

Contoh berikut menunjukkan cara mengonversi Colors.Red ke string HSL:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToHslString();

ToRgbaString

Metode ini ToRgbaString mengonversi Color ke yang string berisi komponen merah, hijau, biru, dan alfa. Yang dihasilkan string akan dalam format: RGB(red,green,blue,alpha) di mana merah, hijau dan biru akan menjadi nilai antara 0 dan 255, dan alfa akan menjadi nilai antara 0 dan 1 (misalnya RGBA(255,0,0,1) untuk Colors.Red).

Contoh berikut menunjukkan cara mengonversi Colors.Red ke string RGBA:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToRgbaString();

Tergantung pada pengaturan budaya, nilai alfa mungkin memiliki pemisah yang berbeda:

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

Metode ini ToRgbString mengonversi Color ke yang string berisi komponen merah, hijau, dan biru. Yang dihasilkan string akan dalam format: RGB(red,green,blue) di mana merah, hijau dan biru akan menjadi nilai antara 0 dan 255 (misalnya RGB(255,0,0) untuk Colors.Red).

Contoh berikut menunjukkan cara mengonversi Colors.Red ke string RGB:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.ToRgbString();

Dengan komponen Warna

Metode berikut memungkinkan Anda mengganti salah satu komponen .Color

WithRed

Metode ini WithRed menerapkan yang disediakan redComponent ke Color. redComponent Perhatikan bahwa bisa antara double 0 dan 1, atau byte antara 0 dan 255.

Contoh berikut menunjukkan cara menerapkan komponen merah ke Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.WithRed(0.5);

WithGreen

Metode ini WithGreen menerapkan yang disediakan greenComponent ke Color. greenComponent Perhatikan bahwa bisa antara double 0 dan 1, atau byte antara 0 dan 255.

Contoh berikut menunjukkan cara menerapkan komponen hijau ke Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.WithGreen(0.5);

DenganBlue

Metode ini WithBlue menerapkan yang disediakan blueComponent ke Color. blueComponent Perhatikan bahwa bisa antara double 0 dan 1, atau byte antara 0 dan 255.

Contoh berikut menunjukkan cara menerapkan komponen biru ke Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.WithBlue(0.5);

WithCyan

Metode ini WithCyan menerapkan yang disediakan cyanComponent ke Color. cyanComponent Perhatikan harus berupa nilai antara 0 dan 1.

Contoh berikut menunjukkan cara menerapkan komponen sian ke Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.WithCyan(0.5);

DenganMagenta

Metode ini WithMagenta menerapkan yang disediakan magentaComponent ke Color. magentaComponent Perhatikan harus berupa nilai antara 0 dan 1.

Contoh berikut menunjukkan cara menerapkan komponen magenta ke Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.WithMagenta(0.5);

Withyellow

Metode ini WithYellow menerapkan yang disediakan yellowComponent ke Color. yellowComponent Perhatikan harus berupa nilai antara 0 dan 1.

Contoh berikut menunjukkan cara menerapkan komponen kuning ke Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.WithYellow(0.5);

DenganBlackKey

Metode ini WithBlackKey menerapkan yang disediakan blackKeyComponent ke Color. blackKeyComponent Perhatikan harus berupa nilai antara 0 dan 1.

Contoh berikut menunjukkan cara menerapkan komponen kunci hitam ke Colors.Red:

using CommunityToolkit.Maui.Extensions.Core;

Colors.Red.WithBlackKey(0.5);

Contoh

Anda dapat menemukan contoh ekstensi ini dalam tindakan di Aplikasi Sampel Toolkit Komunitas .NET MAUI.

API

Anda dapat menemukan kode sumber untuk ColorConversionExtensions lebih pada repositori GitHub .NET MAUI Community Toolkit.