Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/pablode/gatling
Hydra-enabled GPU path tracer that supports MaterialX and MDL
https://github.com/pablode/gatling
gpu hydra materialx mdl path-tracing ray-tracing usd vulkan
Last synced: about 2 months ago
JSON representation
Hydra-enabled GPU path tracer that supports MaterialX and MDL
- Host: GitHub
- URL: https://github.com/pablode/gatling
- Owner: pablode
- License: gpl-3.0
- Created: 2019-11-11T09:47:01.000Z (almost 5 years ago)
- Default Branch: master
- Last Pushed: 2024-08-03T17:52:42.000Z (about 2 months ago)
- Last Synced: 2024-08-03T19:03:29.086Z (about 2 months ago)
- Topics: gpu, hydra, materialx, mdl, path-tracing, ray-tracing, usd, vulkan
- Language: C++
- Homepage:
- Size: 1.96 MB
- Stars: 281
- Watchers: 10
- Forks: 17
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-openusd - gatling - based path tracer. (Libraries & Tools / Hydra)
README
## gatling
Evermotion Scene 06 AI48, rendered in Gatling using Blender's Hydra/MaterialX support.
Porsche 911 GT3, modified with materials from the GPUOpen MaterialX library.
### About
This is my toy path tracer I work on in my free time.
It is exposed as a Hydra render delegate and comes with a standalone that accepts [Universal Scene Description](https://graphics.pixar.com/usd/release/intro.html) (USD) files. It is cross-platform\*, GPU-accelerated, and implements the [MaterialX](https://www.materialx.org/index.html), [NVIDIA MDL](https://www.nvidia.com/en-us/design-visualization/technologies/material-definition-language/) and [UsdPreviewSurface](https://graphics.pixar.com/usd/release/spec_usdpreviewsurface.html) material standards.
Complex BSDFs like [OpenPBR](https://academysoftwarefoundation.github.io/OpenPBR/), Autodesk's Standard Surface, and the glTF shading model are supported using MaterialX and its MDL code generation backend. The MDL SDK is used to generate evaluation and importance sampling functions as GLSL code, which is compiled to SPIR-V and executed with Vulkan.
\* Hardware ray tracing is required. MacOS will be supported [in the future](https://github.com/KhronosGroup/MoltenVK/issues/427).
### Build
There are [prebuilt binaries](https://github.com/pablode/gatling/releases) which can be copied to the `/plugin/usd` directory.
Alternatively, for a full source build you need to
- download the MDL SDK (2022.0+) binaries
- download or build USD 24.03 with MaterialX support
> Note: it is recommended to have NASM 2.13+ or YASM 1.2.0+ in your PATH to speed up image decoding.
Do a recursive clone of the repository and set up a build folder:
```
git clone https://github.com/pablode/gatling --recursive
mkdir gatling/build && cd gatling/build
```
Pass following parameters in the CMake generation phase:
```
cmake .. -Wno-dev \
-DUSD_ROOT= \
-DMDL_ROOT= \
-DCMAKE_INSTALL_PREFIX=/plugin/usd
-DCMAKE_BUILD_TYPE=Release
```
Build the relevant targets and install the Hydra delegate to the USD plugin folder:
```
cmake --build . --target hdGatling --config Release
cmake --install . --component hdGatling
```
### Usage
Gatling can be used by every application which supports Hydra, either natively or through a plugin.
Alex Treviño's Junk Shop (CC BY), distilled to UsdPreviewSurfaces, rendered within usdview.
A headless standalone is provided that accepts a USD file (.usd, .usda, .usdc, .usdz) as input. It exposes the Hydra render settings as command line arguments:
```
./bin/gatling render.png \
--image-width 1200 \
--image-height 1200 \
--spp 1024 \
--max-bounces 8
```
> Note: high sample counts may require adjusting the system watchdog settings.
### Issues
* Features: certain USD prim types (curves, cylinder lights), APIs (UsdLuxShapingAPI, UsdLuxShadowAPI) and features (GeomSubset, subdivision) are not yet supported. UDIM textures, volumes, displacement and other rendering features have yet to be implemented.
* Arbitrary primvar reading: Gatling currently does not implement MDL scene data, which means that MaterialX `geompropvalue` and UsdPreviewSurface `UsdPrimvarReader` nodes are unsupported.
* Real-time editing: changing material parameters, transforming meshes or instances, and adjusting render settings currently result in full or partial cache rebuilds.
### License
Gatling is licensed under the GNU General Public License, as included in the [LICENSE](LICENSE) file.
```
Copyright (C) 2019 Pablo Delgado Krämer
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program. If not, see .
```
Licenses of third-party code and libraries are listed in the same file.