claude_code/procedural-3d-engine
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
procedural-3d-engine/data/hlsl/README.md

100 lines
8.7 KiB
Markdown
Raw Normal View History

Add shaders re-implemented in HLSL These were written against the shaders at revision eddd724e7. There have been changes made since then, which will need to be mirrored. See `data/hlsl/README.md` for the current status of each sample.
2020-05-21 10:20:19 +00:00
## HLSL Shaders
This directory contains a fork of the shaders found in [data/shaders](https://github.com/SaschaWillems/Vulkan/tree/master/data/shaders), re-written in HLSL.
These can be compiled with [DXC](https://github.com/microsoft/DirectXShaderCompiler) using the `compile.py` script.
### Status
Tested on Ubuntu 18.04 + GeForce RTX 2080 Ti
Shaders written to mirror the GLSL versions at `eddd724`. There have been changes made to the GLSL shaders since then, which will need to be updated.
Fix data/hlsl/README.md table header The right most column header SHA was wrong.
2020-05-21 16:07:13 +01:00
| Name | GLSL @`eddd724e7` | HLSL @`eddd724e7` | GLSL @`10a1ecaf7` | HLSL @`10a1ecaf7`
Add shaders re-implemented in HLSL These were written against the shaders at revision eddd724e7. There have been changes made since then, which will need to be mirrored. See `data/hlsl/README.md` for the current status of each sample.
2020-05-21 10:20:19 +00:00
|----------------------------|-------------------|-------------------|-------------------|-------------------
| bloom | ☑ | ☑ | ☑ | ☑
| computecloth | ☑ | ☑ | ☑ | ☑
| computecullandlod | ☑ | ☑ | ☑ | ☑
| computeheadless | ☑ | ☑ | ☑ | ☑
| computenbody | ☑ | ☑ | ☑ | ☑
| computeparticles | ☑ | ❌ | ☑ | ❌
| computeraytracing | ☑ | ☑ | ☑ | ☑
| computeshader | ☑ | ☑ | ☑ | ☑
| conditionalrender | ☑ | ☑ | ☑ | ☑
| conservativeraster | ☑ | ☑ | ☑ | ☑
| debugmarker | ☑ | ☑ | ☑ | ☑
| deferred | ☑ | ☑ | ☑ | ☑
| deferredmultisampling | ☑ | ☑ | ☑ | ☑
| deferredshadows | ☑ | ☑ | ☑ | ☑
| descriptorsets | ☑ | ☑ | ☑ | ☑
| displacement | ☑ | ☑ | ☑ | ☑
| distancefieldfonts | ☑ | ☑ | ☑ | ☑
| dynamicuniformbuffer | ☑ | ☑ | ☑ | ☑
| gears | ☑ | ☑ | ☑ | ☑
| geometryshader | ☑ | ☑ | ☑ | ☑
Add HLSL shaders for glftscene sample
2020-05-21 14:27:10 +01:00
| gltfscene | - | - | ☑ | ☑
Add missing inverseModelView UBO to fix hdr sample
2020-05-21 14:39:30 +01:00
| hdr | ☑ | ❌ | ☑ | ☑
Add shaders re-implemented in HLSL These were written against the shaders at revision eddd724e7. There have been changes made since then, which will need to be mirrored. See `data/hlsl/README.md` for the current status of each sample.
2020-05-21 10:20:19 +00:00
| imgui | ☑ | ☑ | ☑ | ☑
| indirectdraw | ☑ | ☑ | ☑ | ☑
| inlineuniformblocks | ☑ | ☑ | ☑ | ☑
| inputattachments | ☑ | ☑ | ☑ | ☑
| instancing | ☑ | ☑ | ☑ | ☑
| mesh | ☑ | ☑ | ❌ | ☑
Add HLSL shaders for multisampling sample
2020-05-21 14:51:08 +01:00
| multisampling | ☑ | ☑ | ☑ | ☑
Add shaders re-implemented in HLSL These were written against the shaders at revision eddd724e7. There have been changes made since then, which will need to be mirrored. See `data/hlsl/README.md` for the current status of each sample.
2020-05-21 10:20:19 +00:00
| multithreading | ☑ | ☑ | ☑ | ☑
| multiview | ☑ | ☑ | ☑ | ☑
| negativeviewportheight | ☑ | ☑ | ☑ | ☑
| nv_ray_tracing_basic | ☑ | ☑ | ☑ | ☑
| nv_ray_tracing_reflections | ☑ | ☑ | ☑ | ☑
| nv_ray_tracing_shadows | ☑ | ☑ | ☑ | ☑
| occlusionquery | ☑ | ☑ | ☑ | ☑
Apply ab38f8b1's changes to offscreen HLSL shaders
2020-05-21 15:01:41 +01:00
| offscreen | ☑ | ☑ | ☑ | ☑
Add shaders re-implemented in HLSL These were written against the shaders at revision eddd724e7. There have been changes made since then, which will need to be mirrored. See `data/hlsl/README.md` for the current status of each sample.
2020-05-21 10:20:19 +00:00
| parallaxmapping | ☑ | ☑ | ☑ | ☑
| particlefire | ☑ | ☑ | ☑ | ☑
| pbrbasic | ☑ | ☑ | ☑ | ☑
| pbribl | ☑ | ☑ | ☑ | ☑
| pbrtexture | ☑ | ☑ | ☑ | ☑
| pipelines | ☑ | ☑ | ☑ | ☑
| pipelinestatistics | ☑ | ☑ | ☑ | ☑
| pushconstants | ☑ | ☑ | ☑ | ☑
| pushdescriptors | ☑ | ☑ | ☑ | ☑
| radialblur | ☑ | ☑ | ☑ | ☑
| renderheadless | ☑ | ☑ | ☑ | ☑
| scenerendering | ☑ | ☑ | ☑ | ☑
| screenshot | ☑ | ☑ | ☑ | ☑
| shadowmapping | ☑ | ☑ | ☑ | ☑
| shadowmappingcascade | ☑ | ☑ | ☑ | ☑
| shadowmappingomni | ☑ | ☑ | ☑ | ☑
Update HLSL skeletalanimation shaders with latest changes
2020-05-21 15:18:00 +01:00
| skeletalanimation | ☑ | ☑ | ☑ | ☑
Add shaders re-implemented in HLSL These were written against the shaders at revision eddd724e7. There have been changes made since then, which will need to be mirrored. See `data/hlsl/README.md` for the current status of each sample.
2020-05-21 10:20:19 +00:00
| specializationconstants | ☑ | ☑ | ☑ | ☑
| sphericalenvmapping | ☑ | ☑ | ☑ | ☑
| ssao | ☑ | ☑ | ☑ | ☑
| stencilbuffer | ☑ | ☑ | ☑ | ☑
| subpasses | ☑ | ☑ | ☑ | ☑
| terraintessellation | ☑ | ☑ | ☑ | ☑
| tessellation | ☑ | ☑ | ☑ | ☑
| textoverlay | ☑ | ☑ | ☑ | ☑
| texture | ☑ | ☑ | ☑ | ☑
| texture3d | ☑ | ☑ | ☑ | ☑
| texturearray | ☑ | ☑ | ☑ | ☑
| texturecubemap | ☑ | ❌ | ☑ | ❌
| texturemipmapgen | ☑ | ☑ | ☑ | ☑
| texturesparseresidency | ☑ | ☑ | ☑ | ☑
| triangle | ☑ | ☑ | ☑ | ☑
| viewportarray | ☑ | ☑ | ☑ | ☑
| vulkanscene | ☑ | ☑ | ☑ | ☑
### Known issues
- specialization constants can't be used to specify array size.
- `gl_PointCoord` not supported. HLSL has no equivalent. We changed the shaders to calulate the PointCoord manually in the shader. (`computenbody`, `computeparticles`, `particlefire` examples).
- HLSL doesn't have inverse operation (`deferred`, `hdr`, `instancing`, `skeletalanimation` & `texturecubemap` examples).
- `modf` causes compilation to fail without errors or warnings. (`modf` not used by any examples, easily confused with fmod)
- In `specializationconstants` example, shader compilation fails with error:
```
--- Error msg: fatal error: failed to optimize SPIR-V: Id 10 is defined more than once
```
When multiple constant ids are defined and have different types. We work around this problem by making all constant ids the same type, then use `asfloat`, `asint` or `asuint` to get the original value in the shader.
- `gl_RayTmaxNV` not supported. (`nv_ray_tracing_*` examples)
- HLSL interface for sparse residency textures is different from GLSL interface. After translating from HLSL to GLSL the shaders behave slightly different. Most important parts do behave identically though.
Reference in a new issue Copy permalink