> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# D3D12_RAY_FLAGS (consoles XBOX Series)

> Indicateurs passés à la fonction TraceRay pour remplacer le comportement de transparence, d'élimination et de sortie anticipée.

Indicateurs passés à la fonction [TraceRay](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/traceray-function) pour remplacer le comportement de transparence, d'élimination et de sortie anticipée.

## Syntaxe

```cpp theme={null}
typedef enum D3D12_RAY_FLAGS    
{  
    D3D12_RAY_FLAG_NONE = 0x00,  
    D3D12_RAY_FLAG_FORCE_OPAQUE = 0x01,  
    D3D12_RAY_FLAG_FORCE_NON_OPAQUE = 0x02,  
    D3D12_RAY_FLAG_ACCEPT_FIRST_HIT_AND_END_SEARCH = 0x04,  
    D3D12_RAY_FLAG_SKIP_CLOSEST_HIT_SHADER = 0x08,  
    D3D12_RAY_FLAG_CULL_BACK_FACING_TRIANGLES = 0x10,  
    D3D12_RAY_FLAG_CULL_FRONT_FACING_TRIANGLES = 0x20,  
    D3D12_RAY_FLAG_CULL_OPAQUE = 0x40,  
    D3D12_RAY_FLAG_CULL_NON_OPAQUE = 0x80,  
    D3D12XBOX_RAY_FLAG_COHERENT_RAYS_HINT = 0x1000,  
} D3D12_RAY_FLAGS  
```

## Constantes

| Constante | Description |
| - | - |
| D3D12\_RAY\_FLAG\_NONE | Aucune option sélectionnée. |
| D3D12\_RAY\_FLAG\_FORCE\_OPAQUE | Toutes les intersections rayon-primitive rencontrées lors d'un lancer de rayons sont traitées comme opaques. Aucun nuanceur any hit n'est donc exécuté, que la géométrie touchée spécifie ou non D3D12\_RAYTRACING\_GEOMETRY\_FLAG\_OPAQUE, et quels que soient les indicateurs d'instance de l'instance touchée. <br />Cet indicateur s'exclut mutuellement avec RAY\_FLAG\_FORCE\_NON\_OPAQUE, RAY\_FLAG\_CULL\_OPAQUE et RAY\_FLAG\_CULL\_NON\_OPAQUE. |
| D3D12\_RAY\_FLAG\_FORCE\_NON\_OPAQUE | Toutes les intersections rayon-primitive rencontrées lors d'un lancer de rayons sont traitées comme non opaques. Les nuanceurs any hit, s'ils sont présents, sont donc exécutés, que la géométrie touchée spécifie ou non D3D12\_RAYTRACING\_GEOMETRY\_FLAG\_OPAQUE, et quels que soient les indicateurs d'instance de l'instance touchée. Cet indicateur s'exclut mutuellement avec RAY\_FLAG\_FORCE\_\OPAQUE, RAY\_FLAG\_CULL\_OPAQUE et RAY\_FLAG\_CULL\_NON\_OPAQUE. |
| D3D12\_RAY\_FLAG\_ACCEPT\_FIRST\_HIT\_AND\_END\_SEARCH | La première intersection rayon-primitive rencontrée lors d'un lancer de rayons entraîne automatiquement l'appel de [AcceptHitAndEndSearch](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/accepthitandendsearch-function) immédiatement après le nuanceur any hit, y compris s'il n'y a aucun nuanceur any hit.<br />La seule exception se produit lorsque le nuanceur any hit précédent appelle [IgnoreHit](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/ignorehit-function), auquel cas le rayon poursuit sa course sans être affecté, de sorte que l'impact suivant devient un autre candidat pour être le premier impact. Pour que cette exception s'applique, le nuanceur any hit doit réellement être exécuté. Ainsi, si le nuanceur any hit est ignoré parce que l'impact est traité comme opaque (p. ex. parce que RAY\_FLAG\_FORCE\_OPAQUE, D3D12\_RAYTRACING\_GEOMETRY\_FLAG\_OPAQUE ou D3D12\_RAYTRACING\_INSTANCE\_FLAG\_OPAQUE est défini), AcceptHitAndEndSearch est appelé.<br />Si un nuanceur closest hit est présent au premier impact, il est invoqué, sauf si RAY\_FLAG\_SKIP\_CLOSEST\_HIT\_SHADER est également présent. Le seul impact trouvé est considéré comme le « plus proche », même si d'autres impacts potentiels plus proches sur le rayon n'ont peut-être pas été visités.<br />Une utilisation typique de cet indicateur concerne les ombres, pour lesquelles un seul impact doit être trouvé. |
| D3D12\_RAY\_FLAG\_SKIP\_CLOSEST\_HIT\_SHADER | Même si au moins un impact a été validé et que le groupe d'impact du plus proche impact contient un nuanceur closest hit, ignore l'exécution de ce nuanceur. |
| D3D12\_RAY\_FLAG\_CULL\_BACK\_FACING\_TRIANGLES | Active l'élimination des triangles orientés vers l'arrière. Consultez [D3D12\_RAYTRACING\_INSTANCE\_FLAGS](https://msdn.microsoft.com/library/Mt815589\(v=VS.85\).aspx) pour sélectionner quels triangles sont orientés vers l'arrière, par instance.<br />Sur les instances qui spécifient D3D12\_RAYTRACING\_INSTANCE\_FLAG\_TRIANGLE\_CULL\_DISABLE, cet indicateur n'a aucun effet.<br />Sur les types de géométrie autres que D3D12\_RAYTRACING\_GEOMETRY\_TYPE\_TRIANGLES, cet indicateur n'a aucun effet.<br />Cet indicateur s'exclut mutuellement avec RAY\_FLAG\_CULL\_FRONT\_FACING\_TRIANGLES. |
| D3D12\_RAY\_FLAG\_CULL\_FRONT\_FACING\_TRIANGLES | Active l'élimination des triangles orientés vers l'avant. Consultez D3D12\_RAYTRACING\_INSTANCE\_FLAGS pour sélectionner quels triangles sont orientés vers l'arrière, par instance.<br />Sur les instances qui spécifient D3D12\_RAYTRACING\_INSTANCE\_FLAG\_TRIANGLE\_CULL\_DISABLE, cet indicateur n'a aucun effet.<br />Sur les types de géométrie autres que D3D12\_RAYTRACING\_GEOMETRY\_TYPE\_TRIANGLES, cet indicateur n'a aucun effet.<br />Cet indicateur s'exclut mutuellement avec RAY\_FLAG\_CULL\_FRONT\_FACING\_TRIANGLES. |
| D3D12\_RAY\_FLAG\_CULL\_OPAQUE | Élimine toutes les primitives considérées comme opaques en fonction de leurs indicateurs de géométrie et d'instance.<br />Cet indicateur s'exclut mutuellement avec RAY\_FLAG\_FORCE\_OPAQUE, RAY\_FLAG\_FORCE\_NON\_OPAQUE et RAY\_FLAG\_CULL\_NON\_OPAQUE. |
| D3D12\_RAY\_FLAG\_CULL\_NON\_OPAQUE | Élimine toutes les primitives considérées comme non opaques en fonction de leurs indicateurs de géométrie et d'instance.<br />Cet indicateur s'exclut mutuellement avec RAY\_FLAG\_FORCE\_OPAQUE, RAY\_FLAG\_FORCE\_NON\_OPAQUE et RAY\_FLAG\_CULL\_OPAQUE. |
| D3D12XBOX\_RAY\_FLAG\_COHERENT\_RAYS\_HINT | Indique au système de parcours que les rayons de cette distribution seront cohérents entre eux. Peut rendre le parcours légèrement plus efficace. |

## Configuration requise

**En-tête :** d3d12\_xs.h\
**Plateformes prises en charge** : XBOX Series X|S

## Voir aussi

[d3d12\_xs](/fr-CA/reference/graphics/d3d12_xs/d3d12_xs_members)


## Related topics

- [D3D12_RAYTRACING_INSTANCE_FLAGS (XBOX Series consoles)](/reference/graphics/d3d12/enums/d3d12_raytracing_instance_flags_public.md)
- [D3D12_RAYTRACING_PIPELINE_FLAGS (XBOX Series consoles)](/reference/graphics/d3d12/enums/d3d12_raytracing_pipeline_flags_public.md)
- [D3D12_RAYTRACING_GEOMETRY_FLAGS (XBOX Series consoles)](/reference/graphics/d3d12/enums/d3d12_raytracing_geometry_flags_public.md)
- [D3D12_RAYTRACING_GEOMETRY_DESC (XBOX Series consoles)](/reference/graphics/d3d12/structs/d3d12_raytracing_geometry_desc_public.md)
- [D3D12_RAYTRACING_PIPELINE_CONFIG1 (XBOX Series consoles)](/reference/graphics/d3d12/structs/d3d12_raytracing_pipeline_config1_public.md)