Skip to content

Latest commit

 

History

History
107 lines (83 loc) · 5.06 KB

ne-d3d12-d3d12_shader_component_mapping.md

File metadata and controls

107 lines (83 loc) · 5.06 KB
Raw
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NE:d3d12.D3D12_SHADER_COMPONENT_MAPPING
D3D12_SHADER_COMPONENT_MAPPING (d3d12.h)
Specifies how memory gets routed by a shader resource view (SRV).
D3D12_SHADER_COMPONENT_MAPPING
D3D12_SHADER_COMPONENT_MAPPING enumeration
D3D12_SHADER_COMPONENT_MAPPING_FORCE_VALUE_0
D3D12_SHADER_COMPONENT_MAPPING_FORCE_VALUE_1
D3D12_SHADER_COMPONENT_MAPPING_FROM_MEMORY_COMPONENT_0
D3D12_SHADER_COMPONENT_MAPPING_FROM_MEMORY_COMPONENT_1
D3D12_SHADER_COMPONENT_MAPPING_FROM_MEMORY_COMPONENT_2
D3D12_SHADER_COMPONENT_MAPPING_FROM_MEMORY_COMPONENT_3
d3d12/D3D12_SHADER_COMPONENT_MAPPING
d3d12/D3D12_SHADER_COMPONENT_MAPPING_FORCE_VALUE_0
d3d12/D3D12_SHADER_COMPONENT_MAPPING_FORCE_VALUE_1
d3d12/D3D12_SHADER_COMPONENT_MAPPING_FROM_MEMORY_COMPONENT_0
d3d12/D3D12_SHADER_COMPONENT_MAPPING_FROM_MEMORY_COMPONENT_1
d3d12/D3D12_SHADER_COMPONENT_MAPPING_FROM_MEMORY_COMPONENT_2
d3d12/D3D12_SHADER_COMPONENT_MAPPING_FROM_MEMORY_COMPONENT_3
direct3d12.d3d12_shader_component_mapping
direct3d12\d3d12_shader_component_mapping.htm
direct3d12
654E43DA-03C3-4BFB-8575-0BB48CB4FB81
12/05/2018
D3D12_SHADER_COMPONENT_MAPPING, D3D12_SHADER_COMPONENT_MAPPING enumeration, D3D12_SHADER_COMPONENT_MAPPING_FORCE_VALUE_0, D3D12_SHADER_COMPONENT_MAPPING_FORCE_VALUE_1, D3D12_SHADER_COMPONENT_MAPPING_FROM_MEMORY_COMPONENT_0, D3D12_SHADER_COMPONENT_MAPPING_FROM_MEMORY_COMPONENT_1, D3D12_SHADER_COMPONENT_MAPPING_FROM_MEMORY_COMPONENT_2, D3D12_SHADER_COMPONENT_MAPPING_FROM_MEMORY_COMPONENT_3, d3d12/D3D12_SHADER_COMPONENT_MAPPING, d3d12/D3D12_SHADER_COMPONENT_MAPPING_FORCE_VALUE_0, d3d12/D3D12_SHADER_COMPONENT_MAPPING_FORCE_VALUE_1, d3d12/D3D12_SHADER_COMPONENT_MAPPING_FROM_MEMORY_COMPONENT_0, d3d12/D3D12_SHADER_COMPONENT_MAPPING_FROM_MEMORY_COMPONENT_1, d3d12/D3D12_SHADER_COMPONENT_MAPPING_FROM_MEMORY_COMPONENT_2, d3d12/D3D12_SHADER_COMPONENT_MAPPING_FROM_MEMORY_COMPONENT_3, direct3d12.d3d12_shader_component_mapping
d3d12.h
Windows
Windows
D3D12_SHADER_COMPONENT_MAPPING
19H1
D3D12_SHADER_COMPONENT_MAPPING
d3d12/D3D12_SHADER_COMPONENT_MAPPING
c++
APIRef
kbSyntax
HeaderDef
d3d12.h
D3D12_SHADER_COMPONENT_MAPPING

-description

Specifies how memory gets routed by a shader resource view (SRV).

-enum-fields

-field D3D12_SHADER_COMPONENT_MAPPING_FROM_MEMORY_COMPONENT_0:0

Indicates return component 0 (red).

-field D3D12_SHADER_COMPONENT_MAPPING_FROM_MEMORY_COMPONENT_1:1

Indicates return component 1 (green).

-field D3D12_SHADER_COMPONENT_MAPPING_FROM_MEMORY_COMPONENT_2:2

Indicates return component 2 (blue).

-field D3D12_SHADER_COMPONENT_MAPPING_FROM_MEMORY_COMPONENT_3:3

Indicates return component 3 (alpha).

-field D3D12_SHADER_COMPONENT_MAPPING_FORCE_VALUE_0:4

Indicates forcing the resulting value to 0.

-field D3D12_SHADER_COMPONENT_MAPPING_FORCE_VALUE_1:5

Indicates forcing the resulting value 1. The value of forcing 1 is either 0x1 or 1.0f depending on the format type for that component in the source format.

-remarks

This enum allows the SRV to select how memory gets routed to the four return components in a shader after a memory fetch. The options for each shader component [0..3] (corresponding to RGBA) are: component 0..3 from the SRV fetch result or force 0 or force 1.

The default 1:1 mapping can be indicated by specifying D3D12_DEFAULT_SHADER_4_COMPONENT_MAPPING, otherwise an arbitrary mapping can be specified using the macro D3D12_ENCODE_SHADER_4_COMPONENT_MAPPING.

See below.

Note the following defines.

#define D3D12_SHADER_COMPONENT_MAPPING_MASK 0x7
#define D3D12_SHADER_COMPONENT_MAPPING_SHIFT 3
#define D3D12_SHADER_COMPONENT_MAPPING_ALWAYS_SET_BIT_AVOIDING_ZEROMEM_MISTAKES \
    (1<<(D3D12_SHADER_COMPONENT_MAPPING_SHIFT*4))
#define D3D12_ENCODE_SHADER_4_COMPONENT_MAPPING(Src0,Src1,Src2,Src3) \
    ((((Src0)&D3D12_SHADER_COMPONENT_MAPPING_MASK)| \
    (((Src1)&D3D12_SHADER_COMPONENT_MAPPING_MASK)<<D3D12_SHADER_COMPONENT_MAPPING_SHIFT)| \
    (((Src2)&D3D12_SHADER_COMPONENT_MAPPING_MASK)<<(D3D12_SHADER_COMPONENT_MAPPING_SHIFT*2))| \
    (((Src3)&D3D12_SHADER_COMPONENT_MAPPING_MASK)<<(D3D12_SHADER_COMPONENT_MAPPING_SHIFT*3))| \
    D3D12_SHADER_COMPONENT_MAPPING_ALWAYS_SET_BIT_AVOIDING_ZEROMEM_MISTAKES))
#define D3D12_DECODE_SHADER_4_COMPONENT_MAPPING(ComponentToExtract,Mapping) \
    ((D3D12_SHADER_COMPONENT_MAPPING)(Mapping >> (D3D12_SHADER_COMPONENT_MAPPING_SHIFT*ComponentToExtract) & D3D12_SHADER_COMPONENT_MAPPING_MASK))
#define D3D12_DEFAULT_SHADER_4_COMPONENT_MAPPING D3D12_ENCODE_SHADER_4_COMPONENT_MAPPING(0,1,2,3)

-see-also

Core enumerations