UFO 1.0.0
An Efficient Probabilistic 3D Mapping Framework That Embraces the Unknown
Loading...
Searching...
No Matches
concepts.hpp
1
45#ifndef UFO_VISION_COLOR_CONCEPTS_HPP
46#define UFO_VISION_COLOR_CONCEPTS_HPP
47
48// UFO
49#include <ufo/vision/color/flags.hpp>
50#include <ufo/vision/color/type_traits.hpp>
51
52// STL
53#include <concepts>
54#include <cstdint>
55
56namespace ufo
57{
63/**************************************************************************************
64| |
65| Core Color Concept |
66| |
67**************************************************************************************/
68
72template <typename T>
73concept Color = is_color_v<T>;
74
75/**************************************************************************************
76| |
77| Value Type Concepts |
78| |
79**************************************************************************************/
80
84template <typename T>
85concept FloatingPointColor = Color<T> && std::floating_point<value_type_t<T>>;
86
90template <typename T>
91concept IntegralColor = Color<T> && std::integral<value_type_t<T>>;
92
93/**************************************************************************************
94| |
95| Flag-Based Concepts |
96| |
97**************************************************************************************/
98
102template <typename T>
103concept ColorWithAlpha = Color<T> && has_alpha_v<T>;
104
108template <typename T>
109concept ColorWithWeight = Color<T> && has_weight_v<T>;
110
114template <typename T>
115concept ColorWithAlphaAndWeight = ColorWithAlpha<T> && ColorWithWeight<T>;
116
120template <typename T>
121concept BasicColor = Color<T> && (color_traits<T>::flags == ColorFlags::None);
122
123/**************************************************************************************
124| |
125| Color Model Concepts |
126| |
127**************************************************************************************/
128
132template <typename T>
133concept GrayColor = Color<T> && (color_traits<T>::model == ColorModel::Gray);
134
138template <typename T>
139concept RgbColor = Color<T> && (color_traits<T>::model == ColorModel::Rgb);
140
144template <typename T>
145concept LinearRgbColor = Color<T> && (color_traits<T>::model == ColorModel::Lrgb);
146
150template <typename T>
151concept LabColor = Color<T> && (color_traits<T>::model == ColorModel::Lab);
152
156template <typename T>
157concept LchColor = Color<T> && (color_traits<T>::model == ColorModel::Lch);
158
159/**************************************************************************************
160| |
161| Grouped Color Model Concepts |
162| |
163**************************************************************************************/
164
168template <typename T>
169concept RgbFamilyColor = RgbColor<T> || LinearRgbColor<T>;
170
174template <typename T>
175concept PerceptualColor = LabColor<T> || LchColor<T>;
176
180template <typename T>
181concept DisplayColor = RgbFamilyColor<T> || GrayColor<T>;
182
186template <typename T>
187concept HueBasedColor = LchColor<T>;
188
192template <typename T>
193concept LightnessBasedColor = LabColor<T> || LchColor<T>;
194
195/**************************************************************************************
196| |
197| Specialized Use Case Concepts |
198| |
199**************************************************************************************/
200
204template <typename T>
205concept AccumulableColor = ColorWithWeight<T> && FloatingPointColor<T>;
206
211template <typename T>
212concept ImageColor =
213 Color<T> && (IntegralColor<T> || (FloatingPointColor<T> && DisplayColor<T>));
214
219template <typename T>
220concept HDRColor = FloatingPointColor<T> && DisplayColor<T>;
221
225template <typename T>
226concept TransparentColor = ColorWithAlpha<T>;
227
231template <typename T>
232concept CompactColor = IntegralColor<T> && (sizeof(value_type_t<T>) <= 2);
233
234/**************************************************************************************
235| |
236| Multi-Type Concepts |
237| |
238**************************************************************************************/
239
243template <typename T1, typename T2>
244concept SameValueType =
245 Color<T1> && Color<T2> && std::same_as<value_type_t<T1>, value_type_t<T2>>;
246
250template <typename T1, typename T2>
251concept SameColorModel =
252 Color<T1> && Color<T2> && (color_traits<T1>::model == color_traits<T2>::model);
253
257template <typename T1, typename T2>
258concept SameColorFlags =
259 Color<T1> && Color<T2> && (color_traits<T1>::flags == color_traits<T2>::flags);
260
264template <typename T1, typename T2>
265concept EquivalentColors =
266 SameColorModel<T1, T2> && SameValueType<T1, T2> && SameColorFlags<T1, T2>;
267
271template <typename From, typename To>
272concept ConvertibleColor =
273 Color<From> && Color<To> && std::convertible_to<value_type_t<From>, value_type_t<To>>;
274
278template <typename T1, typename T2>
279concept BlendableColors =
280 SameColorModel<T1, T2> && ConvertibleColor<T1, T2> && ConvertibleColor<T2, T1>;
281
282/**************************************************************************************
283| |
284| Value Type Extraction Concepts |
285| |
286**************************************************************************************/
287
291template <typename T, typename ValueType>
292concept ColorWithValueType = Color<T> && std::same_as<value_type_t<T>, ValueType>;
293
297template <typename T>
298concept Color8Bit = ColorWithValueType<T, std::uint8_t>;
299
303template <typename T>
304concept Color16Bit = ColorWithValueType<T, std::uint16_t>;
305
309template <typename T>
310concept ColorFloat = ColorWithValueType<T, float>;
311
315template <typename T>
316concept ColorDouble = ColorWithValueType<T, double>;
317
318/**************************************************************************************
319| |
320| Predicate Concepts for Algorithms |
321| |
322**************************************************************************************/
323
327template <typename T>
328concept GammaCorrectable = RgbFamilyColor<T>;
329
333template <typename From, typename To>
334concept ColorSpaceConvertible =
335 Color<From> && Color<To> && DisplayColor<From> && DisplayColor<To>;
336
340template <typename T>
341concept PerceptuallyUniform = PerceptualColor<T>;
342
346template <typename T>
347concept IsColor = Color<T>;
348
352} // namespace ufo
353
354#endif // UFO_VISION_COLOR_CONCEPTS_HPP
ufo::AccumulableColor
Colors that support weighted accumulation (floating-point with weight).
Definition concepts.hpp:205
ufo::BasicColor
Colors without optional channels (no alpha, no weight).
Definition concepts.hpp:121
ufo::BlendableColors
Colors that can be blended together (same model and mutually convertible types).
Definition concepts.hpp:279
ufo::Color16Bit
Colors with a 16-bit channel type.
Definition concepts.hpp:304
ufo::Color8Bit
Colors with an 8-bit channel type.
Definition concepts.hpp:298
ufo::ColorDouble
Colors with a 64-bit double channel type.
Definition concepts.hpp:316
ufo::ColorFloat
Colors with a 32-bit float channel type.
Definition concepts.hpp:310
ufo::ColorSpaceConvertible
Colors that support color space conversion between display color models.
Definition concepts.hpp:334
ufo::ColorWithAlphaAndWeight
Colors with both alpha and weight channels.
Definition concepts.hpp:115
ufo::ColorWithAlpha
Colors that include an alpha channel.
Definition concepts.hpp:103
ufo::ColorWithValueType
Colors with a specific channel type.
Definition concepts.hpp:292
ufo::ColorWithWeight
Colors that include a weight channel.
Definition concepts.hpp:109
ufo::Color
Identifies any UFO color instantiation (Gray, Lab, Lch, Lrgb, Rgb).
Definition concepts.hpp:73
ufo::CompactColor
Colors optimized for compact storage (integral, at most 16 bits per channel).
Definition concepts.hpp:232
ufo::ConvertibleColor
Colors with compatible channel types for conversion.
Definition concepts.hpp:272
ufo::DisplayColor
Color models suitable for display (Rgb, Lrgb, or Gray).
Definition concepts.hpp:181
ufo::EquivalentColors
Two colors that are equivalent (same model, channel type, and flags).
Definition concepts.hpp:265
ufo::FloatingPointColor
Colors with a floating-point channel type.
Definition concepts.hpp:85
ufo::GammaCorrectable
Colors that support gamma correction (Rgb family).
Definition concepts.hpp:328
ufo::GrayColor
Grayscale colors (Gray<T, Flags>).
Definition concepts.hpp:133
ufo::HDRColor
Colors suitable for high dynamic range operations (floating-point display colors).
Definition concepts.hpp:220
ufo::HueBasedColor
Color models with a hue component (Lch).
Definition concepts.hpp:187
ufo::ImageColor
Colors suitable for image processing (integral, or floating-point display colors).
Definition concepts.hpp:212
ufo::IntegralColor
Colors with an integral channel type.
Definition concepts.hpp:91
ufo::IsColor
Convenience alias: any UFO color instantiation.
Definition concepts.hpp:347
ufo::LabColor
Oklab perceptual colors (Lab<T, Flags>).
Definition concepts.hpp:151
ufo::LchColor
OkLch cylindrical colors (Lch<T, Flags>).
Definition concepts.hpp:157
ufo::LightnessBasedColor
Color models with a lightness component (Lab or Lch).
Definition concepts.hpp:193
ufo::LinearRgbColor
Linear-light Rgb colors (Lrgb<T, Flags>).
Definition concepts.hpp:145
ufo::PerceptualColor
Perceptual color models (Lab or Lch).
Definition concepts.hpp:175
ufo::PerceptuallyUniform
Colors that operate in a perceptually uniform space.
Definition concepts.hpp:341
ufo::RgbColor
Gamma-encoded sRgb colors (Rgb<T, Flags>).
Definition concepts.hpp:139
ufo::RgbFamilyColor
Rgb-family colors (gamma-encoded or linear: Rgb or Lrgb).
Definition concepts.hpp:169
ufo::SameColorFlags
Two colors with the same flags.
Definition concepts.hpp:258
ufo::SameColorModel
Two colors with the same color model.
Definition concepts.hpp:251
ufo::SameValueType
Two colors with the same underlying channel type.
Definition concepts.hpp:244
ufo::TransparentColor
Colors with transparency support.
Definition concepts.hpp:226
ufo::ColorFlags::None
@ None
No optional fields.
ufo
All vision-related classes and functions.
Definition cloud.hpp:49