D3D12_RAYTRACING_INSTANCE_FLAGS (XBOX Series consoles) - XBOX Game Development Documentation

Flags for a raytracing acceleration structure instance. These flags can be used to override D3D12_RAYTRACING_GEOMETRY_FLAGS for individual instances.

Syntax

typedef enum D3D12_RAYTRACING_INSTANCE_FLAGS
{
    D3D12_RAYTRACING_INSTANCE_FLAG_NONE = 0,
    D3D12_RAYTRACING_INSTANCE_FLAG_TRIANGLE_CULL_DISABLE = 1,
    D3D12_RAYTRACING_INSTANCE_FLAG_TRIANGLE_FRONT_COUNTERCLOCKWISE = 2,
    D3D12_RAYTRACING_INSTANCE_FLAG_FORCE_OPAQUE = 4,
    D3D12_RAYTRACING_INSTANCE_FLAG_FORCE_NON_OPAQUE = 8
} D3D12_RAYTRACING_INSTANCE_FLAGS

Constants

Constant	Description
D3D12_RAYTRACING_INSTANCE_FLAG_NONE	No options specified.
D3D12_RAYTRACING_INSTANCE_FLAG_TRIANGLE_CULL_DISABLE	Disables front/back face culling for this instance. The Ray flags RAY_FLAG_CULL_BACK_FACING_TRIANGLES and RAY_FLAG_CULL_FRONT_FACING_TRIANGLES will have no effect on this instance.
D3D12_RAYTRACING_INSTANCE_FLAG_TRIANGLE_FRONT_COUNTERCLOCKWISE	This flag reverses front and back facings, which is useful if 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 defined in D3D12_RAYTRACING_GEOMETRY_TRIANGLES_DESC , by contrast, get combined with the associated vertex data in object space, so a negative determinant matrix there does flip triangle winding.
D3D12_RAYTRACING_INSTANCE_FLAG_FORCE_OPAQUE	The instance will act as if D3D12_RAYTRACING_GEOMETRY_FLAG_OPAQUE 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 RAY_FLAG_FORCE_NON_OPAQUE. This flag is mutually exclusive to the D3D12_RAYTRACING_INSTANCE_FLAG_FORCE_NON_OPAQUE flag.
D3D12_RAYTRACING_INSTANCE_FLAG_FORCE_NON_OPAQUE	The instance will act as if D3D12_RAYTRACING_GEOMETRY_FLAG_OPAQUE 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 RAY_FLAG_FORCE_OPAQUE. This flag is mutually exclusive to the D3D12_RAYTRACING_INSTANCE_FLAG_FORCE_OPAQUE flag.

Requirements

Header: d3d12_xs.h
Library: d3d12_xs.lib
Supported Platforms: XBOX Series consoles

Last modified on August 20, 2026

Related topics

D3D12_RAYTRACING_GEOMETRY_FLAGS (XBOX Series consoles)D3D12_RAYTRACING_INSTANCE_DESC (XBOX Series consoles)D3D12_RAYTRACING_PIPELINE_FLAGS (XBOX Series consoles)D3D12_RAYTRACING_GEOMETRY_DESC (XBOX Series consoles)D3D12_RAYTRACING_PIPELINE_CONFIG1 (XBOX Series consoles)

⌘I