/taichi_three

A 3D rendering library based on Taichi (work in progress)

Primary LanguagePythonMIT LicenseMIT

Taichi THREE

Downloads Latest Release

Taichi THREE is a node-based soft renderer based on the Taichi Programming Language to render 3D scenes into nice-looking 2D images in real-time (work in progress).

GitHub | Examples | Getting started

Example Example Example

High-level features are:

  • Both CPU / GPU available
  • Multi-camera support
  • Physically-based rendering
  • Node-based materials
  • A built-in OBJ loader
  • Shadow mapping

Installation

First of all, let's install Taichi THREE on your computer. Make sure you're using Python 3.6/3.7/3.8, and 64-bit. And then install Taichi THREE via pip:

python3 -m pip install taichi_three

To verify the installation, type this command into the Python shell:

import taichi_three as t3

Troubleshooting

See https://taichi.readthedocs.io/en/latest/install.html#troubleshooting for issues related to Taichi.

If you encounter problems using Taichi THREE, please let me know by opening an issue at GitHub, many thanks!

Install from latest master branch

If you'd like to keep catching up with latest Taichi THREE updates, please clone it from our GitHub repository. Then build and install it:

git clone https://github.com/taichi-dev/taichi_three.git
# try this mirror repository on Gitee if the above is too slow:
# git clone https://gitee.com/archibate/taichi_three.git

cd taichi_three
python3 -m pip install -r requirements.txt  # install `taichi` and `taichi-glsl`
python3 -m pip install wheel                # required for the next step
python3 setup.py bdist_wheel                # create a `.whl` file
pip install -U dist/taichi_three-0.0.6-py3-none-any.whl