C_random.hpp

/*
 * Copyright 2024 Guillaume Guillet
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
 
#ifndef _FGE_C_RANDOM_HPP_INCLUDED
#define _FGE_C_RANDOM_HPP_INCLUDED
 
#include "FastEngine/fge_extern.hpp"
#include "FastEngine/C_vector.hpp"
#include "FastEngine/graphic/C_color.hpp"
 
#include <chrono>
#include <limits>
#include <mutex>
#include <random>
#include <string>
 
namespace fge
{
 
template<typename TEngine>
class Random
{
public:
    Random();
    explicit Random(uint64_t seed);
 
    void setSeed(uint64_t seed);
 
    template<typename T>
    T range(T min, T max);
 
    [[nodiscard]] TEngine const& getEngine() const;
    [[nodiscard]] TEngine& getEngine();
 
    template<typename T>
    fge::Vector2<T> rangeVec2(T min_x, T max_x, T min_y, T max_y);
 
    template<typename T>
    fge::Vector3<T> rangeVec3(T min_x, T max_x, T min_y, T max_y, T min_z, T max_z);
 
    fge::Color rangeColor(uint32_t min, uint32_t max);
    fge::Color rangeColor(uint8_t min_r,
                          uint8_t max_r,
                          uint8_t min_g,
                          uint8_t max_g,
                          uint8_t min_b,
                          uint8_t max_b,
                          uint8_t min_a,
                          uint8_t max_a);
 
    template<typename T>
    T rand();
 
    template<typename T>
    fge::Vector2<T> randVec2();
 
    template<typename T>
    fge::Vector3<T> randVec3();
 
    fge::Color randColor();
 
    std::string randStr(std::size_t length,
                        std::string const& bucket = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxy0123456789");
 
private:
    TEngine g_engine;
    std::mutex g_mutex;
};
 
FGE_API extern fge::Random<std::mt19937_64> _random;
 
} // namespace fge
 
#include <FastEngine/C_random.inl>
 
#endif // _FGE_C_RANDOM_HPP_INCLUDED