> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# RSSetShadingRate (consoles XBOX Series)

> O método ID3D12GraphicsCommandList5::RSSetShadingRate (d3d12.h) define a taxa de sombreamento base e os combinadores para o sombreamento de taxa variável (VRS).

Define a taxa de sombreamento base e os combinadores para o sombreamento de taxa variável (VRS). Para obter mais informações, consulte [Sombreamento de taxa variável (VRS)](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/vrs).

## Sintaxe

```cpp theme={null}
void RSSetShadingRate(
    D3D12_SHADING_RATE baseShadingRate,
    const D3D12_SHADING_RATE_COMBINER  combiners
)
```

### Parâmetros

*baseShadingRate*\
Tipo: D3D12\_SHADING\_RATE

Uma constante da enumeração [D3D12\_SHADING\_RATE](/pt-BR/reference/graphics/d3d12/enums/d3d12_shading_rate_public) que descreve a taxa de sombreamento base a ser definida.

*combiners*\
Tipo: const D3D12\_SHADING\_RATE\_COMBINER \*

Um ponteiro opcional para uma matriz constante de [**D3D12\_SHADING\_RATE\_COMBINER**](/pt-BR/reference/graphics/d3d12/enums/d3d12_shading_rate_combiner_public) que contém os combinadores de taxa de sombreamento a serem definidos. A contagem de elementos [**D3D12\_SHADING\_RATE\_COMBINER**](/pt-BR/reference/graphics/d3d12/enums/d3d12_shading_rate_combiner_public) na matriz deve ser igual à constante [**D3D12\_RS\_SET\_SHADING\_RATE\_COMBINER\_COUNT**](https://learn.microsoft.com/en-us/windows/win32/direct3d12/constants), que é igual a **2**.

Como o VRS por primitivo e baseado em imagem de espaço de tela não tem suporte no [Sombreamento de taxa variável (VRS)](https://learn.microsoft.com/en-us/windows/win32/direct3d12/vrs) de Tier1, para que esses valores sejam significativos, o adaptador requer suporte a VRS de Tier2. Consulte [**D3D12\_FEATURE\_DATA\_D3D12\_OPTIONS6**](/pt-BR/reference/graphics/d3d12/structs/d3d12_feature_data_d3d12_options6_public) e [**D3D12\_VARIABLE\_SHADING\_RATE\_TIER**](/pt-BR/reference/graphics/d3d12/enums/d3d12_variable_shading_rate_tier_public).

Um ponteiro **NULL** equivale aos combinadores de sombreamento padrão, que são ambos [**D3D12\_SHADING\_RATE\_COMBINER\_PASSTHROUGH**](/pt-BR/reference/graphics/d3d12/enums/d3d12_shading_rate_combiner_public).

O algoritmo da taxa de sombreamento final é determinado pelo seguinte.

```cpp theme={null}
postRasterizerRate = ApplyCombiner(Combiners[0], CommandListShadingRate, Primitive->PrimitiveSpecifiedShadingRate);
finalRate = ApplyCombiner(Combiners[1], postRasterizerRate, ScreenSpaceImage[xy]);
```

em que `ApplyCombiner` é

```cpp theme={null}
UINT ApplyCombiner(D3D12_SHADING_RATE_COMBINER combiner, UINT a, UINT b)
{
MaxShadingRate = options6.AdditionalShadingRatesSupported ? 4 : 2;
switch (combiner)
{
case D3D12_SHADING_RATE_COMBINER_PASSTHROUGH: // default
return a;
case D3D12_SHADING_RATE_COMBINER_OVERRIDE:
return b;
case D3D12_SHADING_RATE_COMBINER_MAX:
return max(a, b);
case D3D12_SHADING_RATE_COMBINER_MIN:
return min(a, b);
case D3D12_SHADING_RATE_COMBINER_SUM:
return min(MaxShadingRate, a + b);
case default:
return a;
}
}
```

### Valor retornado

Tipo: void

Nenhum.

## Comentários

## Requisitos

**Cabeçalho:** d3d12\_xs.h\
**Biblioteca:** d3d12\_xs.lib\
**Plataformas com suporte**: consoles XBOX Series

## Confira também

[Sombreamento de taxa variável (VRS)](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/vrs)


## Related topics

- [RSSetShadingRateImage (consoles XBOX Series)](/pt-BR/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist5/methods/id3d12graphicscommandlist5_rssetshadingrateimage_public.md)
- [D3D12_SHADING_RATE (consoles XBOX Series)](/pt-BR/reference/graphics/d3d12/enums/d3d12_shading_rate_public.md)
- [D3D12_AXIS_SHADING_RATE (consoles XBOX Series)](/pt-BR/reference/graphics/d3d12/enums/d3d12_axis_shading_rate_public.md)
- [Variable Rate Shading (VRS) no XBOX Series X|S](/pt-BR/build/core-features/graphics/newfeatures/vrs/index.md)
- [SetPipelineState1 (consoles XBOX Series)](/pt-BR/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist4/methods/id3d12graphicscommandlist4_setpipelinestate1_public.md)