https://github.com/joaosaffran updated https://github.com/llvm/llvm-project/pull/131011
>From b13609de4e66c1b4574264b553594fab47a1b08f Mon Sep 17 00:00:00 2001 From: joaosaffran <126493771+joaosaff...@users.noreply.github.com> Date: Wed, 12 Mar 2025 11:36:06 -0700 Subject: [PATCH 1/2] Adding Static Sampler Documentation --- llvm/docs/DirectX/DXContainer.rst | 45 +++++++++++++++++++++++++++++++ 1 file changed, 45 insertions(+) diff --git a/llvm/docs/DirectX/DXContainer.rst b/llvm/docs/DirectX/DXContainer.rst index 40c088462a452..8d32ad02d5e6a 100644 --- a/llvm/docs/DirectX/DXContainer.rst +++ b/llvm/docs/DirectX/DXContainer.rst @@ -612,3 +612,48 @@ RootDescriptorTable provides basic table structure: #. **NumDescriptorRanges**: Number of descriptor ranges #. **DescriptorRangesOffset**: Offset to descriptor range array +Static Samplers +~~~~~~~~~~~~~~~ + +Static samplers provide a way to define fixed sampler states within the root signature itself. + +.. code-block:: cpp + + struct StaticSamplerDesc { + FilterMode Filter; + TextureAddressMode AddressU; + TextureAddressMode AddressV; + TextureAddressMode AddressW; + float MipLODBias; + uint32_t MaxAnisotropy; + ComparisonFunc ComparisonFunc; + StaticBorderColor BorderColor; + float MinLOD; + float MaxLOD; + uint32_t ShaderRegister; + uint32_t RegisterSpace; + ShaderVisibility ShaderVisibility; + }; + + +The StaticSamplerDesc structure defines all properties of a static sampler: + +#. Filter: The filtering mode (e.g., point, linear, anisotropic) used for texture sampling. + For details, check `Direct X documentation <https://learn.microsoft.com/en-us/windows/win32/api/d3d12/ne-d3d12-d3d12_filter#syntax>`_. +#. AddressU: The addressing mode for the U texture coordinate. + For details, check `Direct X documentation <https://learn.microsoft.com/en-us/windows/win32/api/d3d12/ne-d3d12-d3d12_texture_address_mode>`_. +#. AddressV: The addressing mode for the V texture coordinate. +#. AddressW: The addressing mode for the W texture coordinate. +#. MipLODBias: Bias value applied to mipmap level of detail calculations. +#. MaxAnisotropy: Maximum anisotropy level when using anisotropic filtering. +#. ComparisonFunc: Comparison function used for comparison samplers. + For details, check `Direct X documentation <https://learn.microsoft.com/en-us/windows/win32/api/d3d12/ne-d3d12-d3d12_comparison_func>`_. +#. BorderColor: Predefined border color used when address mode is set to border. + For details, check `Direct X documentation <https://learn.microsoft.com/en-us/windows/win32/api/d3d12/ne-d3d12-d3d12_static_border_color>`_. +#. MinLOD: Minimum level of detail to use for sampling. +#. MaxLOD: Maximum level of detail to use for sampling. +#. ShaderRegister: The shader sampler register (s#) where this sampler is bound. +#. RegisterSpace: The register space used for the binding. +#. ShaderVisibility: Specifies which shader stages can access this sampler. + For details, check `Direct X documentation <https://learn.microsoft.com/en-us/windows/win32/api/d3d12/ne-d3d12-d3d12_shader_visibility>`_. + >From 4525033d87b787d1530be8522f6bf2b5ab8aa5d4 Mon Sep 17 00:00:00 2001 From: joaosaffran <126493771+joaosaff...@users.noreply.github.com> Date: Wed, 12 Mar 2025 11:56:22 -0700 Subject: [PATCH 2/2] Update DXContainer.rst --- llvm/docs/DirectX/DXContainer.rst | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/llvm/docs/DirectX/DXContainer.rst b/llvm/docs/DirectX/DXContainer.rst index 8d32ad02d5e6a..dadb91f225bb5 100644 --- a/llvm/docs/DirectX/DXContainer.rst +++ b/llvm/docs/DirectX/DXContainer.rst @@ -639,21 +639,21 @@ Static samplers provide a way to define fixed sampler states within the root sig The StaticSamplerDesc structure defines all properties of a static sampler: #. Filter: The filtering mode (e.g., point, linear, anisotropic) used for texture sampling. - For details, check `Direct X documentation <https://learn.microsoft.com/en-us/windows/win32/api/d3d12/ne-d3d12-d3d12_filter#syntax>`_. + For details, check `Static Sampler Fileters definition. <https://learn.microsoft.com/en-us/windows/win32/api/d3d12/ne-d3d12-d3d12_filter#syntax>`_. #. AddressU: The addressing mode for the U texture coordinate. - For details, check `Direct X documentation <https://learn.microsoft.com/en-us/windows/win32/api/d3d12/ne-d3d12-d3d12_texture_address_mode>`_. + For details, check `Texture address mode definition. <https://learn.microsoft.com/en-us/windows/win32/api/d3d12/ne-d3d12-d3d12_texture_address_mode>`_. #. AddressV: The addressing mode for the V texture coordinate. #. AddressW: The addressing mode for the W texture coordinate. #. MipLODBias: Bias value applied to mipmap level of detail calculations. #. MaxAnisotropy: Maximum anisotropy level when using anisotropic filtering. #. ComparisonFunc: Comparison function used for comparison samplers. - For details, check `Direct X documentation <https://learn.microsoft.com/en-us/windows/win32/api/d3d12/ne-d3d12-d3d12_comparison_func>`_. + For details, check `Comparison Function definition. <https://learn.microsoft.com/en-us/windows/win32/api/d3d12/ne-d3d12-d3d12_comparison_func>`_. #. BorderColor: Predefined border color used when address mode is set to border. - For details, check `Direct X documentation <https://learn.microsoft.com/en-us/windows/win32/api/d3d12/ne-d3d12-d3d12_static_border_color>`_. + For details, check `Static border color <https://learn.microsoft.com/en-us/windows/win32/api/d3d12/ne-d3d12-d3d12_static_border_color>`_. #. MinLOD: Minimum level of detail to use for sampling. #. MaxLOD: Maximum level of detail to use for sampling. #. ShaderRegister: The shader sampler register (s#) where this sampler is bound. #. RegisterSpace: The register space used for the binding. #. ShaderVisibility: Specifies which shader stages can access this sampler. - For details, check `Direct X documentation <https://learn.microsoft.com/en-us/windows/win32/api/d3d12/ne-d3d12-d3d12_shader_visibility>`_. + For details, check `Sahder Visibility definition. <https://learn.microsoft.com/en-us/windows/win32/api/d3d12/ne-d3d12-d3d12_shader_visibility>`_. _______________________________________________ llvm-branch-commits mailing list llvm-branch-commits@lists.llvm.org https://lists.llvm.org/cgi-bin/mailman/listinfo/llvm-branch-commits