> ## 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 (consolas XBOX Series)

> El método ID3D12GraphicsCommandList5::RSSetShadingRate (d3d12.h) establece la velocidad de sombreado base y los combinadores para el sombreado de velocidad variable (VRS).

Establece la velocidad de sombreado base y los combinadores para el sombreado de velocidad variable (VRS). Para obtener más información, consulte [Sombreado de velocidad variable (VRS)](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/vrs).

## Sintaxis

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

### Parámetros

*baseShadingRate*\
Tipo: D3D12\_SHADING\_RATE

Una constante de la enumeración [D3D12\_SHADING\_RATE](/reference/graphics/d3d12/enums/d3d12_shading_rate_public) que describe la velocidad de sombreado base que se va a establecer.

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

Un puntero opcional a una matriz constante de [**D3D12\_SHADING\_RATE\_COMBINER**](/reference/graphics/d3d12/enums/d3d12_shading_rate_combiner_public) que contiene los combinadores de velocidad de sombreado que se van a establecer. El número de elementos [**D3D12\_SHADING\_RATE\_COMBINER**](/reference/graphics/d3d12/enums/d3d12_shading_rate_combiner_public) de la matriz debe ser igual a la constante [**D3D12\_RS\_SET\_SHADING\_RATE\_COMBINER\_COUNT**](https://learn.microsoft.com/en-us/windows/win32/direct3d12/constants), que es igual a **2**.

Dado que el VRS por primitiva y basado en imágenes de espacio de pantalla no se admite en el nivel Tier1 de [Sombreado de velocidad variable (VRS)](https://learn.microsoft.com/en-us/windows/win32/direct3d12/vrs), para que estos valores sean significativos, el adaptador requiere compatibilidad con VRS de nivel Tier2. Consulte [**D3D12\_FEATURE\_DATA\_D3D12\_OPTIONS6**](/reference/graphics/d3d12/structs/d3d12_feature_data_d3d12_options6_public) y [**D3D12\_VARIABLE\_SHADING\_RATE\_TIER**](/reference/graphics/d3d12/enums/d3d12_variable_shading_rate_tier_public).

Un puntero **NULL** es equivalente a los combinadores de sombreado predeterminados, que son ambos [**D3D12\_SHADING\_RATE\_COMBINER\_PASSTHROUGH**](/reference/graphics/d3d12/enums/d3d12_shading_rate_combiner_public).

El algoritmo para la velocidad de sombreado final se determina de la siguiente manera.

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

donde `ApplyCombiner` es

```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 devuelto

Tipo: void

Ninguno.

## Comentarios

## Requisitos

**Encabezado:** d3d12\_xs.h\
**Biblioteca:** d3d12\_xs.lib\
**Plataformas compatibles**: consolas XBOX Series

## Consulte también

[Sombreado de velocidad variable (VRS)](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/vrs)


## Related topics

- [RSSetShadingRateImage (consolas XBOX Series)](/es/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist5/methods/id3d12graphicscommandlist5_rssetshadingrateimage_public.md)
- [D3D12_SHADING_RATE (consolas XBOX Series)](/es/reference/graphics/d3d12/enums/d3d12_shading_rate_public.md)
- [D3D12_AXIS_SHADING_RATE (consolas XBOX Series)](/es/reference/graphics/d3d12/enums/d3d12_axis_shading_rate_public.md)
- [SetPipelineState1 (consolas XBOX Series)](/es/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist4/methods/id3d12graphicscommandlist4_setpipelinestate1_public.md)
- [SetPipelineStackSize (consolas XBOX Series)](/es/reference/graphics/d3d12/interfaces/id3d12stateobjectproperties/methods/id3d12stateobjectproperties_setpipelinestacksize_public.md)
