Deploying to master from @ gfx-rs/wgpu@436f716 🚀

gfx-rs · Jan 21, 2025 · c2e2cc9 · c2e2cc9
1 parent 8c724c6
commit c2e2cc9
Show file tree

Hide file tree

Showing 56 changed files with 905 additions and 167 deletions.
diff --git a/doc/naga/all.html b/doc/naga/all.html
diff --git a/doc/naga/back/hlsl/enum.EntryPointError.html b/doc/naga/back/hlsl/enum.EntryPointError.html
diff --git a/doc/naga/back/hlsl/enum.Error.html b/doc/naga/back/hlsl/enum.Error.html
diff --git a/doc/naga/back/hlsl/enum.ShaderModel.html b/doc/naga/back/hlsl/enum.ShaderModel.html
diff --git a/doc/naga/back/hlsl/index.html b/doc/naga/back/hlsl/index.html
@@ -1,4 +1,4 @@
-<!DOCTYPE html><html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1.0"><meta name="generator" content="rustdoc"><meta name="description" content="Backend for HLSL (High-Level Shading Language)."><title>naga::back::hlsl - Rust</title><script>if(window.location.protocol!=="file:")document.head.insertAdjacentHTML("beforeend","SourceSerif4-Regular-6b053e98.ttf.woff2,FiraSans-Regular-0fe48ade.woff2,FiraSans-Medium-e1aa3f0a.woff2,SourceCodePro-Regular-8badfe75.ttf.woff2,SourceCodePro-Semibold-aa29a496.ttf.woff2".split(",").map(f=>`<link rel="preload" as="font" type="font/woff2" crossorigin href="../../../static.files/${f}">`).join(""))</script><link rel="stylesheet" href="../../../static.files/normalize-9960930a.css"><link rel="stylesheet" href="../../../static.files/rustdoc-46132b98.css"><meta name="rustdoc-vars" data-root-path="../../../" data-static-root-path="../../../static.files/" data-current-crate="naga" data-themes="" data-resource-suffix="" data-rustdoc-version="1.86.0-nightly (a580b5c37 2025-01-08)" data-channel="nightly" data-search-js="search-75f5ac3e.js" data-settings-js="settings-0f613d39.js" ><script src="../../../static.files/storage-59e33391.js"></script><script defer src="../sidebar-items.js"></script><script defer src="../../../static.files/main-5f194d8c.js"></script><noscript><link rel="stylesheet" href="../../../static.files/noscript-893ab5e7.css"></noscript><link rel="alternate icon" type="image/png" href="../../../static.files/favicon-32x32-6580c154.png"><link rel="icon" type="image/svg+xml" href="../../../static.files/favicon-044be391.svg"></head><body class="rustdoc mod"><!--[if lte IE 11]><div class="warning">This old browser is unsupported and will most likely display funky things.</div><![endif]--><nav class="mobile-topbar"><button class="sidebar-menu-toggle" title="show sidebar"></button></nav><nav class="sidebar"><div class="sidebar-crate"><h2><a href="../../../naga/index.html">naga</a><span class="version">24.0.0</span></h2></div><div class="sidebar-elems"><section id="rustdoc-toc"><h2 class="location"><a href="#">Module hlsl</a></h2><h3><a href="#">Sections</a></h3><ul class="block top-toc"><li><a href="#supported-shader-model-versions" title="Supported shader model versions:">Supported shader model versions:</a></li><li><a href="#layout-of-values-in-uniform-buffers" title="Layout of values in `uniform` buffers">Layout of values in <code>uniform</code> buffers</a><ul><li><a href="#row--and-column-major-ordering-for-matrices" title="Row- and column-major ordering for matrices">Row- and column-major ordering for matrices</a></li><li><a href="#padding-in-two-row-matrices" title="Padding in two-row matrices">Padding in two-row matrices</a></li></ul></li></ul><h3><a href="#structs">Module Items</a></h3><ul class="block"><li><a href="#structs" title="Structs">Structs</a></li><li><a href="#enums" title="Enums">Enums</a></li><li><a href="#types" title="Type Aliases">Type Aliases</a></li></ul></section><div id="rustdoc-modnav"><h2><a href="../index.html">In naga::<wbr>back</a></h2></div></div></nav><div class="sidebar-resizer"></div><main><div class="width-limiter"><rustdoc-search></rustdoc-search><section id="main-content" class="content"><div class="main-heading"><span class="rustdoc-breadcrumbs"><a href="../../index.html">naga</a>::<wbr><a href="../index.html">back</a></span><h1>Module <span>hlsl</span><button id="copy-path" title="Copy item path to clipboard">Copy item path</button></h1><rustdoc-toolbar></rustdoc-toolbar><span class="sub-heading"><a class="src" href="../../../src/naga/back/hlsl/mod.rs.html#1-358">Source</a> </span></div><details class="toggle top-doc" open><summary class="hideme"><span>Expand description</span></summary><div class="docblock"><p>Backend for <a href="https://docs.microsoft.com/en-us/windows/win32/direct3dhlsl/dx-graphics-hlsl">HLSL</a> (High-Level Shading Language).</p>
+<!DOCTYPE html><html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1.0"><meta name="generator" content="rustdoc"><meta name="description" content="Backend for HLSL (High-Level Shading Language)."><title>naga::back::hlsl - Rust</title><script>if(window.location.protocol!=="file:")document.head.insertAdjacentHTML("beforeend","SourceSerif4-Regular-6b053e98.ttf.woff2,FiraSans-Regular-0fe48ade.woff2,FiraSans-Medium-e1aa3f0a.woff2,SourceCodePro-Regular-8badfe75.ttf.woff2,SourceCodePro-Semibold-aa29a496.ttf.woff2".split(",").map(f=>`<link rel="preload" as="font" type="font/woff2" crossorigin href="../../../static.files/${f}">`).join(""))</script><link rel="stylesheet" href="../../../static.files/normalize-9960930a.css"><link rel="stylesheet" href="../../../static.files/rustdoc-46132b98.css"><meta name="rustdoc-vars" data-root-path="../../../" data-static-root-path="../../../static.files/" data-current-crate="naga" data-themes="" data-resource-suffix="" data-rustdoc-version="1.86.0-nightly (a580b5c37 2025-01-08)" data-channel="nightly" data-search-js="search-75f5ac3e.js" data-settings-js="settings-0f613d39.js" ><script src="../../../static.files/storage-59e33391.js"></script><script defer src="../sidebar-items.js"></script><script defer src="../../../static.files/main-5f194d8c.js"></script><noscript><link rel="stylesheet" href="../../../static.files/noscript-893ab5e7.css"></noscript><link rel="alternate icon" type="image/png" href="../../../static.files/favicon-32x32-6580c154.png"><link rel="icon" type="image/svg+xml" href="../../../static.files/favicon-044be391.svg"></head><body class="rustdoc mod"><!--[if lte IE 11]><div class="warning">This old browser is unsupported and will most likely display funky things.</div><![endif]--><nav class="mobile-topbar"><button class="sidebar-menu-toggle" title="show sidebar"></button></nav><nav class="sidebar"><div class="sidebar-crate"><h2><a href="../../../naga/index.html">naga</a><span class="version">24.0.0</span></h2></div><div class="sidebar-elems"><section id="rustdoc-toc"><h2 class="location"><a href="#">Module hlsl</a></h2><h3><a href="#">Sections</a></h3><ul class="block top-toc"><li><a href="#supported-shader-model-versions" title="Supported shader model versions:">Supported shader model versions:</a></li><li><a href="#layout-of-values-in-uniform-buffers" title="Layout of values in `uniform` buffers">Layout of values in <code>uniform</code> buffers</a><ul><li><a href="#row--and-column-major-ordering-for-matrices" title="Row- and column-major ordering for matrices">Row- and column-major ordering for matrices</a></li><li><a href="#padding-in-two-row-matrices" title="Padding in two-row matrices">Padding in two-row matrices</a></li><li><a href="#sampler-handling" title="Sampler Handling">Sampler Handling</a></li></ul></li></ul><h3><a href="#structs">Module Items</a></h3><ul class="block"><li><a href="#structs" title="Structs">Structs</a></li><li><a href="#enums" title="Enums">Enums</a></li><li><a href="#types" title="Type Aliases">Type Aliases</a></li></ul></section><div id="rustdoc-modnav"><h2><a href="../index.html">In naga::<wbr>back</a></h2></div></div></nav><div class="sidebar-resizer"></div><main><div class="width-limiter"><rustdoc-search></rustdoc-search><section id="main-content" class="content"><div class="main-heading"><span class="rustdoc-breadcrumbs"><a href="../../index.html">naga</a>::<wbr><a href="../index.html">back</a></span><h1>Module <span>hlsl</span><button id="copy-path" title="Copy item path to clipboard">Copy item path</button></h1><rustdoc-toolbar></rustdoc-toolbar><span class="sub-heading"><a class="src" href="../../../src/naga/back/hlsl/mod.rs.html#1-417">Source</a> </span></div><details class="toggle top-doc" open><summary class="hideme"><span>Expand description</span></summary><div class="docblock"><p>Backend for <a href="https://docs.microsoft.com/en-us/windows/win32/direct3dhlsl/dx-graphics-hlsl">HLSL</a> (High-Level Shading Language).</p>
 <h2 id="supported-shader-model-versions"><a class="doc-anchor" href="#supported-shader-model-versions">§</a>Supported shader model versions:</h2>
 <ul>
 <li>5.0</li>
@@ -77,5 +77,12 @@ <h3 id="padding-in-two-row-matrices"><a class="doc-anchor" href="#padding-in-two
 }</code></pre></div>
 <p>We also emit an analogous <code>Set</code> function, as well as functions for
 accessing individual columns by dynamic index.</p>
+<h3 id="sampler-handling"><a class="doc-anchor" href="#sampler-handling">§</a>Sampler Handling</h3>
+<p>Due to limitations in how sampler heaps work in D3D12, we need to access samplers
+through a layer of indirection. Instead of directly binding samplers, we bind the entire
+sampler heap as both a standard and a comparison sampler heap. We then use a sampler
+index buffer for each bind group. This buffer is accessed in the shader to get the actual
+sampler index within the heap. See the wgpu_hal dx12 backend documentation for more
+information.</p>
 </div></details><h2 id="structs" class="section-header">Structs<a href="#structs" class="anchor">§</a></h2><ul class="item-table"><li><div class="item-name"><a class="struct" href="struct.BindTarget.html" title="struct naga::back::hlsl::BindTarget">Bind<wbr>Target</a></div></li><li><div class="item-name"><a class="struct" href="struct.FragmentEntryPoint.html" title="struct naga::back::hlsl::FragmentEntryPoint">Fragment<wbr>Entry<wbr>Point</a></div><div class="desc docblock-short">A fragment entry point to be considered when generating HLSL for the output interface of vertex
-entry points.</div></li><li><div class="item-name"><a class="struct" href="struct.Options.html" title="struct naga::back::hlsl::Options">Options</a></div><div class="desc docblock-short">Configuration used in the <a href="struct.Writer.html" title="struct naga::back::hlsl::Writer"><code>Writer</code></a>.</div></li><li><div class="item-name"><a class="struct" href="struct.ReflectionInfo.html" title="struct naga::back::hlsl::ReflectionInfo">Reflection<wbr>Info</a></div><div class="desc docblock-short">Reflection info for entry point names.</div></li><li><div class="item-name"><a class="struct" href="struct.Writer.html" title="struct naga::back::hlsl::Writer">Writer</a></div></li></ul><h2 id="enums" class="section-header">Enums<a href="#enums" class="anchor">§</a></h2><ul class="item-table"><li><div class="item-name"><a class="enum" href="enum.EntryPointError.html" title="enum naga::back::hlsl::EntryPointError">Entry<wbr>Point<wbr>Error</a></div></li><li><div class="item-name"><a class="enum" href="enum.Error.html" title="enum naga::back::hlsl::Error">Error</a></div></li><li><div class="item-name"><a class="enum" href="enum.ShaderModel.html" title="enum naga::back::hlsl::ShaderModel">Shader<wbr>Model</a></div><div class="desc docblock-short">A HLSL shader model version.</div></li></ul><h2 id="types" class="section-header">Type Aliases<a href="#types" class="anchor">§</a></h2><ul class="item-table"><li><div class="item-name"><a class="type" href="type.BindingMap.html" title="type naga::back::hlsl::BindingMap">Binding<wbr>Map</a></div></li></ul></section></div></main></body></html>
+entry points.</div></li><li><div class="item-name"><a class="struct" href="struct.Options.html" title="struct naga::back::hlsl::Options">Options</a></div><div class="desc docblock-short">Configuration used in the <a href="struct.Writer.html" title="struct naga::back::hlsl::Writer"><code>Writer</code></a>.</div></li><li><div class="item-name"><a class="struct" href="struct.ReflectionInfo.html" title="struct naga::back::hlsl::ReflectionInfo">Reflection<wbr>Info</a></div><div class="desc docblock-short">Reflection info for entry point names.</div></li><li><div class="item-name"><a class="struct" href="struct.SamplerHeapBindTargets.html" title="struct naga::back::hlsl::SamplerHeapBindTargets">Sampler<wbr>Heap<wbr>Bind<wbr>Targets</a></div></li><li><div class="item-name"><a class="struct" href="struct.SamplerIndexBufferKey.html" title="struct naga::back::hlsl::SamplerIndexBufferKey">Sampler<wbr>Index<wbr>Buffer<wbr>Key</a></div></li><li><div class="item-name"><a class="struct" href="struct.Writer.html" title="struct naga::back::hlsl::Writer">Writer</a></div></li></ul><h2 id="enums" class="section-header">Enums<a href="#enums" class="anchor">§</a></h2><ul class="item-table"><li><div class="item-name"><a class="enum" href="enum.EntryPointError.html" title="enum naga::back::hlsl::EntryPointError">Entry<wbr>Point<wbr>Error</a></div></li><li><div class="item-name"><a class="enum" href="enum.Error.html" title="enum naga::back::hlsl::Error">Error</a></div></li><li><div class="item-name"><a class="enum" href="enum.ShaderModel.html" title="enum naga::back::hlsl::ShaderModel">Shader<wbr>Model</a></div><div class="desc docblock-short">A HLSL shader model version.</div></li></ul><h2 id="types" class="section-header">Type Aliases<a href="#types" class="anchor">§</a></h2><ul class="item-table"><li><div class="item-name"><a class="type" href="type.BindingMap.html" title="type naga::back::hlsl::BindingMap">Binding<wbr>Map</a></div></li><li><div class="item-name"><a class="type" href="type.SamplerIndexBufferBindingMap.html" title="type naga::back::hlsl::SamplerIndexBufferBindingMap">Sampler<wbr>Index<wbr>Buffer<wbr>Binding<wbr>Map</a></div></li></ul></section></div></main></body></html>
diff --git a/doc/naga/back/hlsl/sidebar-items.js b/doc/naga/back/hlsl/sidebar-items.js