About The Project

This is a WPF library for generating a color palette from an image ported from Android's Palette API

Package	NuGet ID	NuGet Status
WPF Color Picker	wpf.colorpalette

Installation

The package can be installed by NuGet:

Install-Package wpf.colorpalette -Version 1.0.0

Or reference it in your project:

<PackageReference Include="wpf.colorpalette" Version="1.0.0" />

Create a palette

A Palette object gives you access to the primary colors in an image, as well as the corresponding colors for overlaid text. Use palettes to design your app's style and to dynamically change your app's color scheme based on a given source image.

Generate a Palette instance

Generate a Palette instance using Palette's Generate(BitmapSource image) function

var bm = new BitmapImage(new Uri(@"C:/../...png"));
Palette palette = Palette.Generate(bm);

Based on the standards of material design, the palette library extracts commonly used color profiles from an image. Each profile is defined by a Target, and colors extracted from the bitmap image are scored against each profile based on saturation, luminance, and population (number of pixels in the bitmap represented by the color). For each profile, the color with the best score defines that color profile for the given image.

The palette library attempts to extract the following six color profiles:

• Light Vibrant
• Vibrant
• Dark Vibrant
• Light Muted
• Muted
• Dark Muted

Each of Palette's Get<Profile>Color() methods returns the color in the palette associated with that particular profile, where <Profile> is replaced by the name of one of the six color profiles. For example, the method to get the Dark Vibrant color profile is GetDarkVibrantColor(). Since not all images will contain all color profiles, you can also provide a default color to return.

This figure displays a photo and its corresponding color profiles from the Get<Profile>Color() methods.

Color MutedColor = palette.GetMutedColor();
Color VibrantColor = palette.GetVibrantColor();
Color LightMutedColor = palette.GetLightMutedColor();
Color LightVibrantColor = palette.GetLightVibrantColor();
Color DarkMutedColor = palette.GetDarkMutedColor();
Color DarkVibrantColor = palette.GetDarkVibrantColor();

You can aso create more comprehensive color schemes using the GetBodyTextColor() and GetTitleTextColor() extension methods the Color struct. These methods return colors appropriate for use over the swatch’s color.

var muted = palette.GetMutedColor(Colors.White);
mutedBtn.Background = new SolidColorBrush(muted);
mutedBtn.Foreground = new SolidColorBrush(muted.GetTitleTextColor());

An example image with its vibrant-colored toolbar and corresponding title text color.

Preview

These are some preview images from the example project