aest
0.1.0
Collection of C++ utility libraries
Toggle main menu visibility
Loading...
Searching...
No Matches
Random.cppm
Go to the documentation of this file.
1
8
module
;
9
#include <array>
10
#include <concepts>
11
#include <cstdint>
12
#include <random>
13
export
module
aest.colors:random
;
14
15
import
:color;
16
import
:converter;
17
import
:gamut;
18
import
:oklab;
19
import
:operations;
20
import
:space;
21
22
namespace
aest::colors
23
{
35
export
template
<
typename
T>
36
concept
RandomBitGenerator
=
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
50
template
<RandomBitGenerator Generator>
51
constexpr
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
73
export
template
<BoundedRGBSpace Space = SRGB, RandomBitGenerator Generator>
74
constexpr
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
101
export
template
<HueSpace Space = OKLCH, ColorType Color, RandomBitGenerator Generator>
102
requires
ConvertibleTo<Space, Color> && ConvertibleTo<Color, Space>
103
constexpr
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
aest::colors::random_color
constexpr Space random_color(Generator &generator)
A random opaque color, uniform over the channels of an encoded RGB space.
Definition
Random.cppm:74
aest::colors::unit_float
constexpr float unit_float(Generator &generator)
Draw a float uniformly distributed in [0, 1).
Definition
Random.cppm:51
aest::colors::random_hue
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
aest::colors::RandomBitGenerator
A uniform random bit generator whose every output bit is random: its range is a power of two,...
Definition
Random.cppm:36
aest.colors
aest::colors::In
Tag naming the color space an operation works in.
Definition
Space.cppm:30
colors
src
Random.cppm
Generated by
1.18.0