Get the latest Blender, older versions, or experimental builds.
Stay up-to-date with the new features in the latest Blender releases.
Access production assets and knowledge from the open movies.
Documentation on the usage and features in Blender.
Latest development updates, by Blender developers.
Guidelines, release notes and development docs.
A platform to collect and share results of the Blender Benchmark.
The yearly event that brings the community together.
Support core development with a monthly contribution.
Perform a single donation with more payment options available.
Ignoring revisions in .git-blame-ignore-revs. Click here to bypass and see the normal blame view.
/* SPDX-License-Identifier: GPL-2.0-or-later
* Copyright 2022 Blender Foundation. */
#pragma once
/** \file
* \ingroup bli
*/
#include <algorithm>
#include <cmath>
#include <type_traits>
#include "BLI_math_base_safe.h"
#include "BLI_utildefines.h"
namespace blender::math {
template<typename T> inline constexpr bool is_math_float_type = std::is_floating_point_v<T>;
template<typename T> inline constexpr bool is_math_integral_type = std::is_integral_v<T>;
template<typename T> inline bool is_zero(const T &a)
{
return a == T(0);
}
template<typename T> inline bool is_any_zero(const T &a)
return is_zero(a);
template<typename T> inline T abs(const T &a)
return std::abs(a);
template<typename T> inline T min(const T &a, const T &b)
return std::min(a, b);
template<typename T> inline T max(const T &a, const T &b)
return std::max(a, b);
template<typename T> inline T clamp(const T &a, const T &min, const T &max)
return std::clamp(a, min, max);
template<typename T, BLI_ENABLE_IF((is_math_float_type<T>))> inline T mod(const T &a, const T &b)
return std::fmod(a, b);
template<typename T, BLI_ENABLE_IF((is_math_float_type<T>))>
inline T safe_mod(const T &a, const T &b)
return (b != 0) ? std::fmod(a, b) : 0;
template<typename T> inline void min_max(const T &value, T &min, T &max)
min = math::min(value, min);
max = math::max(value, max);
inline T safe_divide(const T &a, const T &b)
return (b != 0) ? a / b : T(0.0f);
template<typename T, BLI_ENABLE_IF((is_math_float_type<T>))> inline T floor(const T &a)
return std::floor(a);
template<typename T, BLI_ENABLE_IF((is_math_float_type<T>))> inline T ceil(const T &a)
return std::ceil(a);
template<typename T> inline T distance(const T &a, const T &b)
return std::abs(a - b);
template<typename T, BLI_ENABLE_IF((is_math_float_type<T>))> inline T fract(const T &a)
return a - std::floor(a);
template<typename T,
typename FactorT,
BLI_ENABLE_IF((std::is_arithmetic_v<T>)),
BLI_ENABLE_IF((is_math_float_type<FactorT>))>
inline T interpolate(const T &a, const T &b, const FactorT &t)
auto result = a * (1 - t) + b * t;
if constexpr (std::is_integral_v<T> && std::is_floating_point_v<FactorT>) {
result = std::round(result);
return result;
template<typename T> inline T midpoint(const T &a, const T &b)
auto result = (a + b) * T(0.5);
if constexpr (std::is_integral_v<T>) {
} // namespace blender::math