aest 0.1.0
Collection of C++ utility libraries
Loading...
Searching...
No Matches
Random.cppm
Go to the documentation of this file.
1
8module;
9#include <array>
10#include <concepts>
11#include <cstdint>
12#include <random>
13export module aest.colors:random;
14
15import :color;
16import :converter;
17import :gamut;
18import :oklab;
19import :operations;
20import :space;
21
22namespace aest::colors
23{
35export template <typename T>
37 std::uniform_random_bit_generator<T> && (T::max() - T::min() >= 0xFF'FF'FFu)
38 && ((T::max() - T::min()) & (T::max() - T::min() + 1u)) == 0u;
39
50template <RandomBitGenerator Generator>
51constexpr float unit_float(Generator& generator)
52{
53 // Bits a float mantissa holds, so every 24-bit value maps to a distinct float
54 constexpr std::uint32_t bitMask = 0xFF'FF'FFu;
55 return static_cast<float>(
56 static_cast<std::uint32_t>((generator() - Generator::min()) & bitMask))
57 * 0x1p-24f;
58}
59
73export template <BoundedRGBSpace Space = SRGB, RandomBitGenerator Generator>
74constexpr Space random_color(Generator& generator)
75{
76 // A braced initializer evaluates its elements in order, so the channels
77 // take the draws in order on every compiler
78 const std::array<float, 3> channels{unit_float(generator), unit_float(generator),
79 unit_float(generator)};
80 return Space{channels[0], channels[1], channels[2]};
81}
82
101export template <HueSpace Space = OKLCH, ColorType Color, RandomBitGenerator Generator>
102 requires ConvertibleTo<Space, Color> && ConvertibleTo<Color, Space>
103constexpr Color random_hue(const Color& color,
104 Generator& generator,
105 [[maybe_unused]] In<Space> space = {})
106{
107 // Degrees in a full turn of the hue circle
108 constexpr float fullTurn = 360.f;
109 return convert<Color>(Hue<Space>::set(convert<Space>(color), fullTurn * unit_float(generator)));
110}
111} // namespace aest::colors
constexpr Space random_color(Generator &generator)
A random opaque color, uniform over the channels of an encoded RGB space.
Definition Random.cppm:74
constexpr float unit_float(Generator &generator)
Draw a float uniformly distributed in [0, 1).
Definition Random.cppm:51
constexpr Color random_hue(const Color &color, Generator &generator, In< Space > space={})
A copy of a color with a random hue, keeping the rest.
Definition Random.cppm:103
A uniform random bit generator whose every output bit is random: its range is a power of two,...
Definition Random.cppm:36
Tag naming the color space an operation works in.
Definition Space.cppm:30