{"id":23240633,"url":"https://github.com/luisagroup/luisarender","last_synced_at":"2025-04-12T23:40:48.161Z","repository":{"id":63367698,"uuid":"202950196","full_name":"LuisaGroup/LuisaRender","owner":"LuisaGroup","description":"High-Performance Cross-Platform Monte Carlo Renderer Based on LuisaCompute","archived":false,"fork":false,"pushed_at":"2025-03-22T17:38:32.000Z","size":536920,"stargazers_count":525,"open_issues_count":3,"forks_count":41,"subscribers_count":18,"default_branch":"next","last_synced_at":"2025-04-12T23:40:03.546Z","etag":null,"topics":["cpp","cuda","gpu","high-performance","ispc","metal","optix","path-tracing","ray-tracing","renderer","rendering","siggraph-asia-2022"],"latest_commit_sha":null,"homepage":"","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/LuisaGroup.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2019-08-18T02:16:36.000Z","updated_at":"2025-04-04T04:36:21.000Z","dependencies_parsed_at":"2024-01-26T09:51:06.540Z","dependency_job_id":"a776a23e-be6a-43d4-a9c9-a42ac0ff3ceb","html_url":"https://github.com/LuisaGroup/LuisaRender","commit_stats":{"total_commits":1251,"total_committers":11,"mean_commits":"113.72727272727273","dds":0.3077537969624301,"last_synced_commit":"f4a30904fe6477e8b5a28daf00b38b7f7fb7f25f"},"previous_names":["mike-leo-smith/luisarender"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LuisaGroup%2FLuisaRender","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LuisaGroup%2FLuisaRender/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LuisaGroup%2FLuisaRender/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LuisaGroup%2FLuisaRender/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/LuisaGroup","download_url":"https://codeload.github.com/LuisaGroup/LuisaRender/tar.gz/refs/heads/next","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248647254,"owners_count":21139081,"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":["cpp","cuda","gpu","high-performance","ispc","metal","optix","path-tracing","ray-tracing","renderer","rendering","siggraph-asia-2022"],"created_at":"2024-12-19T05:13:20.473Z","updated_at":"2025-04-12T23:40:48.124Z","avatar_url":"https://github.com/LuisaGroup.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"# LuisaRender\n\nLuisaRender is a high-performance cross-platform Monte-Carlo renderer for stream architectures based\non [LuisaCompute](https://github.com/LuisaGroup/LuisaCompute).\n\nLuisaRender is also the *rendering application* described in the **SIGGRAPH Asia 2022** paper\n\u003e ***LuisaRender: A High-Performance Rendering Framework with Layered and Unified Interfaces on Stream Architectures***.\n\nSee also [LuisaCompute](https://github.com/LuisaGroup/LuisaCompute) for the underlying *framework* as described in the paper; and please visit the [project page](https://luisa-render.com) for other information about the paper and the project.\n\n## Building\n\nLuisaRender follows the standard CMake build process. Basically these steps:\n\n- Check your hardware and platform. Currently, we support CUDA on Linux and Windows; DirectX on Windows; Metal on macOS; and ISPC and LLVM on all the major platforms. For CUDA and DirectX, an RTX-enabled graphics card, e.g., NVIDIA RTX 20 and 30 series, is required.\n\n- Prepare the environment and dependencies. We recommend using the latest IDEs, Compilers, CMake, CUDA drivers, etc. Since we aggressively use new technologies like C++20 and OptiX 7.1+, you may need to, for example, upgrade your VS to 2019 or 2022, and install CUDA 11.2+.\n\n- Clone the repo with the `--recursive` option:\n    ```bash\n    git clone --recursive https://github.com/LuisaGroup/LuisaRender.git\n    ```\n    Since we use Git submodules to manage third-party dependencies, a `--recursive` clone is required.\n\n- Configure the project using CMake. E.g., for command line, `cd` into the project folder and type `cmake -S . -B \u003cbuild-folder\u003e`. You might also want to specify your favorite generators and build types using options like `-G Ninja` and `-D CMAKE_BUILD_TYPE=Release`. A typical, full command sequence for this would be like\n    ```bash\n    cd LuisaRender\n    cmake -S . -B build -D CMAKE_BUILD_TYPE=Release\n    ```\n\n- If the configuration succeeds, you are now able to build the project. Type `cmake --build \u003cbuild-folder\u003e` in the command line, or push the build button if you generated, e.g., a VS project. (And in case the configuration step unluckily failed :-(, please file an [issue](https://github.com/LuisaGroup/LuisaRender/issues)). \n\n- After building, you will find the CLI executable at `\u003cbuild-folder\u003e/bin/luisa-render-cli`.\n\nSee also [BUILD.md](BUILD.md) for details on platform requirements, configuration options, and other precautions.\n\n# Usage\n\nUse command line to execute LuisaRender:\n```bash\n\u003cbuild-fodler\u003e/bin/luisa-render-cli -b \u003cbackend\u003e [-d \u003cdevice-index\u003e] \u003cscene-file\u003e\n```\n\nTo print the help message about the command line arguments, simply type\n```bash\n\u003cbuild-fodler\u003e/bin/luisa-render-cli -h\n```\nor\n```bash\n\u003cbuild-fodler\u003e/bin/luisa-render-cli --help\n```\n\n# Scenes\n\nLuisaRender supports a JSON-based and a custom text-based formats for scene description. We maintain the demo scenes in a separate [repo](https://github.com/LuisaGroup/LuisaRenderScenes). We sincerely thank all the authors, [Rendering Resources](https://benedikt-bitterli.me/resources), [Poly Heaven](https://polyhaven.com), and [Blender Demo Files](https://download.blender.org/demo/cycles/lone-monk_cycles_and_exposure-node_demo.blend) for sharing these amazing resources.\n\nWe also provide a simple script at `tools/tungsten2luisa.py` to convert Tungsten scenes into LuisaRender's custom scene description language; and a CLI application at `src/apps/export.cpp` (compiled to `\u003cbuild-folder\u003e/bin/luisa-render-export`) to convert glTF scenes to LuisaRender's JSON-based format. But please note that both tools are not perfect. Manual tweaks are sometimes necessary to fix conversion errors and/or align the converted scenes to their original appearances.\n\n\n## Contemporary Bathroom\n\nDownload: [LuisaRender](https://github.com/LuisaGroup/LuisaRenderScenes/releases/download/scenes/bathroom.zip)\n\n- Credit: [Mareck](http://www.blendswap.com/users/view/Mareck) (CC0)\n- Converted from Tungsten version at [Rendering Resources](https://benedikt-bitterli.me/resources)\n- Resolution: 1024x1024\n- Samples: 65536\n- Tonemapping: ACES (exposure = -0.5)\n\n\u003cimg src=\"https://github.com/LuisaGroup/LuisaRenderScenes/raw/main/renders/bathroom.png\" width=\"80%\" alt=\"Bathroom\"/\u003e\n\n## Bedroom\n\nDownload: [LuisaRender](https://github.com/LuisaGroup/LuisaRenderScenes/releases/download/scenes/bedroom.zip)\n\n- Credit: [SlykDrako](http://www.blendswap.com/user/SlykDrako) (CC0)\n- Converted from Tungsten version at [Rendering Resources](https://benedikt-bitterli.me/resources)\n- Resolution: 1280x720\n- Samples: 65536\n- Tonemapping: Uncharted2\n\n![Bedroom](https://github.com/LuisaGroup/LuisaRenderScenes/raw/main/renders/bedroom.png)\n\n## Camera\n\nDownload: [LuisaRender](https://github.com/LuisaGroup/LuisaRenderScenes/releases/download/scenes/camera.zip)\n\n- Credit: All resources in the scene are from [Poly Heaven](https://polyhaven.com) (CC0, see the contained `README.txt` for the detail of each resource)\n- Resolution: 3840x2160\n- Samples: 65536\n- Tonemapping: Uncharted2\n\n![Camera](https://github.com/LuisaGroup/LuisaRenderScenes/raw/main/renders/camera.png)\n\n## Kitchen\n\nDownload: [LuisaRender](https://github.com/LuisaGroup/LuisaRenderScenes/releases/download/scenes/kitchen.zip)\n\n- Credit: [Jay-Artist](http://www.blendswap.com/user/Jay-Artist) ([CC BY 3.0](https://creativecommons.org/licenses/by/3.0))\n- Converted from Tungsten version at [Rendering Resources](https://benedikt-bitterli.me/resources)\n- Resolution: 1280x720\n- Samples: 65536\n- Tonemapping: ACES\n\n![Kitchen](https://github.com/LuisaGroup/LuisaRenderScenes/raw/main/renders/kitchen.png)\n\n## Spaceship\n\nDownload: [LuisaRender](https://github.com/LuisaGroup/LuisaRenderScenes/releases/download/scenes/spaceship.zip)\n\n- Credit: [thecali](http://www.blendswap.com/user/thecali) (CC0)\n- Converted from Tungsten version at [Rendering Resources](https://benedikt-bitterli.me/resources)\n- Resolution: 1920x1080\n- Samples: 16384\n- Tonemapping: Uncharted2\n\n![Kitchen](https://github.com/LuisaGroup/LuisaRenderScenes/raw/main/renders/spaceship.png)\n\n## Modern Hall\n\nDownload: [LuisaRender](https://github.com/LuisaGroup/LuisaRenderScenes/releases/download/scenes/staircase2.zip)\n\n- Credit: [NewSee2l035](http://www.blendswap.com/user/NewSee2l035) ([CC BY 3.0](https://creativecommons.org/licenses/by/3.0/))\n- Converted from Tungsten version at [Rendering Resources](https://benedikt-bitterli.me/resources)\n- Resolution: 1024x1024\n- Samples: 65536\n- Tonemapping: Uncharted2 (exposure = +1)\n\n\u003cimg src=\"https://github.com/LuisaGroup/LuisaRenderScenes/raw/main/renders/staircase2.png\" width=\"80%\" alt=\"Staircase2\"/\u003e\n\n## The Wooden Staircase\n\nDownload: [LuisaRender](https://github.com/LuisaGroup/LuisaRenderScenes/releases/download/scenes/staircase.zip)\n\n- Credit: [Wig42](http://www.blendswap.com/users/view/Wig42) ([CC BY 3.0](https://creativecommons.org/licenses/by/3.0/))\n- Converted from Tungsten version at [Rendering Resources](https://benedikt-bitterli.me/resources)\n- Resolution: 1080x1920\n- Samples: 16384\n- Tonemapping: Uncharted2 (exposure = +0.5)\n\n\u003cimg src=\"https://github.com/LuisaGroup/LuisaRenderScenes/raw/main/renders/staircase.png\" width=\"60%\" alt=\"Staircase\"/\u003e\n\n## Coffee Maker\n\nDownload: [LuisaRender](https://github.com/LuisaGroup/LuisaRenderScenes/releases/download/scenes/coffee.zip)\n\n- Credit: [cekuhnen](http://www.blendswap.com/user/cekuhnen) ([CC BY 3.0](https://creativecommons.org/licenses/by/3.0/))\n- Converted from Tungsten version at [Rendering Resources](https://benedikt-bitterli.me/resources)\n- Resolution: 1200x1800\n- Samples: 16384\n- Tonemapping: Uncharted2 (exposure = +0.5)\n\n\u003cimg src=\"https://github.com/LuisaGroup/LuisaRenderScenes/raw/main/renders/coffee.png\" width=\"70%\" alt=\"Coffee\"/\u003e\n\n## Japanese Classroom\n\nDownload: [LuisaRender](https://github.com/LuisaGroup/LuisaRenderScenes/releases/download/scenes/classroom.zip)\n\n- Credit: [NovaZeeke](http://www.blendswap.com/users/view/NovaZeeke) ([CC BY 3.0](https://creativecommons.org/licenses/by/3.0/))\n- Converted from Tungsten version at [Rendering Resources](https://benedikt-bitterli.me/resources)\n- Resolution: 1920x1080\n- Samples: 16384\n- Tonemapping: Uncharted2 (exposure = +0.5)\n\n\u003cimg src=\"https://github.com/LuisaGroup/LuisaRenderScenes/raw/main/renders/classroom.png\" alt=\"Classroom\"/\u003e\n\n## The Breakfast Room\n\nDownload: [LuisaRender](https://github.com/LuisaGroup/LuisaRenderScenes/releases/download/scenes/dining-room.zip)\n\n- Credit: [Wig42](http://www.blendswap.com/users/view/Wig42) ([CC BY 3.0](https://creativecommons.org/licenses/by/3.0/))\n- Converted from Tungsten version at [Rendering Resources](https://benedikt-bitterli.me/resources)\n- Resolution: 1920x1080\n- Samples: 16384\n- Tonemapping: Uncharted2 (exposure = +0.5)\n\n\u003cimg src=\"https://github.com/LuisaGroup/LuisaRenderScenes/raw/main/renders/dining-room.png\" alt=\"Dining Room\"/\u003e\n\n## The Grey \u0026 White Room\n\nDownload: [LuisaRender](https://github.com/LuisaGroup/LuisaRenderScenes/releases/download/scenes/living-room.zip)\n\n- Credit: [Wig42](http://www.blendswap.com/users/view/Wig42) ([CC BY 3.0](https://creativecommons.org/licenses/by/3.0/))\n- Converted from Tungsten version at [Rendering Resources](https://benedikt-bitterli.me/resources)\n- Resolution: 1920x1080\n- Samples: 16384\n- Tonemapping: Uncharted2 (exposure = +0.5)\n\n\u003cimg src=\"https://github.com/LuisaGroup/LuisaRenderScenes/raw/main/renders/living-room.png\" alt=\"Living Room\"/\u003e\n\n## The White Room\n\nDownload: [LuisaRender](https://github.com/LuisaGroup/LuisaRenderScenes/releases/download/scenes/living-room-2.zip)\n\n- Credit: [Jay-Artist](http://www.blendswap.com/user/Jay-Artist) ([CC BY 3.0](https://creativecommons.org/licenses/by/3.0/))\n- Converted from Tungsten version at [Rendering Resources](https://benedikt-bitterli.me/resources)\n- Resolution: 1280x720\n- Samples: 65536\n- Tonemapping: ACES (exposure = +0.5)\n\n\u003cimg src=\"https://github.com/LuisaGroup/LuisaRenderScenes/raw/main/renders/living-room-2.png\" alt=\"Living Room 2\"/\u003e\n\n## The Modern Living Room\n\nDownload: [LuisaRender](https://github.com/LuisaGroup/LuisaRenderScenes/releases/download/scenes/living-room-3.zip)\n\n- Credit: [Wig42](http://www.blendswap.com/users/view/Wig42) ([CC BY 3.0](https://creativecommons.org/licenses/by/3.0/))\n- Converted from Tungsten version at [Rendering Resources](https://benedikt-bitterli.me/resources)\n- Resolution: 1280x720\n- Samples: 65536\n- Tonemapping: Uncharted2\n\n\u003cimg src=\"https://github.com/LuisaGroup/LuisaRenderScenes/raw/main/renders/living-room-3.png\" alt=\"Living Room 3\"/\u003e\n\n## Glass of Water\n\nDownload: [LuisaRender](https://github.com/LuisaGroup/LuisaRenderScenes/releases/download/scenes/glass-of-water.zip)\n\n- Credit: [aXel](http://www.blendswap.com/user/aXel) (CC0)\n- Converted from Tungsten version at [Rendering Resources](https://benedikt-bitterli.me/resources)\n- Resolution: 1920x1080\n- Samples: 16384\n- Tonemapping: Uncharted2\n\n\u003cimg src=\"https://github.com/LuisaGroup/LuisaRenderScenes/raw/main/renders/glass-of-water.png\" alt=\"Glass of Water\"/\u003e\n\n## Salle de bain\n\nDownload: [LuisaRender](https://github.com/LuisaGroup/LuisaRenderScenes/releases/download/scenes/bathroom2.zip)\n\n- Credit: [nacimus](http://www.blendswap.com/users/view/nacimus) ([CC BY 3.0](https://creativecommons.org/licenses/by/3.0/))\n- Converted from Tungsten version at [Rendering Resources](https://benedikt-bitterli.me/resources)\n- Resolution: 1280x720\n- Samples: 65536\n- Tonemapping: Uncharted2 (exposure = +1)\n\n\u003cimg src=\"https://github.com/LuisaGroup/LuisaRenderScenes/raw/main/renders/bathroom2.png\" alt=\"Salle de bain\"/\u003e\n\n\n## Lone Monk\n\nDownload: [LuisaRender](https://github.com/LuisaGroup/LuisaRenderScenes/releases/download/scenes/lone-monk.zip)\n\n- Credit: Carlo Bergonzini / [Monorender](http://www.monorender.com) ([CC-BY](https://creativecommons.org/licenses/by/2.0/))\n- Converted from Blender Cycles format at [Blender Demo Files](https://download.blender.org/demo/cycles/lone-monk_cycles_and_exposure-node_demo.blend)\n- Resolution: 6000x4000\n- Samples: 65536\n- Tonemapping: Uncharted2 (exposure = +1)\n\n\u003cimg src=\"https://github.com/LuisaGroup/LuisaRenderScenes/raw/main/renders/lone-monk.jpg\" alt=\"Lone Monk\"/\u003e\n\n\n## Sky Texture Demo\n\nDownload: [LuisaRender](https://github.com/LuisaGroup/LuisaRenderScenes/releases/download/scenes/sky-texture-demo.zip)\n\n- Credit: Blender Studio (CC0)\n- Converted from Blender Cycles format at [Blender Demo Files](https://download.blender.org/demo/cycles/lone-monk_cycles_and_exposure-node_demo.blend)\n- Resolution: 3840x2160\n- Samples: 1024\n- Tonemapping: Uncharted2 (exposure = +1)\n\n\u003cimg src=\"https://github.com/LuisaGroup/LuisaRenderScenes/raw/main/renders/sky-texture-demo.png\" alt=\"Sky Texture Demo\"/\u003e\n\n\n## Bathroom Interior\n\nDownload: [LuisaRender](https://github.com/LuisaGroup/LuisaRenderScenes/releases/download/scenes/bathroom-interior.zip)\n\n- Credit: [Akshaykhedkar97](https://sketchfab.com/3d-models/bathroom-interior-7609ef43ffc04cc280f1525ffdc6d89a) ([CC BY 4.0](https://creativecommons.org/licenses/by/4.0/))\n- Resolution: 1920x1080\n- Samples: 1024\n- Tonemapping: Uncharted2 (exposure = +0.5)\n\n\u003cimg src=\"https://github.com/LuisaGroup/LuisaRenderScenes/raw/main/renders/bathroom-interior.png\" alt=\"Bathroom Interior\"/\u003e\n\n## JINX!\n\nDownload: [LuisaRender](https://github.com/LuisaGroup/LuisaRenderScenes/releases/download/scenes/jinx.zip)\n\n- Credit: [eric3dee](https://sketchfab.com/3d-models/jinx-794dfd320a694a36a5e5a79fb594a5ef) ([CC BY 4.0](https://creativecommons.org/licenses/by/4.0/))\n- Camera and environment configuration from [GLSL-PathTracer](https://github.com/knightcrawler25/GLSL-PathTracer)\n- Resolution: 1920x1080\n- Samples: 4096\n- Tonemapping: Uncharted2\n\n\u003cimg src=\"https://github.com/LuisaGroup/LuisaRenderScenes/raw/main/renders/jinx.png\" alt=\"JINX!\"/\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fluisagroup%2Fluisarender","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fluisagroup%2Fluisarender","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fluisagroup%2Fluisarender/lists"}