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

# SetHDRToneMapperX (famille XBOX One)

> Définit un mappeur de tons HDR (High Dynamic Range) utilisé pour produire une image SDR (Standard Dynamic Range) au moment de l'exécution lorsqu'un jeu HDR active le mappage de tons automatique.

Définit un mappeur de tons HDR (High Dynamic Range) utilisé pour produire une image SDR (Standard Dynamic Range) au moment de l'exécution, lorsqu'un titre HDR active le mappage de tons automatique pour XBOX One.

## Syntaxe

```cpp theme={null}
HRESULT SetHDRToneMapperX(  
         ID3D12Resource* pHDRToneMapper  
)  
```

### Paramètres

*pHDRToneMapper*   \_In\_opt\_\
Type : ID3D12Resource\*

Pointeur vers une texture 3D qui encode le mappeur de tons HDR d'un titre dans une table de correspondance 3D (LUT). Transmettez nullptr pour utiliser un mappeur de tons par défaut lors du mappage de tons automatique.

### Valeur renvoyée

Type : HRESULT

Une valeur de retour HRESULT.

## Remarques

L'image SDR est utilisée pour GameDVR, le streaming et la diffusion, mais pas pour les captures d'écran. Les captures d'écran sont toujours produites automatiquement par le système. Cette API s'applique uniquement au mappage de tons automatique sur XBOX One et n'affecte pas le mappage de tons automatique des consoles XBOX Series X|S. Reportez-vous à la section relative au mappage de tons automatique dans [Sortie HDR (High Dynamic Range)](https://learn.microsoft.com/en-us/gaming/gdk/_content/gc/graphics/overviews/hdr-support).

Une texture doit avoir une taille de 32x32x32 et un format [DXGI\_FORMAT\_R10G10B10A2\_UNORM](https://learn.microsoft.com/en-us/windows/win32/api/dxgiformat/ne-dxgiformat-dxgi_format). Les valeurs de la LUT doivent encoder des couleurs SDR linéaires et sans correction gamma. Reportez-vous à l'exemple HDRAutoToneMapping.

## Configuration requise

**En-tête :** d3d12\_x.h

**Bibliothèque :** d3d12\_x.lib

**Plateformes prises en charge :** famille XBOX One

## Voir aussi

[ID3D12CommandQueue](/fr/reference/graphics/d3d12_x/interfaces/id3d12commandqueue/id3d12commandqueue)\
[GameDVR et diffusion](https://learn.microsoft.com/en-us/gaming/gdk/_content/gc/system/overviews/gamedvr-broadcast)


## Related topics

- [Répertoire des rubriques NDA : liens actifs vers Microsoft Learn](/fr/nda/nda-topic-directory.md)
- [IGameInputMapper](/reference/input/gameinput/interfaces/igameinputmapper/igameinputmapper.md)
- [CreateInputMapper](/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_createinputmapper.md)
- [IGameInputMapper::GetGamepadButtonMapping](/reference/input/gameinput/interfaces/igameinputmapper/methods/igameinputmapper_getgamepadbuttonmappinginfo.md)
- [IGameInputMapper::GetGamepadAxisMappingInfo](/reference/input/gameinput/interfaces/igameinputmapper/methods/igameinputmapper_getgamepadaxismappinginfo.md)