Polybox
Polybox is an in-development PS1 era fantasy console, a bit like Pico-8, but with simple 3D as well as 2D.
It's still rather primitive and early in development, mostly it's just a dedicated PS1 renderer right now with an old fashioned fix function pipeline. You render objects like this:
gpu.MatrixMode(EMatrixMode::Projection);
gpu.Identity();
gpu.Perspective((float)320, (float)240, 1.0f, 20.0f, 60.0f);
gpu.MatrixMode(EMatrixMode::View);
gpu.Identity();
gpu.Translate(Vec3f(-1.5f, -1.5f, -2.0f));
gpu.BeginObject3D(EPrimitiveType::Triangles);
gpu.Color(Vec4f(1.0f, 0.0f, 0.0f, 1.0f));
gpu.Vertex(Vec3f(1.0f, 1.0f, 0.0f));
gpu.Color(Vec4f(0.0f, 1.0f, 0.0f, 1.0f));
gpu.Vertex(Vec3f(1.0f, 2.0f, 0.0f));
gpu.Color(Vec4f(0.0f, 0.0f, 1.0f, 1.0f));
gpu.Vertex(Vec3f(2.0f, 2.0f, 0.0f));
gpu.EndObject3D();
gpu.DrawFrame((float)winWidth, (float)winHeight);
The above gives you the following output:
Current features
- PS1 era fixed-function 3D rendering
- Special shaders for emulating PS1 era look
- Basic flat and smooth shaded lighting
- Gltf model loading
- 2D sprite drawing
- Depth cueing fog
Planned features
- Audio
- Input
- A Lua VM customized for emulating programming on PS1 hardware limits
- A development environment for making games with the console
- Development tools such as level editors made in the lua development environment
- Some sample games
Supported platforms
Currently only Windows 64 bit. It shouldn't be that hard to port to other platforms though, as it uses bgfx for rendering and SDL for platform stuff. But it's early enough I have no interest in porting and testing on other platforms.
Documentation
Also too early for this, but the codebase is extremely simple and hopefully self documenting. The main API that is of interest is the GraphicsChip.h file. The entire rendering API is contained there in a very small amount of code, so small I can list it here,
void Init();
void DrawFrame(float w, float h);
// Basic draw 2D
void DrawSprite(const char* spritePath, float x, float y);
// Basic draw 3D
void BeginObject3D(EPrimitiveType type);
void EndObject3D();
void Vertex(Vec3f vec);
void Color(Vec4f col);
void TexCoord(Vec2f tex);
void Normal(Vec3f norm);
void SetClearColor(Vec3f color);
// Transforms
void MatrixMode(EMatrixMode mode);
void Perspective(float screenWidth, float screenHeight, float nearPlane, float farPlane, float fov);
void Translate(Vec3f translation);
void Rotate(Vec3f rotation);
void Scale(Vec3f scaling);
void Identity();
// Texturing
// ENable/Disable texturing
void BindTexture(const char* texturePath);
void UnbindTexture();
// Lighting
void NormalsMode(ENormalsMode mode);
void EnableLighting(bool enabled);
void Light(int id, Vec3f direction, Vec3f color);
void Ambient(Vec3f color);
// Depth Cueing
void EnableFog(bool enabled);
void SetFogStart(float start);
void SetFogEnd(float end);
void SetFogColor(Vec3f color);
Compiling
The project uses premake5, which is packaged alongside the project, as well as all the dependencies you'll need. You simple run premake5.exe vs2019 (or another project type) and you'll get your project you can compile with
3 Sep 29, 2021
167 Jan 5, 2023
14 Mar 17, 2022
9 Dec 7, 2022
17 Dec 14, 2022
23 Oct 8, 2022
30 Nov 26, 2022
10 Jun 23, 2022
1 Oct 6, 2021
1 Nov 1, 2022
2 Nov 27, 2022
1 Nov 19, 2021
13 Nov 27, 2022
2 Jan 5, 2022
4 Aug 22, 2022
2 Jul 5, 2022
5 Aug 9, 2022
79 Dec 4, 2022
5 Oct 31, 2021