Objetos de estado

Com os modelos de sombreador 6.3 e posteriores, os aplicativos têm a conveniência e a flexibilidade de poder definir objetos de estado DXR diretamente no código de sombreador HLSL, além de usar APIs do Direct3D 12.

Em HLSL, os objetos de estado são declarados com esta sintaxe:

Type Name = 
{ 
    Field1,
    Field2,
    ...
};

Lista de tipos de subobjeto:

• StateObjectConfig
• GlobalRootSignature
• LocalRootSignature
• SubobjectToExportsAssocation
• RaytracingShaderConfig
• RaytracingPipelineConfig
• TriangleHitGroup
• ProceduralPrimitiveHitGroup

StateObjectConfig

O tipo de subobjeto StateObjectConfig corresponde a uma estrutura D3D12_STATE_OBJECT_CONFIG.

Tem um campo, uma bandeira bitwise, que é um ou ambos os

• STATE_OBJECT_FLAGS_ALLOW_LOCAL_DEPENDENCIES_ON_EXTERNAL_DEFINITONS
• STATE_OBJECT_FLAGS_ALLOW_EXTERNAL_DEPENDENCIES_ON_LOCAL_DEFINITIONS

ou, zero para nenhum deles.

Exemplo:

StateObjectConfig MyStateObjectConfig = 
{ 
    STATE_OBJECT_FLAGS_ALLOW_LOCAL_DEPENDENCIES_ON_EXTERNAL_DEFINITONS
};

GlobalRootSignature

Um GlobalRootSignature corresponde a uma estrutura D3D12_GLOBAL_ROOT_SIGNATURE.

Os campos consistem em algum número de cadeias de caracteres que descrevem as partes da assinatura raiz. Para obter referência sobre isso, consulte Especificando assinaturas raiz no HLSL.

Exemplo:

GlobalRootSignature MyGlobalRootSignature =
{
    "DescriptorTable(UAV(u0)),"                     // Output texture
    "SRV(t0),"                                      // Acceleration structure
    "CBV(b0),"                                      // Scene constants
    "DescriptorTable(SRV(t1, numDescriptors = 2))"  // Static index and vertex buffers.
};

LocalRootSignature

Um LocalRootSignature corresponde a uma estrutura D3D12_LOCAL_ROOT_SIGNATURE.

Assim como o subobjeto de assinatura raiz global, os campos consistem em algum número de cadeias de caracteres que descrevem as partes da assinatura raiz. Para obter referência sobre isso, consulte Especificando assinaturas raiz no HLSL.

Exemplo:

LocalRootSignature MyLocalRootSignature = 
{
    "RootConstants(num32BitConstants = 4, b1)"  // Cube constants 
};

SubobjectToExportsAssocation

Por padrão, um subobjeto meramente declarado na mesma biblioteca que uma exportação pode ser aplicado a essa exportação. No entanto, os aplicativos têm a capacidade de substituir isso e obter informações específicas sobre qual subobjeto acompanha qual exportação. No HLSL, essa "associação explícita" é feita usando SubobjectToExportsAssocation.

Um SubobjectToExportsAssocation corresponde a uma estrutura D3D12_DXIL_SUBOBJECT_TO_EXPORTS_ASSOCIATION .

Este subobjeto é declarado com a sintaxe

SubobjectToExportsAssocation Name = 
{ 
    SubobjectName,
    Exports
};

Exemplo:

SubobjectToExportsAssociation MyLocalRootSignatureAssociation =
{
    "MyLocalRootSignature",    // Subobject name
    "MyHitGroup;MyMissShader"  // Exports association 
};

Observe que ambos os campos usam exportados nomes. Um nome exportado pode ser diferente do nome original em HLSL, se o aplicativo optar por fazer exportação-renomeação.

RaytracingShaderConfig

Um RaytracingShaderConfig corresponde a uma estrutura D3D12_RAYTRACING_SHADER_CONFIG.

Este subobjeto é declarado com a sintaxe

RaytracingShaderConfig Name = 
{ 
    MaxPayloadSize,
    MaxAttributeSize
};

Exemplo:

RaytracingShaderConfig MyShaderConfig =
{
    16,  // Max payload size
    8    // Max attribute size
};

RaytracingPipelineConfig

Um RaytracingPipelineConfig corresponde a uma estrutura D3D12_RAYTRACING_PIPELINE_CONFIG.

Este subobjeto é declarado com a sintaxe

RaytracingPipelineConfig Name = 
{ 
    MaxTraceRecursionDepth
};

Exemplo:

RaytracingPipelineConfig MyPipelineConfig =
{
    1  // Max trace recursion depth
};

Como há um custo de desempenho para a recursão de raytracing, os aplicativos devem usar a menor profundidade de recursão necessária para os resultados desejados.

Se as invocações de sombreador ainda não tiverem atingido a profundidade máxima de recursão, elas poderão chamar TraceRay qualquer número de vezes. Mas se eles atingirem ou excederem a profundidade máxima de recursão, chamar TraceRay coloca o dispositivo em estado removido. Portanto, os sombreadores de raytracing devem ter o cuidado de parar de chamar o TraceRay se tiverem atingido ou excedido a profundidade máxima de recursão.

TriangleHitGroup

Um TriangleHitGroup corresponde a uma estrutura D3D12_HIT_GROUP_DESC cujo campo Type está definido como D3D12_HIT_GROUP_TYPE_TRIANGLES.

Este subobjeto é declarado com a sintaxe

TriangleHitGroup Name = 
{ 
    AnyHitShader,
    ClosestHitShader
};

Exemplo:

TriangleHitGroup MyHitGroup =
{
    "",                    // AnyHit
    "MyClosestHitShader",  // ClosestHit
};

Observe que ambos os campos usam exportados nomes. Um nome exportado pode ser diferente do nome original em HLSL, se o aplicativo optar por fazer exportação-renomeação.

ProcessualPrimitiveHitGroup

Um ProceduralPrimitiveHitGroup corresponde a uma estrutura D3D12_HIT_GROUP_DESC cujo campo Type está definido como D3D12_HIT_GROUP_TYPE_PROCEDURAL_PRIMITIVE.

Este subobjeto é declarado com a sintaxe

ProceduralPrimitiveHitGroup Name = 
{ 
    AnyHitShader,
    ClosestHitShader,
    IntersectionShader
};

Exemplo:

ProceduralPrimitiveHitGroup MyProceduralHitGroup
{
    "MyAnyHit",       // AnyHit
    "MyClosestHit",   // ClosestHit
    "MyIntersection"  // Intersection
};

Observe que os três campos usam exportados nomes. Um nome exportado pode ser diferente do nome original em HLSL, se o aplicativo optar por fazer exportação-renomeação.

Comentários

Os subobjetos têm a noção de "associação", ou "qual subobjeto acompanha qual exportação".

Ao especificar subobjetos por meio do código de sombreador, a escolha de "qual subobjeto acompanha qual exportação" segue as regras descritas no de especificação DXR do. Em particular, suponha que um aplicativo tenha alguma exportação. Se um aplicativo associa essa exportação à assinatura raiz A por meio do código de sombreador e a assinatura raiz B por meio do código do aplicativo, B é o que é usado. O design de "usar B" em vez de "produzir um erro" dá aos aplicativos a capacidade de substituir convenientemente associações DXIL usando código de aplicativo, em vez de serem forçados a recompilar sombreadores para resolver coisas incompatíveis.

Tópicos relacionados

postagem do blog do desenvolvedor do DirectX "Novo no D3D12 – DirectX Raytracing (DXR) agora suporta subobjetos de biblioteca"

Especificações funcionais do DirectX Raytracing (DXR)

exemplo: D3D12RaytracingLibrarySubobjects