https://github.com/claviering/voxel-challenge-stairs

voxel stairs
https://github.com/claviering/voxel-challenge-stairs

Last synced: about 2 months ago
JSON representation

voxel stairs

• Host: GitHub
• URL: https://github.com/claviering/voxel-challenge-stairs
• Owner: claviering
• Created: 2022-04-30T07:52:17.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2022-05-01T02:20:33.000Z (over 2 years ago)
• Last Synced: 2024-07-26T11:42:41.373Z (about 2 months ago)
• Language: Python
• Homepage:
• Size: 480 KB
• Stars: 3
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

• awesome-taichi - Stairs - A staircase ascending to the clouds, composed of voxels. (Applications / **Voxel Art**)
• awesome-taichi - Stairs - A staircase ascending to the clouds, composed of voxels. (**Voxel Art**)

README

        
# Taichi Voxel Challenge







> 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](https://github.com/taichi-dev/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.graphics/

**Modifying files other than `main.py` is not allowed.**

## Installation

Make sure your `pip` is up-to-date:

```bash

pip3 install pip --upgrade

```

Assume you have a Python 3 environment, simply run:

```bash

pip3 install -r requirements.txt

```

to install the dependencies of the voxel renderer.

## Quickstart

```sh

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.