Philiprehberger.ColorConverter 0.2.1

Philiprehberger.ColorConverter

Convert between RGB, HSL, HSV, Hex, and CMYK color models with harmonies, contrast ratio, blending, and gradient generation.

Installation

dotnet add package Philiprehberger.ColorConverter

Usage

using Philiprehberger.ColorConverter;

var color = Color.FromHex("#FF6347");

HslColor hsl = color.ToHsl();
HsvColor hsv = color.ToHsv();
CmykColor cmyk = color.ToCmyk();
string hex = color.ToHex();           // "#FF6347"
var (r, g, b, a) = color.ToRgb();    // (255, 99, 71, 255)

Manipulate Colors

var coral = Color.FromHex("#FF7F50");

Color lighter    = coral.Lighten(0.1);
Color darker     = coral.Darken(0.1);
Color vivid      = coral.Saturate(0.2);
Color muted      = coral.Desaturate(0.2);
Color opposite   = coral.Complement();
Color transparent = coral.WithAlpha(128);

CSS Named Colors

var teal = Color.Parse("teal");
var coral = Color.Parse("coral");
var gold = Color.Parse("gold");

Color Harmonies

var red = Color.FromRgb(255, 0, 0);

Color complement = ColorHarmonies.Complementary(red);
Color[] triadic = ColorHarmonies.Triadic(red);           // 2 colors at 120° intervals
Color[] tetradic = ColorHarmonies.Tetradic(red);         // 3 colors at 90° intervals
Color[] analogous = ColorHarmonies.Analogous(red);       // 2 colors at ±30°
Color[] split = ColorHarmonies.SplitComplementary(red);  // 2 colors at 150° and 210°

WCAG Contrast Ratio

var black = Color.FromRgb(0, 0, 0);
var white = Color.FromRgb(255, 255, 255);

double ratio = Accessibility.ContrastRatio(black, white);  // 21.0
bool aa = Accessibility.MeetsWcagAA(black, white);         // true
bool aaa = Accessibility.MeetsWcagAAA(black, white);       // true

Color Blending

var a = Color.FromRgb(200, 100, 50);
var b = Color.FromRgb(100, 200, 150);

Color multiplied = ColorBlending.Multiply(a, b);
Color screened = ColorBlending.Screen(a, b);
Color overlaid = ColorBlending.Overlay(a, b);

Gradient Generation

var start = Color.FromRgb(255, 0, 0);
var end = Color.FromRgb(0, 0, 255);

Color[] gradient = Gradient.Generate(start, end, 5);  // 5 evenly-spaced colors in HSL space

API

Development

dotnet build src/Philiprehberger.ColorConverter.csproj --configuration Release

Support

If you find this project useful:

⭐ Star the repo

🐛 Report issues

💡 Suggest features

❤️ Sponsor development

🌐 All Open Source Projects

💻 GitHub Profile

🔗 LinkedIn Profile

License

MIT