{"id":13688985,"url":"https://github.com/taichi-dev/voxel-challenge","last_synced_at":"2025-07-24T23:31:16.695Z","repository":{"id":40449950,"uuid":"481891435","full_name":"taichi-dev/voxel-challenge","owner":"taichi-dev","description":null,"archived":false,"fork":false,"pushed_at":"2022-08-05T16:09:42.000Z","size":784,"stargazers_count":232,"open_issues_count":8,"forks_count":36,"subscribers_count":5,"default_branch":"main","last_synced_at":"2025-04-02T15:09:12.237Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/taichi-dev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2022-04-15T08:29:35.000Z","updated_at":"2025-03-19T14:21:42.000Z","dependencies_parsed_at":"2022-07-16T05:16:15.035Z","dependency_job_id":null,"html_url":"https://github.com/taichi-dev/voxel-challenge","commit_stats":null,"previous_names":[],"tags_count":0,"template":true,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/taichi-dev%2Fvoxel-challenge","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/taichi-dev%2Fvoxel-challenge/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/taichi-dev%2Fvoxel-challenge/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/taichi-dev%2Fvoxel-challenge/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/taichi-dev","download_url":"https://codeload.github.com/taichi-dev/voxel-challenge/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248076333,"owners_count":21043751,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-08-02T15:01:29.594Z","updated_at":"2025-04-09T17:27:13.724Z","avatar_url":"https://github.com/taichi-dev.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"# \u003ca name=\"title\"\u003eTaichi Voxel Challenge\u003c/a\u003e\n\n\u003cp align=\"center\"\u003e\n\u003cimg src=\"demo.jpg\" width=\"75%\"\u003e\u003c/img\u003e\n\u003c/p\u003e\n\n\u003e Figure: result of `python3 example6.py`. Please replace the image above (`demo.jpg`) with yours, so that other people can immediately see your results :-)\n\nWe invite you to create your voxel artwork, by putting your [Taichi](https://github.com/taichi-dev/taichi) code in `main.py`!\n\nRules:\n\n+ You can only import two modules: `taichi` (`pip` installation guide below) and `scene.py` (in the repo).\n+ The code in `main.py` cannot exceed 99 lines. Each line cannot exceed 120 characters.\n\nThe available APIs are:\n\n+ `scene = Scene(voxel_edges, exposure)`\n+ `scene.set_voxel(voxel_id, material, color)`\n+ `material, color = scene.get_voxel(voxel_id)`\n+ `scene.set_floor(height, color)`\n+ `scene.set_directional_light(dir, noise, color)`\n+ `scene.set_background_color(color)`\n\nRemember to call `scene.finish()` at last.\n\n**Taichi Lang documentation:** https://docs.taichi-lang.org/\n\n**Modifying files other than `main.py` is not allowed.**\n\n\n## Installation\n\nMake sure your `pip` is up-to-date:\n\n```bash\npip3 install pip --upgrade\n```\n\nAssume you have a Python 3 environment, simply run:\n\n```bash\npip3 install -r requirements.txt\n```\n\nto install the dependencies of the voxel renderer.\n\n## Quickstart\n\n```sh\npython3 example1.py  # example2/3/.../7/8.py\n```\n\nMouse and keyboard interface:\n\n+ Drag with your left mouse button to rotate the camera.\n+ Press `W/A/S/D/Q/E` to move the camera.\n+ Press `P` to save a screenshot.\n\n## More examples\n\n\u003ca href=\"https://github.com/raybobo/taichi-voxel-challenge\"\u003e\u003cimg src=\"https://github.com/taichi-dev/public_files/blob/master/voxel-challenge/city.jpg\" width=\"45%\"\u003e\u003c/img\u003e\u003c/a\u003e  \u003ca href=\"https://github.com/victoriacity/voxel-challenge\"\u003e\u003cimg src=\"https://github.com/taichi-dev/public_files/blob/master/voxel-challenge/city2.jpg\" width=\"45%\"\u003e\u003c/img\u003e\u003c/a\u003e \n\u003ca href=\"https://github.com/yuanming-hu/voxel-art\"\u003e\u003cimg src=\"https://github.com/taichi-dev/public_files/blob/master/voxel-challenge/tree2.jpg\" width=\"45%\"\u003e\u003c/img\u003e\u003c/a\u003e \u003ca href=\"https://github.com/neozhaoliang/voxel-challenge\"\u003e\u003cimg src=\"https://github.com/taichi-dev/public_files/blob/master/voxel-challenge/desktop.jpg\" width=\"45%\"\u003e\u003c/img\u003e\u003c/a\u003e \n\u003ca href=\"https://github.com/maajor/maajor-voxel-challenge\"\u003e\u003cimg src=\"https://github.com/taichi-dev/public_files/blob/master/voxel-challenge/earring_girl.jpg\" width=\"45%\"\u003e\u003c/img\u003e\u003c/a\u003e  \u003ca href=\"https://github.com/rexwangcc/taichi-voxel-challenge\"\u003e\u003cimg src=\"https://github.com/taichi-dev/public_files/blob/master/voxel-challenge/pika.jpg\" width=\"45%\"\u003e\u003c/img\u003e\u003c/a\u003e \n\u003ca href=\"https://github.com/houkensjtu/qbao_voxel_art\"\u003e\u003cimg src=\"https://github.com/taichi-dev/public_files/blob/master/voxel-challenge/yinyang.jpg\" width=\"45%\"\u003e\u003c/img\u003e\u003c/a\u003e  \u003ca href=\"https://github.com/ltt1598/voxel-challenge\"\u003e\u003cimg src=\"https://github.com/taichi-dev/public_files/blob/master/voxel-challenge/lang.jpg\" width=\"45%\"\u003e\u003c/img\u003e\u003c/a\u003e \n\n## Show your artwork \n\nPlease put your artwork at the beginning of this README file. Replacing the `demo.jpg` file with your creation will do the job.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftaichi-dev%2Fvoxel-challenge","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftaichi-dev%2Fvoxel-challenge","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftaichi-dev%2Fvoxel-challenge/lists"}