Oranges's Math Library (omath) is a comprehensive, open-source library aimed at providing efficient, reliable, and versatile mathematical functions and algorithms. Developed primarily in C++, this library is designed to cater to a wide range of mathematical operations essential in scientific computing, engineering, and academic research.

👁‍🗨 Features

• Efficiency: Optimized for performance, ensuring quick computations using AVX2.
• Versatility: Includes a wide array of mathematical functions and algorithms.
• Ease of Use: Simplified interface for convenient integration into various projects.
• Projectile Prediction: Projectile prediction engine with O(N) algo complexity, that can power you projectile aim-bot.
• 3D Projection: No need to find view-projection matrix anymore you can make your own projection pipeline.
• Collision Detection: Production ready code to handle collision detection by using simple interfaces.
• No Additional Dependencies: No additional dependencies need to use OMath except unit test execution
• Ready for meta-programming: Omath use templates for common types like Vectors, Matrixes etc, to handle all types!

Supported Render Pipelines

ENGINE	SUPPORT
Source	✅YES
Unity	✅YES
IWEngine	✅YES
Unreal	❌NO

Supported Operating Systems

OS	SUPPORT
Windows 10/11	✅YES
Linux	✅YES
Darwin (MacOS)	✅YES

⏬ Getting Started

Prerequisites

• C++ Compiler
• CMake (for building the project)

Installation

vcpkg

Note: Support vcpkg for package management

1. Install vcpkg (https://github.com/microsoft/vcpkg)
2. Run the following command to install the orange-math package:

vcpkg install orange-math

CMakeLists.txt

find_package(omath CONFIG REQUIRED)
target_link_libraries(main PRIVATE omath::omath)

For detailed commands on installing different versions and more information, please refer to Microsoft's official instructions (https://learn.microsoft.com/en-us/vcpkg/get_started/overview)

Build from source

1. Clone the repository:

   git clone https://github.com/orange-cpp/omath.git
   
2. Navigate to the project directory:

   cd omath
   
3. Build the project using CMake:

   cmake --preset windows-release -S .
   cmake --build cmake-build/build/windows-release --target omath -j 6
   
   Use <platform>-<build configuration> preset to build siutable version for yourself. Like windows-release or linux-release.

❔ Usage

Simple world to screen function

TEST(UnitTestProjection, IsPointOnScreen)
{
    const omath::projection::Camera camera({0.f, 0.f, 0.f}, {0, 0.f, 0.f} , {1920.f, 1080.f}, 110.f, 0.1f, 500.f);

    const auto proj = camera.WorldToScreen({100, 0, 15});
    EXPECT_TRUE(proj.has_value());
}

Showcase

OMATH for making cheats (click to open)

With omath/projection module you can achieve simple ESP hack for powered by Source/Unreal/Unity engine games, like Apex Legends.

Or for InfinityWard Engine based games. Like Call of Duty Black Ops 2! Or create simple trigger bot with embeded traceline from omath::collision::LineTrace Or even advanced projectile aimbot Watch Video

🫵🏻 Contributing

Contributions to omath are welcome! Please read CONTRIBUTING.md for details on our code of conduct and the process for submitting pull requests.

📜 License

This project is licensed under the MIT - see the LICENSE file for details.

💘 Acknowledgments

• All contributors