> ## 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 la 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 (LUT) 3D. Passez nullptr pour utiliser un mappeur de tons par défaut pendant le mappage de tons automatique.

### Valeur de retour

Type : HRESULT

Une valeur de retour HRESULT.

## Remarques

L'image SDR est utilisée pour GameDVR, la diffusion en continu et la télé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 la XBOX One et n'affecte pas le mappage de tons automatique des consoles XBOX Series X|S. Consultez la section sur le 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. Consultez 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-CA/reference/graphics/d3d12_x/interfaces/id3d12commandqueue/id3d12commandqueue)\
[GameDVR et télé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)