78 lines
2.2 KiB
C++
78 lines
2.2 KiB
C++
/// math.h provides certain useful mathematical functions.
|
|
|
|
#ifndef SCCCL_MATH_H
|
|
#define SCCCL_MATH_H
|
|
|
|
#include <cmath>
|
|
#include <vector>
|
|
|
|
namespace scmp {
|
|
|
|
|
|
// MAX_RADIAN is a precomputed 2 * M_PI, and MIN_RADIAN is -2 * M_PI.
|
|
constexpr double MAX_RADIAN = 2 * M_PI;
|
|
constexpr double MIN_RADIAN = -2 * M_PI;
|
|
constexpr double POS_HALF_RADIAN = M_PI / 2;
|
|
constexpr double NEG_HALF_RADIAN = -(M_PI / 2);
|
|
|
|
|
|
/// Roll m die of n sides, returning a vector of the dice.
|
|
std::vector<int> Die(int m, int n);
|
|
/// Roll m die of n sides, returning the total of the die.
|
|
int DieTotal(int m, int n);
|
|
/// Roll m die of n sides, and take the total of the top k die.
|
|
int BestDie(int k, int m, int n);
|
|
|
|
|
|
/// Convert radians to degrees.
|
|
/// @param rads the angle in radians
|
|
/// @return the angle in degrees.
|
|
float RadiansToDegreesF(float rads);
|
|
|
|
/// Convert radians to degrees.
|
|
/// @param rads the angle in radians
|
|
/// @return the angle in degrees.
|
|
double RadiansToDegreesD(double rads);
|
|
|
|
/// Convert degrees to radians.
|
|
/// @param degrees the angle in degrees
|
|
/// @return the angle in radians.
|
|
float DegreesToRadiansF(float degrees);
|
|
|
|
/// Convert degrees to radians.
|
|
/// @param degrees the angle in degrees
|
|
/// @return the angle in radians.
|
|
double DegreesToRadiansD(double degrees);
|
|
|
|
/// RotateRadians rotates theta0 by theta1 radians, wrapping the result to
|
|
/// MIN_RADIAN <= result <= MAX_RADIAN.
|
|
double RotateRadians(double theta0, double theta1);
|
|
|
|
/// Get the default epsilon value.
|
|
/// @param epsilon The variable to store the epsilon value in.
|
|
void DefaultEpsilon(double &epsilon);
|
|
|
|
/// Get the default epsilon value.
|
|
/// @param epsilon The variable to store the epsilon value in.
|
|
void DefaultEpsilon(float &epsilon);
|
|
|
|
|
|
/// Return whether the two values of type T are equal to within some tolerance.
|
|
/// @tparam T The type of value
|
|
/// @param a A value of type T used as the left-hand side of an equality check.
|
|
/// @param b A value of type T used as the right-hand side of an equality check.
|
|
/// @param epsilon The tolerance value.
|
|
/// @return Whether the two values are "close enough" to be considered equal.
|
|
template <typename T>
|
|
static T
|
|
WithinTolerance(T a, T b, T epsilon)
|
|
{
|
|
return std::abs(a - b) < epsilon;
|
|
}
|
|
|
|
|
|
} // namespace scmp
|
|
|
|
|
|
#endif //SCCCL_MATH_H
|