geometrize::commonutil Namespace Reference

Functions
static thread_local std::mt19937	mt (std::random_device{}())
void	seedRandomGenerator (std::uint32_t seed)
	seedRandomGenerator Seeds the (thread-local) random number generators. More...
std::int32_t	randomRange (std::int32_t min, std::int32_t max)
	randomRange Returns a random integer in the range, inclusive. Uses thread-local random number generators under the hood. To ensure deterministic shape generation that can be repeated for different seeds, this should be used for shape mutation, but nothing else. More...
geometrize::rgba	getAverageImageColor (const geometrize::Bitmap &image)
	getAverageImageColor Computes the average RGB color of the pixels in the bitmap. More...
template<typename T >
T	clamp (const T &value, const T &lower, const T &upper)
	clamp Clamps a value within a range. More...

Variables
static thread_local std::uniform_int_distribution < std::int32_t >	pick

Function Documentation

template<typename T >

T geometrize::commonutil::clamp	(	const T &	value,
		const T &	lower,
		const T &	upper
	)

clamp Clamps a value within a range.

Parameters

value	The value to clamp.
lower	The lower bound of the range.
upper	The upper bound of the range.

Returns

The clamped value.

{
    return (std::max)(lower, (std::min)(value, upper));
}

Here is the caller graph for this function:

geometrize::rgba geometrize::commonutil::getAverageImageColor

(

const geometrize::Bitmap &

image

)

getAverageImageColor Computes the average RGB color of the pixels in the bitmap.

Parameters

image

The image whose average color will be calculated.

Returns

The average RGB color of the image, RGBA8888 format. Alpha is set to opaque (255).

{
    const std::vector<std::uint8_t>& data{image.getDataRef()};
    const std::size_t size{data.size()};
    if(size == 0) {
        return geometrize::rgba{0, 0, 0, 0};
    }

    const std::size_t numPixels{size / 4U};

    std::uint32_t totalRed{0};
    std::uint32_t totalGreen{0};
    std::uint32_t totalBlue{0};
    for(std::size_t i = 0; i < size; i += 4U) {
        totalRed += data[i];
        totalGreen += data[i + 1U];
        totalBlue += data[i + 2U];
    }

    return geometrize::rgba{
        static_cast<std::uint8_t>(totalRed / numPixels),
        static_cast<std::uint8_t>(totalGreen / numPixels),
        static_cast<std::uint8_t>(totalBlue / numPixels),
        static_cast<std::uint8_t>(UINT8_MAX)
    };
}

Here is the call graph for this function:

static thread_local std::mt19937 geometrize::commonutil::mt ( std::random_device{}  () )

static

std::int32_t geometrize::commonutil::randomRange	(	std::int32_t	min,
		std::int32_t	max
	)

randomRange Returns a random integer in the range, inclusive. Uses thread-local random number generators under the hood. To ensure deterministic shape generation that can be repeated for different seeds, this should be used for shape mutation, but nothing else.

Parameters

min	The lower bound.
max	The upper bound.

Returns

The random integer in the range.

{
    assert(min <= max);
    return pick(mt, std::uniform_int_distribution<std::int32_t>::param_type{min, max});
}

Here is the caller graph for this function:

void geometrize::commonutil::seedRandomGenerator

(

std::uint32_t

seed

)

seedRandomGenerator Seeds the (thread-local) random number generators.

Parameters

seed	The random seed.

{
    mt.seed(seed);
}

Here is the caller graph for this function:

Variable Documentation

thread_local std::uniform_int_distribution<std::int32_t> geometrize::commonutil::pick

static