retrograde ~raw
The Retrograde Game Engine
To use this package, run the following command in your project's root directory:
Manual usage
Put the following dependency into your project's dependences section:
The Retrograde Game Engine
Copyright Mike Bierlee 2014-2026 Version 0.0.0 Licensed under the terms of the MIT license - See LICENSE.txt
Retrograde is a general purpose game engine. Currently it is in alpha state and not fit for production. Many usual engine systems are missing or incomplete.
This is yet another redo of the engine, this time focussing on portability and web-compatibility.
This README will be extended further once the engine matures more.
Coordinate System
Retrograde uses the following coordinate system conventions:
- Right-handed coordinate system: Following OpenGL conventions, the engine uses a right-handed coordinate system where the cross product of the X-axis and Y-axis points in the positive Z direction.
- Y-up orientation: The positive Y-axis points upward. The standard up vector is
(0, 1, 0). - Matrix layout: Matrices use row-major order for data storage.
- Clipping planes: Near and far clipping distances are specified along the negative Z-axis.
These conventions cover the 3D world. Positions over the 2D window, such as those of the mouse, are Y-down instead: their origin is the top left corner of the window and the positive Y-axis points downward, the way every platform reports them.
Version Conditions
The following table lists all version conditions available and used by Retrograde.
| Version | Description |
|---|---|
| Native | Include native implementations. Do not use this if you want to build for the web. |
| WebAssembly | Include WebAssembly implementations. Do not use for native builds. Some compilers will implicitly add this when targeting WASM. |
| Windows | Include implementations for Windows. Typically added by compiler when targeting Windows. |
| Posix | Include implementations for POSIX-compliant systems (e.g. Linux, macOS). Typically added by compiler when targeting these platforms. |
| UnitTesting | Include the engine's unit tests in build. By NOT specifying this the compiler will properly optimize them out of your (release) build. |
| MemoryDebug | When included, issues related to memory allocation will be printed. Normally only needed to debug issues with the game engine itself. |
| OpenGLES3 | Use the OpenGL ES 3 render API. Available in WebAssembly (via WebGL2) and native. |
| NoGraphicsApi | Use a no-op graphics API stub. Useful for headless builds, testing, or when no rendering is required. |
| DoublePrecision | Use double precision (64-bit) for scalar math operations instead of single precision (32-bit float). Affects Vector and Matrix types. |
| LargeEventData | Add 64-bit members (long, ulong, double) to event data, growing it from 4 to 8 bytes. Omit it to keep events small. |
| MaxLights0/4/8/16/32 | Amount of dynamic forward-rendered lights a material can be lit by, exposed to shaders as MAX_LIGHTS. MaxLights0 disables them. Defaults to 8 when omitted. |
- ~raw released 10 days ago
- mbierlee/retrograde
- MIT
- Copyright Mike Bierlee 2014-2026
- Authors:
- Dependencies:
- none
- Versions:
-
Show all 5 versions0.0.0 2017-Sep-04 ~raw 2026-Aug-29 ~neo 2023-May-25 ~legacy 2022-May-29 ~develop 2023-May-25 - Download Stats:
-
-
0 downloads today
-
0 downloads this week
-
0 downloads this month
-
63 downloads total
-
- Score:
- 0.9
- Short URL:
- retrograde.dub.pm