Google Git
Sign in
chromium / external / github.com / material-foundation / material-color-utilities / 772973a6832e0891e6bf4775b34a819e3ccda29e
commit772973a6832e0891e6bf4775b34a819e3ccda29e[log] [tgz]
authorMaterial Eng <no-reply@google.com>Wed Dec 07 20:47:45 2022
committerCopybara-Service <copybara-worker@google.com>Wed Dec 07 20:48:20 2022
tree49a88400f6cdfa11b1140e5399e6543cde101cf9
parent17bb7751a7e443fcfbe0a87f6ea97277a1294eb8 [diff]
- Removing type=module
- Updating build scripts

PiperOrigin-RevId: 493682097
1 file changed
tree: 49a88400f6cdfa11b1140e5399e6543cde101cf9
  1. cpp/
  2. dart/
  3. java/
  4. typescript/
  5. .gitignore
  6. cheat_sheet.png
  7. CONTRIBUTING.md
  8. LICENSE
  9. pull_request_template.md
  10. README.md
README.md

Material color utilities

Algorithms and utilities that power the Material Design 3 (M3) color system, including choosing theme colors from images and creating tones of colors; all in a new color space.

Library availability

LanguageAvailabilityPackage
C++✅
Dart✅pub package
Java✅Coming soon
Objective-CComing soon
TypeScript✅npm package

Need another platform/language? Check the existing issues or open a new one.

Usage

Image to color

A common use case for this library is extracting a single color from an image. Here's how to do that:

Coming soon

Cheat sheet

library cheat sheet

Components

The library is built out of multiple components

  • each with its own folder and tests
  • each as small as possible

This enables easy merging and updating of subsets into other libraries, such as Material Design Components, Android System UI, etc.

  • Not all consumers will need every component — ex. MDC doesn’t need quantization/scoring/image extraction

Quantize

  • Turns a wallpaper into N colors
  • Celebi, which runs Wu, then WSMeans

Score

  • Rank colors for suitability for theming
  • Quantize buckets a wallpaper into 128 colors
  • Enables deduplicating and ranking that output.

Scheme

  • Mapping from roles, i.e. names like primary, to colors.

Palettes

  • Tonal Palette — range of colors that varies only in tone
  • Core Palette — set of tonal palettes needed to create Material color schemes

HCT

  • Hue, chroma, tone
  • A new color space based on CAM16 x L*
  • Accounts for viewing conditions

Blend

  • Color interpolation in HCT
  • Harmonizing, animations, gradients

Utils

  • Color — conversions between color spaces needed to implement HCT/CAM16
  • Math — functions for ex. ensuring hue is between 0 and 360, clamping, etc.

Background

The Science of Color & Design - Material Design

Design Tooling

The Material Theme Builder Figma plugin and web tool are recommended for design workflows. The Material Theme Builder delivers dynamic color to where design is done. Designers can take an existing design, and see what it looks like under different themes, with just a couple clicks.