From d231139b83d7b4a26fafb34e2e79def1c5911b7b Mon Sep 17 00:00:00 2001 From: Orange Date: Sun, 8 Feb 2026 02:43:10 +0300 Subject: [PATCH] added for source --- .../omath/engines/source_engine/formulas.hpp | 50 +++++++ tests/engines/unit_test_source_engine.cpp | 123 ++++++++++++++++++ 2 files changed, 173 insertions(+) diff --git a/include/omath/engines/source_engine/formulas.hpp b/include/omath/engines/source_engine/formulas.hpp index a51a633..891d51e 100644 --- a/include/omath/engines/source_engine/formulas.hpp +++ b/include/omath/engines/source_engine/formulas.hpp @@ -22,4 +22,54 @@ namespace omath::source_engine [[nodiscard]] Mat4X4 calc_perspective_projection_matrix(float field_of_view, float aspect_ratio, float near, float far) noexcept; + + template + requires std::is_floating_point_v + [[nodiscard]] + constexpr FloatingType hammer_units_to_centimeters(const FloatingType& hammer_units) + { + constexpr auto centimeter_in_hammer_unit = static_cast(2.54); + return hammer_units * centimeter_in_hammer_unit; + } + + template + requires std::is_floating_point_v + [[nodiscard]] + constexpr FloatingType hammer_units_to_meters(const FloatingType& hammer_units) + { + return hammer_units_to_centimeters(hammer_units) / static_cast(100); + } + + template + requires std::is_floating_point_v + [[nodiscard]] + constexpr FloatingType hammer_units_to_kilometers(const FloatingType& hammer_units) + { + return hammer_units_to_meters(hammer_units) / static_cast(1000); + } + + template + requires std::is_floating_point_v + [[nodiscard]] + constexpr FloatingType centimeters_to_hammer_units(const FloatingType& centimeters) + { + constexpr auto centimeter_in_hammer_unit = static_cast(2.54); + return centimeters / centimeter_in_hammer_unit; + } + + template + requires std::is_floating_point_v + [[nodiscard]] + constexpr FloatingType meters_to_hammer_units(const FloatingType& meters) + { + return centimeters_to_hammer_units(meters * static_cast(100)); + } + + template + requires std::is_floating_point_v + [[nodiscard]] + constexpr FloatingType kilometers_to_hammer_units(const FloatingType& kilometers) + { + return meters_to_hammer_units(kilometers * static_cast(1000)); + } } // namespace omath::source_engine diff --git a/tests/engines/unit_test_source_engine.cpp b/tests/engines/unit_test_source_engine.cpp index ac480e4..7dc0987 100644 --- a/tests/engines/unit_test_source_engine.cpp +++ b/tests/engines/unit_test_source_engine.cpp @@ -7,6 +7,129 @@ #include #include +TEST(unit_test_source_engine_units, HammerUnitsToCentimeters_BasicValues) +{ + EXPECT_FLOAT_EQ(omath::source_engine::hammer_units_to_centimeters(0.0f), 0.0f); + EXPECT_FLOAT_EQ(omath::source_engine::hammer_units_to_centimeters(1.0f), 2.54f); + EXPECT_FLOAT_EQ(omath::source_engine::hammer_units_to_centimeters(10.0f), 25.4f); + EXPECT_FLOAT_EQ(omath::source_engine::hammer_units_to_centimeters(-2.0f), -5.08f); +} + +TEST(unit_test_source_engine_units, HammerUnitsToMeters_BasicValues) +{ + EXPECT_NEAR(omath::source_engine::hammer_units_to_meters(0.0), 0.0, 1e-12); + EXPECT_NEAR(omath::source_engine::hammer_units_to_meters(1.0), 0.0254, 1e-12); + EXPECT_NEAR(omath::source_engine::hammer_units_to_meters(100.0), 2.54, 1e-12); + EXPECT_NEAR(omath::source_engine::hammer_units_to_meters(-4.0), -0.1016, 1e-12); +} + +TEST(unit_test_source_engine_units, HammerUnitsToKilometers_BasicValues) +{ + EXPECT_NEAR(omath::source_engine::hammer_units_to_kilometers(0.0), 0.0, 1e-15); + EXPECT_NEAR(omath::source_engine::hammer_units_to_kilometers(1.0), 0.0000254, 1e-15); + EXPECT_NEAR(omath::source_engine::hammer_units_to_kilometers(1000.0), 0.0254, 1e-15); + EXPECT_NEAR(omath::source_engine::hammer_units_to_kilometers(-10.0), -0.000254, 1e-15); +} + +TEST(unit_test_source_engine_units, CentimetersToHammerUnits_BasicValues) +{ + EXPECT_FLOAT_EQ(omath::source_engine::centimeters_to_hammer_units(0.0f), 0.0f); + EXPECT_NEAR(omath::source_engine::centimeters_to_hammer_units(2.54f), 1.0f, 1e-6f); + EXPECT_NEAR(omath::source_engine::centimeters_to_hammer_units(25.4f), 10.0f, 1e-5f); + EXPECT_NEAR(omath::source_engine::centimeters_to_hammer_units(-5.08f), -2.0f, 1e-6f); +} + +TEST(unit_test_source_engine_units, MetersToHammerUnits_BasicValues) +{ + EXPECT_NEAR(omath::source_engine::meters_to_hammer_units(0.0), 0.0, 1e-12); + EXPECT_NEAR(omath::source_engine::meters_to_hammer_units(0.0254), 1.0, 1e-12); + EXPECT_NEAR(omath::source_engine::meters_to_hammer_units(2.54), 100.0, 1e-10); + EXPECT_NEAR(omath::source_engine::meters_to_hammer_units(-0.0508), -2.0, 1e-12); +} + +TEST(unit_test_source_engine_units, KilometersToHammerUnits_BasicValues) +{ + EXPECT_NEAR(omath::source_engine::kilometers_to_hammer_units(0.0), 0.0, 1e-9); + EXPECT_NEAR(omath::source_engine::kilometers_to_hammer_units(0.0000254), 1.0, 1e-9); + EXPECT_NEAR(omath::source_engine::kilometers_to_hammer_units(0.00254), 100.0, 1e-7); + EXPECT_NEAR(omath::source_engine::kilometers_to_hammer_units(-0.0000508), -2.0, 1e-9); +} + +TEST(unit_test_source_engine_units, RoundTrip_HammerToCentimetersToHammer) +{ + constexpr float hu_f = 123.456f; + constexpr auto cm_f = omath::source_engine::hammer_units_to_centimeters(hu_f); + constexpr auto hu_f_back = omath::source_engine::centimeters_to_hammer_units(cm_f); + EXPECT_NEAR(hu_f_back, hu_f, 1e-5f); + + constexpr double hu_d = -98765.4321; + constexpr auto cm_d = omath::source_engine::hammer_units_to_centimeters(hu_d); + constexpr auto hu_d_back = omath::source_engine::centimeters_to_hammer_units(cm_d); + EXPECT_NEAR(hu_d_back, hu_d, 1e-10); +} + +TEST(unit_test_source_engine_units, RoundTrip_HammerToMetersToHammer) +{ + constexpr float hu_f = 2500.25f; + constexpr auto m_f = omath::source_engine::hammer_units_to_meters(hu_f); + constexpr auto hu_f_back = omath::source_engine::meters_to_hammer_units(m_f); + EXPECT_NEAR(hu_f_back, hu_f, 1e-4f); + + constexpr double hu_d = -42000.125; + constexpr auto m_d = omath::source_engine::hammer_units_to_meters(hu_d); + constexpr auto hu_d_back = omath::source_engine::meters_to_hammer_units(m_d); + EXPECT_NEAR(hu_d_back, hu_d, 1e-10); +} + +TEST(unit_test_source_engine_units, RoundTrip_HammerToKilometersToHammer) +{ + constexpr float hu_f = 100000.0f; + constexpr auto km_f = omath::source_engine::hammer_units_to_kilometers(hu_f); + constexpr auto hu_f_back = omath::source_engine::kilometers_to_hammer_units(km_f); + EXPECT_NEAR(hu_f_back, hu_f, 1e-2f); // looser due to float scaling + + constexpr double hu_d = -1234567.89; + constexpr auto km_d = omath::source_engine::hammer_units_to_kilometers(hu_d); + constexpr auto hu_d_back = omath::source_engine::kilometers_to_hammer_units(km_d); + EXPECT_NEAR(hu_d_back, hu_d, 1e-7); +} + +TEST(unit_test_source_engine_units, ConversionChainConsistency) +{ + // hu -> cm -> m -> km should match direct helpers + constexpr auto hu = 54321.123; + + constexpr auto cm = omath::source_engine::hammer_units_to_centimeters(hu); + constexpr auto m_via_cm = cm / 100.0; + constexpr auto km_via_cm = m_via_cm / 1000.0; + + constexpr auto m_direct = omath::source_engine::hammer_units_to_meters(hu); + constexpr auto km_direct = omath::source_engine::hammer_units_to_kilometers(hu); + + EXPECT_NEAR(m_direct, m_via_cm, 1e-12); + EXPECT_NEAR(km_direct, km_via_cm, 1e-15); +} + +TEST(unit_test_source_engine_units, SupportsFloatAndDoubleTypes) +{ + static_assert(std::is_same_v); + static_assert(std::is_same_v); + static_assert(std::is_same_v); + static_assert(std::is_same_v); +} + +TEST(unit_test_source_engine_units, ConstexprEvaluation) +{ + constexpr double hu = 10.0; + constexpr double cm = omath::source_engine::hammer_units_to_centimeters(hu); + constexpr double m = omath::source_engine::hammer_units_to_meters(hu); + constexpr double km = omath::source_engine::hammer_units_to_kilometers(hu); + + static_assert(cm == 25.4, "constexpr hu->cm failed"); + static_assert(m == 0.254, "constexpr hu->m failed"); + static_assert(km == 0.000254, "constexpr hu->km failed"); +} + TEST(unit_test_source_engine, ForwardVector) { const auto forward = omath::source_engine::forward_vector({});