Edit

Share via

D3D12DDI_RAYTRACING_INSTANCE_FLAGS enumeration (d3d12umddi.h)

  • Article

Flag options when generating instance data on the CPU to upload to the GPU, during ray tracing acceleration structure build.

Syntax

typedef enum D3D12DDI_RAYTRACING_INSTANCE_FLAGS {
  D3D12DDI_RAYTRACING_INSTANCE_FLAG_NONE,
  D3D12DDI_RAYTRACING_INSTANCE_FLAG_TRIANGLE_CULL_DISABLE,
  D3D12DDI_RAYTRACING_INSTANCE_FLAG_TRIANGLE_FRONT_COUNTERCLOCKWISE,
  D3D12DDI_RAYTRACING_INSTANCE_FLAG_FORCE_OPAQUE,
  D3D12DDI_RAYTRACING_INSTANCE_FLAG_FORCE_NON_OPAQUE
} ;

Constants

 
D3D12DDI_RAYTRACING_INSTANCE_FLAG_NONE
No options specified.
D3D12DDI_RAYTRACING_INSTANCE_FLAG_TRIANGLE_CULL_DISABLE
Disables culling for this instance. The D3D12DDI_CULL_MODE enumeration flags D3D12DDI_CULL_MODE_FRONT and D3D12DDI_CULL_MODE_BACK will have no effect on this instance.
D3D12DDI_RAYTRACING_INSTANCE_FLAG_TRIANGLE_FRONT_COUNTERCLOCKWISE
This flag reverses front and back facings, which is useful if for example, the application’s natural winding order differs from the default.
By default, a triangle is front facing if its vertices appear clockwise from the ray origin and back facing if its vertices appear counter-clockwise from the ray origin, in object space in a left-handed coordinate system.
Since these winding direction rules are defined in object space, they are unaffected by instance transforms. For example, an instance transform matrix with negative determinant (e.g. mirroring some geometry), does not change the facing of the triangles within the instance. Per-geometry transforms, by contrast, (defined in D3D12DDI_RAYTRACING_GEOMETRY_DESC_0054), get combined with the associated vertex data in object space, so a negative determinant matrix there does flip triangle winding
D3D12DDI_RAYTRACING_INSTANCE_FLAG_FORCE_OPAQUE
The instance will act as if the D3D12DDI_RAYTRACING_GEOMETRY_FLAGS enumeration's D3D12DDI_RAYTRACING_GEOMETRY_FLAG_OPAQUE flag had been specified for all the geometries in the bottom-level acceleration structure referenced by the instance.

Note that this behavior can be overridden by the ray flag D3D12DDI_RAYTRACING_INSTANCE_FLAG_FORCE_NON_OPAQUE. This flag is mutually exclusive to the D3D12DDI_RAYTRACING_INSTANCE_FLAG_FORCE_NON_OPAQUE flag.
D3D12DDI_RAYTRACING_INSTANCE_FLAG_FORCE_NON_OPAQUE
The instance will act as if the D3D12DDI_RAYTRACING_GEOMETRY_FLAGS enumeration's D3D12DDI_RAYTRACING_GEOMETRY_FLAG_OPAQUE flag had not been specified for any of the geometries in the bottom-level acceleration structure referenced by the instance.

Note that this behavior can be overridden by the ray flag D3D12DDI_RAYTRACING_INSTANCE_FLAG_FORCE_OPAQUE. This flag is mutually exclusive to the D3D12DDI_RAYTRACING_INSTANCE_FLAG_FORCE_OPAQUE flag.

Remarks

This enumeration is used in the D3D12DDI_RAYTRACING_INSTANCE_DESC_0054 structure to specify an option to apply to the instance.

Requirements

Requirement Value
Minimum supported client Windows 10, version 1809
Header d3d12umddi.h