Pular para o conteúdo principal
Define a imagem de taxa de sombreamento de espaço de tela para o sombreamento de taxa variável (VRS). Para obter mais informações, consulte Sombreamento de taxa variável (VRS). Este método requer suporte ao Sombreamento de taxa variável (VRS) de Tier2. Consulte D3D12_FEATURE_DATA_D3D12_OPTIONS6 e D3D12_VARIABLE_SHADING_RATE_TIER.

Sintaxe

Parâmetros

shadingRateImage
Tipo: ID3D12Resource *
Um ponteiro opcional para um ID3D12Resource que representa uma imagem de taxa de sombreamento de espaço de tela. Se for NULL, o efeito será o mesmo de ter uma imagem de taxa de sombreamento em que todos os valores sejam uma taxa de sombreamento de 1x1. Essa textura deve ter o estado D3D12_RESOURCE_STATE_SHADING_RATE_SOURCE aplicado. O tamanho do bloco da imagem de taxa de sombreamento pode ser determinado por meio de D3D12_FEATURE_DATA_D3D12_OPTIONS6. Portanto, o tamanho da imagem de taxa de sombreamento deve ser
A imagem de taxa de sombreamento deve ser uma textura 2D com um único mip e o formato DXGI_FORMAT_R8_UINT. Cada texel deve ser um valor correspondente a D3D12_SHADING_RATE. Ela deve ter o layout D3D12_TEXTURE_LAYOUT_UNKNOWN e não pode ser um recurso de profundidade/estêncil, de destino de renderização, de acesso simultâneo ou entre adaptadores. Como (0, 0) é o canto superior esquerdo no DirectX, uma imagem de taxa de sombreamento pequena ou grande demais faz com que a parte inferior ou direita não tenha área de imagem de taxa de sombreamento, ou que a imagem se estenda nessas direções. Quando há excesso, ele é ignorado (mas é válido) e, quando a imagem é pequena demais, todas as áreas fora dos limites na parte inferior e direita terão a taxa de sombreamento padrão de 1x1 da imagem (no entanto, isso não significa que essa seja a taxa de sombreamento final. Os combinadores ainda serão aplicados a esse valor padrão de 1x1).

Valor retornado

Tipo: void Nenhum.

Comentários

Para que a imagem de taxa de sombreamento de espaço de tela tenha efeito, ID3D12GraphicsCommandList5::RSSetShadingRate deve ter sido chamado para definir os combinadores de sombreamento. Caso contrário, com os combinadores padrão (ambos D3D12_SHADING_RATE_COMBINER_PASSTHROUGH), a imagem de taxa de sombreamento de espaço de tela será ignorada na determinação da granularidade do sombreamento. O segundo combinador passado para [ID3D12GraphicsCommandList5::RSSetShadingRate] é o que se aplica à imagem de taxa de sombreamento, o que ocorre depois que a taxa de sombreamento global e a taxa de sombreamento por primitivo foram combinadas. O algoritmo da taxa de sombreamento final é determinado por
em que ApplyCombiner é

Requisitos

Cabeçalho: d3d12_xs.h
Biblioteca: d3d12_xs.lib
Plataformas com suporte: consoles XBOX Series

Confira também

Sombreamento de taxa variável (VRS)
Última modificação em 6 de outubro de 2026