collisionmath's Introduction

collisionmath

collisionmath is a Java library which can help you handle collision math for games, physic engines or anything else.

Installation

Maven

<dependency>
    <groupId>me.tim</groupId>
    <artifactId>collisionmath</artifactId>
    <version>0.0.2</version>
</dependency>

Or install using GitHub Releases!

Usage

Two-dimensional example

public class App {
    // Class to handle collision
    private CollisionHandler handler;
    private BoundingBox2D boundingBox, otherBoundingBox;

    public App() {
        this.handler = new CollisionHandler();
        
        // Some example BoundingBoxes
        this.boundingBox = new BoundingBox2D(0, 0, 100, 100);
        this.otherBoundingBox = new BoundingBox2D(0, 95, 100, 100);
    }

    // Usage-Example (should be probably something like a gameloop)
    public void run() {
        if (this.handler.isColliding(this.boundingBox, this.otherBoundingBox)) {
            // do anything you want
        }
    }
}

Three-dimensional example

public class App {
    // Class to handle collision
    private CollisionHandler handler;
    private BoundingBox3D boundingBox, otherBoundingBox;

    public App() {
        this.handler = new CollisionHandler();
        
        // Some example BoundingBoxes
        this.boundingBox = new BoundingBox3D(0, 0, 0, 100, 100, 100);
        this.otherBoundingBox = new BoundingBox3D(0, 95, 0, 100, 100, 100);
    }

    // Usage-Example (should be probably something like a gameloop)
    public void run() {
        if (this.handler.isColliding(this.boundingBox, this.otherBoundingBox)) {
            // do anything you want
        }
    }
}