Generates HLSL shader code using StringBuilder patterns and embedded builtin headers.
npx skills add https://github.com/LuisaGroup/LuisaCompute --skill hlsl
Please help me install this Agent Skill. Skill: hlsl Source: https://github.com/LuisaGroup/LuisaCompute/tree/main/.agents/skills/hlsl Command: npx skills add https://github.com/LuisaGroup/LuisaCompute --skill hlsl
Writing HLSL code generators in C++ involves repetitive string concatenation, formatting boilerplate, and managing embedded shader headers. This Skill documents the StringBuilder utilities, codegen patterns, and builtin header registry used in LuisaCompute's DirectX and Vulkan backends so you can generate shader source correctly and efficiently.
vstd::StringBuilder, vstd::to_string, and luisa::format while avoiding unnecessary allocations..bytes and .dxil builtins (ray tracing, bindless textures, BC6/BC7 compression, autodiff) via lc_hlsl::get_hlsl_builtin, and register new ones with LC_HLSL_DECL_VARNAME macros.LUISA_DUMP_SOURCE=1 to inspect the generated shader output.Ask the assistant to generate an HLSL function declaration for a kernel with float3 arguments using the StringBuilder codegen patterns from this Skill.
High-intent search queries and answers about installing and using this skill.
Use vstd::StringBuilder with operator<< for chaining and operator+= for single items. Prefer "text"sv string-view literals to avoid allocations, and use vstd::to_string for integers since it is faster than luisa::format.
Include backends/common/hlsl/builtin/hlsl_builtin.hpp and call lc_hlsl::get_hlsl_builtin with a key like "hlsl_header". The returned struct provides a pointer and size you can convert to a std::string_view.
Add the .bytes or .dxil file to src/backends/common/hlsl/builtin/, declare it with LC_HLSL_DECL_VARNAME(my_bytes), and register it with LC_HLSL_INSERT_VARNAME(my_bytes, "my_key"). The build converts .hlsl to .bytes and shaders to .dxil via bin2obj.
Set the environment variable LUISA_DUMP_SOURCE=1 to write per-shader files named hlsl_output_<shader_name>.hlsl in the working directory. Naming priority uses ShaderOption::name, then Function::name(), then the function hash in hex.
No. Vulkan user compute shaders must use native SPIR-V codegen via LUISA_XIR_TO_SPIRV or LUISA_AST_LLVM_TO_SPIRV. The Vulkan Function compute path must not call HLSL/DXC; only internal builtin helpers compile HLSL to SPIR-V.
Appending a comma after every item leaves a trailing comma before the closing parenthesis. Fix it by overwriting the last character: if the list is non-empty, set str[str.size() - 1] = ')', otherwise just append ')'.
brandon-fryslieDocument the oscilla-naga-shim Rust DSL for WGSL-to-Naga AST translation.
githubWrite, review, and optimize Slang shaders for cross-platform GPU pipelines.
quazfentonAnalyze RenderDoc .rdc captures headlessly to inspect frames, shaders, and resources.
L3DigitalNetGuide Qt application structuring with entry-point patterns for PySide6 and C++.