TinyMaterialDesign
Loading...
Searching...
No Matches
MaterialColors.h
Go to the documentation of this file.
1#pragma once
2#include <stdint.h>
3#include <algorithm>
4#include <cmath>
5
6namespace tinymd {
7
8/// Packs a 0xRRGGBB hex constant into an RGB_T (RGB565/RGB666/RGB888 all
9/// share the same (r, g, b) 8-bit-per-channel constructor).
10template <typename RGB_T>
11inline RGB_T colorFromHex(uint32_t hex) {
12 return RGB_T(static_cast<uint8_t>((hex >> 16) & 0xFF),
13 static_cast<uint8_t>((hex >> 8) & 0xFF),
14 static_cast<uint8_t>(hex & 0xFF));
15}
16
17/**
18 * @brief Material Design 3 color roles.
19 *
20 * Every widget draws using roles from this struct rather than hard-coded
21 * colors, so swapping a Screen's theme re-colors every widget on it.
22 */
23template <typename RGB_T>
25 RGB_T primary;
26 RGB_T onPrimary;
29
30 RGB_T secondary;
34
35 RGB_T error;
36 RGB_T onError;
37
40
41 RGB_T surface;
42 RGB_T onSurface;
45
46 RGB_T outline;
47};
48
49/// Material 3 "Baseline" light color scheme (the reference purple palette
50/// Google publishes for M3).
51template <typename RGB_T>
53 ColorScheme<RGB_T> c;
54 c.primary = colorFromHex<RGB_T>(0x6750A4);
55 c.onPrimary = colorFromHex<RGB_T>(0xFFFFFF);
56 c.primaryContainer = colorFromHex<RGB_T>(0xEADDFF);
57 c.onPrimaryContainer = colorFromHex<RGB_T>(0x21005D);
58
59 c.secondary = colorFromHex<RGB_T>(0x625B71);
60 c.onSecondary = colorFromHex<RGB_T>(0xFFFFFF);
61 c.secondaryContainer = colorFromHex<RGB_T>(0xE8DEF8);
62 c.onSecondaryContainer = colorFromHex<RGB_T>(0x1D192B);
63
64 c.error = colorFromHex<RGB_T>(0xB3261E);
65 c.onError = colorFromHex<RGB_T>(0xFFFFFF);
66
67 c.background = colorFromHex<RGB_T>(0xFFFBFE);
68 c.onBackground = colorFromHex<RGB_T>(0x1C1B1F);
69
70 c.surface = colorFromHex<RGB_T>(0xFFFBFE);
71 c.onSurface = colorFromHex<RGB_T>(0x1C1B1F);
72 c.surfaceVariant = colorFromHex<RGB_T>(0xE7E0EC);
73 c.onSurfaceVariant = colorFromHex<RGB_T>(0x49454F);
74
75 c.outline = colorFromHex<RGB_T>(0x79747E);
76 return c;
77}
78
79/// Material 3 "Baseline" dark color scheme.
80template <typename RGB_T>
82 ColorScheme<RGB_T> c;
83 c.primary = colorFromHex<RGB_T>(0xD0BCFF);
84 c.onPrimary = colorFromHex<RGB_T>(0x381E72);
85 c.primaryContainer = colorFromHex<RGB_T>(0x4F378B);
86 c.onPrimaryContainer = colorFromHex<RGB_T>(0xEADDFF);
87
88 c.secondary = colorFromHex<RGB_T>(0xCCC2DC);
89 c.onSecondary = colorFromHex<RGB_T>(0x332D41);
90 c.secondaryContainer = colorFromHex<RGB_T>(0x4A4458);
91 c.onSecondaryContainer = colorFromHex<RGB_T>(0xE8DEF8);
92
93 c.error = colorFromHex<RGB_T>(0xF2B8B5);
94 c.onError = colorFromHex<RGB_T>(0x601410);
95
96 c.background = colorFromHex<RGB_T>(0x1C1B1F);
97 c.onBackground = colorFromHex<RGB_T>(0xE6E1E5);
98
99 c.surface = colorFromHex<RGB_T>(0x1C1B1F);
100 c.onSurface = colorFromHex<RGB_T>(0xE6E1E5);
101 c.surfaceVariant = colorFromHex<RGB_T>(0x49454F);
102 c.onSurfaceVariant = colorFromHex<RGB_T>(0xCAC4D0);
103
104 c.outline = colorFromHex<RGB_T>(0x938F99);
105 return c;
106}
107
108/// Builds a color from HSL (h in degrees, s/l in [0, 1]) - lets the seeded
109/// schemes below express roles as "same hue, tuned tone/chroma" instead of
110/// hand-picked hex constants per role.
111template <typename RGB_T>
112inline RGB_T colorFromHsl(float h, float s, float l) {
113 h = std::fmod(h, 360.0f);
114 if (h < 0.0f) h += 360.0f;
115 s = std::min(1.0f, std::max(0.0f, s));
116 l = std::min(1.0f, std::max(0.0f, l));
117
118 const float chroma = (1.0f - std::fabs(2.0f * l - 1.0f)) * s;
119 const float hp = h / 60.0f;
120 const float x = chroma * (1.0f - std::fabs(std::fmod(hp, 2.0f) - 1.0f));
121 float r1 = 0.0f, g1 = 0.0f, b1 = 0.0f;
122 if (hp < 1.0f) { r1 = chroma; g1 = x; }
123 else if (hp < 2.0f) { r1 = x; g1 = chroma; }
124 else if (hp < 3.0f) { g1 = chroma; b1 = x; }
125 else if (hp < 4.0f) { g1 = x; b1 = chroma; }
126 else if (hp < 5.0f) { r1 = x; b1 = chroma; }
127 else { r1 = chroma; b1 = x; }
128 const float m = l - chroma / 2.0f;
129 auto to8 = [m](float v) { return static_cast<uint8_t>(std::round((v + m) * 255.0f)); };
130 return RGB_T(to8(r1), to8(g1), to8(b1));
131}
132
133/// Derives a full Material 3 role set from one seed hue, following the same
134/// tone relationships as the baseline purple scheme above (bold primary,
135/// pale/dark container pair, near-neutral surface) rather than pulling exact
136/// values from a specific Google-published palette. Handy directly for a
137/// fully custom accent color, and backs the named presets below.
138template <typename RGB_T>
139ColorScheme<RGB_T> colorSchemeFromHue(float hueDegrees, bool dark) {
140 ColorScheme<RGB_T> c;
141 if (!dark) {
142 c.primary = colorFromHsl<RGB_T>(hueDegrees, 0.55f, 0.40f);
143 c.onPrimary = colorFromHex<RGB_T>(0xFFFFFF);
144 c.primaryContainer = colorFromHsl<RGB_T>(hueDegrees, 0.70f, 0.90f);
145 c.onPrimaryContainer = colorFromHsl<RGB_T>(hueDegrees, 0.55f, 0.12f);
146
147 c.secondary = colorFromHsl<RGB_T>(hueDegrees, 0.15f, 0.40f);
148 c.onSecondary = colorFromHex<RGB_T>(0xFFFFFF);
149 c.secondaryContainer = colorFromHsl<RGB_T>(hueDegrees, 0.20f, 0.90f);
150 c.onSecondaryContainer = colorFromHsl<RGB_T>(hueDegrees, 0.20f, 0.12f);
151
152 c.error = colorFromHex<RGB_T>(0xB3261E);
153 c.onError = colorFromHex<RGB_T>(0xFFFFFF);
154
155 c.background = colorFromHsl<RGB_T>(hueDegrees, 0.05f, 0.99f);
156 c.onBackground = colorFromHsl<RGB_T>(hueDegrees, 0.05f, 0.11f);
157 c.surface = c.background;
158 c.onSurface = c.onBackground;
159 c.surfaceVariant = colorFromHsl<RGB_T>(hueDegrees, 0.10f, 0.90f);
160 c.onSurfaceVariant = colorFromHsl<RGB_T>(hueDegrees, 0.06f, 0.30f);
161
162 c.outline = colorFromHsl<RGB_T>(hueDegrees, 0.05f, 0.48f);
163 } else {
164 c.primary = colorFromHsl<RGB_T>(hueDegrees, 0.60f, 0.80f);
165 c.onPrimary = colorFromHsl<RGB_T>(hueDegrees, 0.45f, 0.20f);
166 c.primaryContainer = colorFromHsl<RGB_T>(hueDegrees, 0.55f, 0.30f);
167 c.onPrimaryContainer = colorFromHsl<RGB_T>(hueDegrees, 0.70f, 0.90f);
168
169 c.secondary = colorFromHsl<RGB_T>(hueDegrees, 0.20f, 0.80f);
170 c.onSecondary = colorFromHsl<RGB_T>(hueDegrees, 0.15f, 0.20f);
171 c.secondaryContainer = colorFromHsl<RGB_T>(hueDegrees, 0.20f, 0.30f);
172 c.onSecondaryContainer = colorFromHsl<RGB_T>(hueDegrees, 0.20f, 0.90f);
173
174 c.error = colorFromHex<RGB_T>(0xF2B8B5);
175 c.onError = colorFromHex<RGB_T>(0x601410);
176
177 c.background = colorFromHsl<RGB_T>(hueDegrees, 0.08f, 0.10f);
178 c.onBackground = colorFromHsl<RGB_T>(hueDegrees, 0.08f, 0.90f);
179 c.surface = c.background;
180 c.onSurface = c.onBackground;
181 c.surfaceVariant = colorFromHsl<RGB_T>(hueDegrees, 0.10f, 0.30f);
182 c.onSurfaceVariant = colorFromHsl<RGB_T>(hueDegrees, 0.06f, 0.80f);
183
184 c.outline = colorFromHsl<RGB_T>(hueDegrees, 0.05f, 0.60f);
185 }
186 return c;
187}
188
189/// Named seed-hue presets, each a light/dark pair - pass to MaterialTheme's
190/// blueTheme()/greenTheme()/redTheme()/orangeTheme() (and their *DarkTheme()
191/// counterparts) in MaterialTheme.h rather than calling these directly.
192template <typename RGB_T>
193ColorScheme<RGB_T> blueColorScheme() { return colorSchemeFromHue<RGB_T>(210.0f, false); }
194template <typename RGB_T>
195ColorScheme<RGB_T> blueDarkColorScheme() { return colorSchemeFromHue<RGB_T>(210.0f, true); }
196
197template <typename RGB_T>
198ColorScheme<RGB_T> greenColorScheme() { return colorSchemeFromHue<RGB_T>(140.0f, false); }
199template <typename RGB_T>
200ColorScheme<RGB_T> greenDarkColorScheme() { return colorSchemeFromHue<RGB_T>(140.0f, true); }
201
202template <typename RGB_T>
203ColorScheme<RGB_T> redColorScheme() { return colorSchemeFromHue<RGB_T>(10.0f, false); }
204template <typename RGB_T>
205ColorScheme<RGB_T> redDarkColorScheme() { return colorSchemeFromHue<RGB_T>(10.0f, true); }
206
207template <typename RGB_T>
208ColorScheme<RGB_T> orangeColorScheme() { return colorSchemeFromHue<RGB_T>(30.0f, false); }
209template <typename RGB_T>
210ColorScheme<RGB_T> orangeDarkColorScheme() { return colorSchemeFromHue<RGB_T>(30.0f, true); }
211
212} // namespace tinymd
Definition: AnchorLayout.h:4
ColorScheme< RGB_T > redColorScheme()
Definition: MaterialColors.h:203
RGB_T colorFromHsl(float h, float s, float l)
Definition: MaterialColors.h:112
ColorScheme< RGB_T > lightColorScheme()
Definition: MaterialColors.h:52
ColorScheme< RGB_T > blueColorScheme()
Definition: MaterialColors.h:193
ColorScheme< RGB_T > colorSchemeFromHue(float hueDegrees, bool dark)
Definition: MaterialColors.h:139
ColorScheme< RGB_T > orangeDarkColorScheme()
Definition: MaterialColors.h:210
ColorScheme< RGB_T > redDarkColorScheme()
Definition: MaterialColors.h:205
ColorScheme< RGB_T > greenDarkColorScheme()
Definition: MaterialColors.h:200
ColorScheme< RGB_T > blueDarkColorScheme()
Definition: MaterialColors.h:195
RGB_T colorFromHex(uint32_t hex)
Definition: MaterialColors.h:11
ColorScheme< RGB_T > greenColorScheme()
Definition: MaterialColors.h:198
ColorScheme< RGB_T > orangeColorScheme()
Definition: MaterialColors.h:208
ColorScheme< RGB_T > darkColorScheme()
Material 3 "Baseline" dark color scheme.
Definition: MaterialColors.h:81
Material Design 3 color roles.
Definition: MaterialColors.h:24
RGB_T onSecondary
Definition: MaterialColors.h:31
RGB_T onSecondaryContainer
Definition: MaterialColors.h:33
RGB_T onSurface
Definition: MaterialColors.h:42
RGB_T error
Definition: MaterialColors.h:35
RGB_T onPrimary
Definition: MaterialColors.h:26
RGB_T outline
Definition: MaterialColors.h:46
RGB_T onSurfaceVariant
Definition: MaterialColors.h:44
RGB_T onPrimaryContainer
Definition: MaterialColors.h:28
RGB_T onError
Definition: MaterialColors.h:36
RGB_T background
Definition: MaterialColors.h:38
RGB_T surfaceVariant
Definition: MaterialColors.h:43
RGB_T surface
Definition: MaterialColors.h:41
RGB_T onBackground
Definition: MaterialColors.h:39
RGB_T primary
Definition: MaterialColors.h:25
RGB_T secondary
Definition: MaterialColors.h:30
RGB_T secondaryContainer
Definition: MaterialColors.h:32
RGB_T primaryContainer
Definition: MaterialColors.h:27