> ## 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.

# Ombrage à taux variable (VRS) dans PIX

> Ombrage à taux variable (VRS) dans PIX

Dans PIX, différentes zones permettent de trouver diverses informations sur l'état, les API et les ressources.

## Appels d'API

Comme d'habitude, les appels d'API se trouvent dans la vue Events.

```text theme={null}
RSSetShadingRateImage(ID3D12Resource *image);
RSSetShadingRate(D3D12_SHADING_RATE baseShadingRate, _In_reads_opt(2) D3D12_SHADING_RATE_COMBINER* combiners);
```

Pour afficher les arguments d'un appel d'API, consultez la vue Event Details, comme illustré dans la figure suivante.

<img src="https://mintcdn.com/microsoft-4404708b/cbgdF-D3rUKJ-fFH/images/gdk/tools/pix-vrs-api-event-details.png?fit=max&auto=format&n=cbgdF-D3rUKJ-fFH&q=85&s=e4646c85c39256dc79248dda47b56a4b" alt="Vue Event Details de PIX" width="1055" height="285" data-path="images/gdk/tools/pix-vrs-api-event-details.png" />

## État du GPU

Plusieurs registres peuvent être consultés pour déterminer la configuration VRS actuelle, comme illustré dans la figure suivante.

<img src="https://mintcdn.com/microsoft-4404708b/stYRJgFi22xot4tO/images/gdk/tools/pix-state-vrs.png?fit=max&auto=format&n=stYRJgFi22xot4tO&q=85&s=6e27b33adcb2e61fac23ce3f294067cd" alt="Vue GPU State de PIX pour l'ombrage à taux variable" width="542" height="411" data-path="images/gdk/tools/pix-state-vrs.png" />

| Registre | Champ | Description |
| - | - | - |
| CB\_COLOR0\_ATTRIB3 CB\_COLOR1\_ATTRIB3 CB\_COLOR2\_ATTRIB3 CB\_COLOR3\_ATTRIB3 CB\_COLOR4\_ATTRIB3 CB\_COLOR5\_ATTRIB3 CB\_COLOR6\_ATTRIB3 CB\_COLOR7\_ATTRIB3 | VRS\_RATE\_HINT\_ENABLE | Active l'écriture de l'indication de taux VRS dans la surface CMask de la cible de rendu correspondante. Ignoré dans tout mode de fonctionnement du CB autre que NORMAL. Ignoré en rétrocompatibilité. Empêche l'utilisation de l'effacement rapide CMask lorsqu'il est effectivement activé. |
| VGT\_DRAW\_PAYLOAD\_CNTL | EN\_VRS\_RATE | Active le taux VRS par appel de dessin à partir de GE\_VRS\_RATE. |
| GE\_VRS\_RATE | RATE\_X RATE\_Y | Taux x ou y de l'ombrage à taux variable par appel de dessin. |
| DB\_RENDER\_OVERRIDE2 | FORCE\_VRS\_RATE\_FINE | Force le plafonnement du taux d'ombrage pour qu'il ne soit pas plus grossier que 1x1. |
| DB\_HTILE\_SURFACE | VRS\_HTILE\_ENCODING | Spécifie l'encodage du taux VRS pour HTile. |
| DB\_SPI\_VRS\_CENTER\_LOCATION | CENTER\_X\_OFFSET\_1X1 CENTER\_Y\_OFFSET\_1X1 CENTER\_X\_OFFSET\_2X1 CENTER\_Y\_OFFSET\_2X1 CENTER\_X\_OFFSET\_1X2 CENTER\_Y\_OFFSET\_1X2 CENTER\_X\_OFFSET\_2X2 CENTER\_Y\_OFFSET\_2X2 | X-Offset 1x1 : décalage signé sur 4 bits par rapport au centre du pixel dans la direction x, pour les rendus au taux 1x1. Y-Offset 1x1 : décalage signé sur 4 bits par rapport au centre du pixel dans la direction y, pour les rendus au taux 1x1. X-Offset 2x1 : décalage signé sur 4 bits par rapport au centre du pixel grossier dans la direction x, pour les rendus au taux 2x1. Y-Offset 2x1 : décalage signé sur 4 bits par rapport au centre du pixel grossier dans la direction y, pour les rendus au taux 2x1. X-Offset 1x2 : décalage signé sur 4 bits par rapport au centre du pixel grossier dans la direction x, pour les rendus au taux 1x2. Y-Offset 1x2 : décalage signé sur 4 bits par rapport au centre du pixel grossier dans la direction y, pour les rendus au taux 1x2. X-Offset 2x2 : décalage signé sur 4 bits par rapport au centre du pixel dans la direction x, pour les rendus au taux 2x2. Y-Offset 2x2 : décalage signé sur 4 bits par rapport au centre du pixel dans la direction y, pour les rendus au taux 2x2. Pour tous les décalages signés mentionnés précédemment, la plage va de -8/16 à 7/16. |
| DB\_VRS\_OVERRIDE\_CNTL | VRS\_OVERRIDE\_RATE\_COMBINER\_MODE VRS\_OVERRIDE\_RATE\_X VRS\_OVERRIDE\_RATE\_Y | Override Combiner Mode : contrôle la façon dont le taux de remplacement modifie le taux de rendu. 0 : aucun remplacement 1 : taux de rendu = taux de remplacement 2 : taux de rendu = min(taux de rendu, taux de remplacement) 3 : taux de rendu = max(taux de rendu, taux de remplacement) 4 : taux de rendu = saturate(taux de rendu + taux de remplacement) Override Rate X : taux d'ombrage VRS dans la direction x pour l'étape de remplacement, encodé en complément à deux sur 2 bits. Override Rate Y : taux d'ombrage VRS dans la direction y pour l'étape de remplacement, encodé en complément à deux sur 2 bits. |
| PA\_CL\_VS\_OUT\_CNTL | USE\_VTX\_VRS\_RATE | Utilise les taux VRS produits par l'étape Vertex Shader (dans le canal z de VS\_OUT\_MISC\_VEC). |
| PA\_CL\_VRS\_CNTL | VERTEX\_RATE\_COMBINER\_MODE PRIMITIVE\_RATE\_COMBINER\_MODE HTILE\_RATE\_COMBINER\_MODE SAMPLE\_ITER\_COMBINER\_MODE EXPOSE\_VRS\_PIXELS\_MASK CMASK\_RATE\_HINT\_FORCE\_ZERO | Vertex Rate Combiner Mode : contrôle la façon dont le taux VRS par vertex est calculé à partir du taux VRS basé sur l'état et du taux de vertex exporté. Primitive Rate Combiner Mode : contrôle la façon dont le taux VRS par primitive est calculé à partir du taux VRS de primitive exporté et du taux de vertex. HTile Rate Combiner Mode : contrôle la façon dont le taux VRS de chaque tuile est calculé à partir du taux VRS de la primitive et du taux VRS encodé dans le HTile. Sampler Iter Combiner Mode : contrôle la façon dont le taux VRS de la tuile est combiné à la valeur fournie dans l'état PS\_ITER\_SAMPLES pour former le taux utilisé pour le rendu. Expose VRS Pixels Mask : contrôle la façon dont le masque d'entrée de nuanceur d'un pixel grossier est généré. CMask Rate Hint Force Zero : met à zéro le taux VRS des tuiles rendues dans CMask. |
| GL2C\_CM\_CTRL2 | VRS\_DISABLE | Lorsque la valeur est un, désactive les fonctionnalités VRS dans DCC. |

## Ressources VRS

Pour afficher le taux VRS par vertex, sélectionnez **VS Output** dans la liste des ressources, comme illustré dans la figure suivante. L'image de taux d'ombrage est visible à l'étape OM lorsqu'elle est utilisée.

<img src="https://mintcdn.com/microsoft-4404708b/cbgdF-D3rUKJ-fFH/images/gdk/tools/pix-vrs-resources.png?fit=max&auto=format&n=cbgdF-D3rUKJ-fFH&q=85&s=295921dc35ba41ea2b1807ebb317ddb7" alt="Liste des ressources de PIX pour VS Output" width="174" height="370" data-path="images/gdk/tools/pix-vrs-resources.png" />

## Voir aussi

[Analyser les performances du GPU](/fr-CA/tools/tools-console/pix/gpu/gpu-performance)

[PIX](/fr-CA/tools/tools-console/pix/pix)


## Related topics

- [Capture GPU et analyse des performances avec PIX](/fr-CA/tools/tools-console/pix/gpu/index.md)
- [Ombrage à taux variable (VRS) sur la XBOX Series X|S](/fr-CA/build/core-features/graphics/newfeatures/vrs/index.md)
- [D3D12_VARIABLE_SHADING_RATE_TIER](/fr-CA/reference/graphics/d3d12/enums/d3d12_variable_shading_rate_tier_public.md)
- [RSSetShadingRateImage (consoles XBOX Series)](/fr-CA/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist5/methods/id3d12graphicscommandlist5_rssetshadingrateimage_public.md)
- [D3D12_SHADING_RATE (consoles XBOX Series)](/fr-CA/reference/graphics/d3d12/enums/d3d12_shading_rate_public.md)
