> ## 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 (família XBOX One)

> Define um mapeador de tons HDR (High Dynamic Range) usado para produzir uma imagem SDR (Standard Dynamic Range) em tempo de execução quando um jogo HDR habilita o mapeamento de tons automático.

Define um mapeador de tons HDR (High Dynamic Range) usado para produzir uma imagem SDR (Standard Dynamic Range) em tempo de execução, quando um título HDR habilita o mapeamento de tons automático para o XBOX One.

## Sintaxe

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

### Parâmetros

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

Ponteiro para uma textura 3D que codifica o mapeador de tons HDR de um título em uma LUT (tabela de pesquisa) 3D. Passe nullptr para usar um mapeador de tons padrão durante o mapeamento de tons automático.

### Valor retornado

Tipo: HRESULT

Um valor retornado HRESULT.

## Comentários

A imagem SDR é usada para GameDVR, streaming e transmissão, mas não para capturas de tela. As capturas de tela são sempre produzidas automaticamente pelo sistema. Esta API se aplica somente ao mapeamento de tons automático no XBOX One e não afeta o mapeamento de tons automático para consoles XBOX Series X|S. Consulte a seção de mapeamento de tons automático em [Saída HDR (High Dynamic Range)](https://learn.microsoft.com/en-us/gaming/gdk/_content/gc/graphics/overviews/hdr-support).

Uma textura deve ter um tamanho de 32x32x32 e um formato [DXGI\_FORMAT\_R10G10B10A2\_UNORM](https://learn.microsoft.com/en-us/windows/win32/api/dxgiformat/ne-dxgiformat-dxgi_format). Os valores na LUT devem codificar cores SDR lineares e sem correção de gama. Consulte o exemplo HDRAutoToneMapping.

## Requisitos

**Cabeçalho:** d3d12\_x.h

**Biblioteca:** d3d12\_x.lib

**Plataformas com suporte:** família XBOX One

## Confira também

[ID3D12CommandQueue](/pt-BR/reference/graphics/d3d12_x/interfaces/id3d12commandqueue/id3d12commandqueue)\
[GameDVR e transmissão](https://learn.microsoft.com/en-us/gaming/gdk/_content/gc/system/overviews/gamedvr-broadcast)


## Related topics

- [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)
- [IGameInputMapper::GetRacingWheelButtonMappingInfo](/reference/input/gameinput/interfaces/igameinputmapper/methods/igameinputmapper_getracingwheelbuttonmappinginfo.md)