3dcam-headers/README.md

3dcam PSX engine

This a WIP PSX 3d engine. Use this with the companion blender exporter to create levels for the engine.

Features

Be warned this is WIP !

Real-time 3D / 8bpp background / 4bpp background

"Engine"

• Very basic physics / collision detection
• Constrained camera trajectory
• Orbital camera mode
• Basic Spatial partitioning
• Portal based camera angle switch
• 3D sprite
• VRam auto layout for TIMs

Planned

• Fix and improve all the things !
• Wall collisions

Compiling

You need to install mkpsxiso and the pcsx-redux emulator and Nugget+PsyQ SDK before you can build the engine. Put mkpsxiso and pcsx-redux in your $PATH and you should be good to go.

1. Clone this repo in (...)/pcsx-redux/src/mips/
2. Navigate to that folder in a terminal :

cd /pcsx-redux/src/mips/3dcam-headers

3. Type ./isotest.sh. This should compile the example, build an iso with mkpsxiso and launch it with pcsx-redux.
4. Install the blender extension to create your own levels.

Credits

Based on the code provided by TheDukeOfZill, 04-2014, on http://www.psxdev.net/forum/viewtopic.php?f=64&t=537#p4088
PSX code based on example by Lameguy64
pngquant : https://github.com/kornelski/pngquant
img2tim : https://github.com/Lameguy64/img2tim
Freeimage : https://freeimage.sourceforge.io/