A Non-Euclidean Rendering Engine.

---

Hyper is an experimental engine for visualizing non-Euclidean geometry, starting with the Hyperbolic 2D Plane and extending into hybrid 3D space. It renders an infinite world, offering an educational, interactive view of hyperbolic tilings and maze algorithms.

Quickstart

Clone the repository

git clone https://github.com/cocosol007/hyper.git
cd hyper

3D

To run the 3D view, run the command

./gradlew run

poincare.mp4

3D Klein model

To run the 3D Klein model view, run the command

./gradlew run --args="klein"

klein.mp4

3D Gnomonic model

To run the 3D Gnomonic model view, run the command

./gradlew run --args="gnomonic"

gnomonic.mp4

Ray-Caster Maze

To run the RayCaster maze, run the command

./gradlew runRayCaster

example.mp4

Poincaré and Beltrami–Klein disk model

To run the 2D Poicaré disk model, run the command

./gradlew run2D --args='poincare'

To run the 2D Klein model, run the command

./gradlew run2D --args='Klein'

Example_2D.mp4

Gnomonic projection

To run the 2D ./gradlew run2D --args='gnomonic' model, run the command

./gradlew run2D --args='gnomonic'

Gnomonic.mp4

Documentation

0. Project Setup

• A . How to Run the Project
• B . How to contribute
• C . What for?

I. Foundations in Hyperbolic Geometry

• A . Introduction
• B . Poincaré Disk Model
• C . Isometries

II. Tessellations

• A . Introduction to Tessellation
• B . Coordinate System
• C . Implementation

III. 3D Rendering

• A . Ray-Caster Maze (WIP)
• B . Visual effects

IV. In-Depth Explorations

• A . Other Models

Licence

See all about our license here

Contributors