Figure: result of python3 example6.py. Please replace the image above (demo.jpg) with yours, so that other people can immediately see your results :-)

We invite you to create your voxel artwork, by putting your Taichi code in main.py!

Rules:

  • You can only import two modules: taichi (pip installation guide below) and scene.py (in the repo).
  • The code in main.py cannot exceed 99 lines. Each line cannot exceed 120 characters.

The available APIs are:

  • scene = Scene(voxel_edges, exposure)
  • scene.set_voxel(voxel_id, material, color)
  • material, color = scene.get_voxel(voxel_id)
  • scene.set_floor(height, color)
  • scene.set_directional_light(dir, noise, color)
  • scene.set_background_color(color)

Remember to call scene.finish() at last.

Taichi Lang documentation: https://docs.taichi-lang.org/

Modifying files other than main.py is not allowed.

Installation

Make sure your pip is up-to-date:

pip3 install pip --upgrade

Assume you have a Python 3 environment, simply run:

pip3 install -r requirements.txt

to install the dependencies of the voxel renderer.

Quickstart

python3 example1.py  # example2/3/.../7/8.py

Mouse and keyboard interface:

  • Drag with your left mouse button to rotate the camera.
  • Press W/A/S/D/Q/E to move the camera.
  • Press P to save a screenshot.

More examples

Show your artwork

Please put your artwork at the beginning of this README file. Replacing the demo.jpg file with your creation will do the job.