ABelliqueux/blender_io_export_psx_mesh
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity
Blender plugin to export a scene to a level for the 3dcam PSX engine.
113 Commits 1 Branch 0 Tags 58 MiB
Python 100%
5d6d77c1c3
Go to file
ABelliqueux 5d6d77c1c3 Add Blender example file
2021-07-20 10:30:53 +02:00
TIM Spring update 2021-04-03 17:06:09 +02:00
blender-psx.jpg Spring update 2021-04-03 17:06:09 +02:00
FreeImage.dll Add Freeimage dll 2021-04-03 17:13:57 +02:00
img2tim.exe more cleanup, convertBG func 2021-04-03 14:14:01 +02:00
img2tim.txt Spring cleaning! 2021-04-03 15:23:30 +02:00
io_export_psx_tmesh.py Default mass to 10 2021-07-14 15:05:38 +02:00
pngquant.exe Spring update 2021-04-03 17:06:09 +02:00
README.md Update Doc visibility 2021-06-23 19:43:02 +02:00
startfile.blend Add Blender example file 2021-07-20 10:30:53 +02:00

README.md

Pic or it didn't happen

Blender 3dcam PSX engine Level exporter

This Blender plugin is to be used in conjunction with the 3dcam PSX engine.
It allows exporting a gouraud shaded, UV textured Blender scene to a format compatible with the aforementionned engine.

3d scene

Documentation

Check the Wiki for in-depth informations.

Features

Be warned this is WIP !

Plugin

  • Export UV textured models
  • Export vertex painted models
  • Export camera positions for in game use
  • Export vertex animations
  • Export up to 3 light sources
  • Export pre-rendered backgrounds for in-game use (8bpp and 4bpp)
  • VRam auto layout for TIMs

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

Planned

  • Fix and improve all the things !

Install the plugin

This plugin is not compatible with Blender > 2.79.

  1. Download and install Blender 2.79b.

http://download.blender.org/release/Blender2.79/

  1. Clone this repository in the addons folder of blender 2.79 :
git clone https://github.com/ABelliqueux/blender_io_export_psx_mesh.git
  1. Enable the add-on in Blender by going to user preferences, Add-ons tab, and enable Import-Export: PSX TMesh exporter.

You'll need to have pngquant and img2tim utilities installed and in your path for PNG to TIM conversion.
Windows executables are provided for convenience in this repo.
For users with Imagemagick installed, there is an option when exporting to use that instead of pngquant.

On Linux : ~/.config/blender/2.79/scripts/addons
On macOS : ./Blender.app/Contents/Resources/2.79/addons
On Windows : %USERPROFILE%\AppData\Roaming\Blender Foundation\Blender\2.93\

Install the 3D engine

Head over to the 3dcam repo and follow the setup instructions there.

Export your scene !

Open a working copy of your scene, add the needed flags and export your level in the 3dcam-headers folder. Following those steps, you should now see your scene running on PSX !

Credits

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