> ## 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 de l'instance touchée. <br />Cet indicateur est mutuellement exclusif 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 de l'instance touchée. Cet indicateur est mutuellement exclusif 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 provoque 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 en l'absence de nuanceur any hit.<br />La seule exception est 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 continue sans être affecté, de sorte que l'intersection suivante devient une autre candidate pour être la première. 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'intersection est traitée comme opaque (par exemple 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 lors de la première intersection, il est appelé, sauf si RAY\_FLAG\_SKIP\_CLOSEST\_HIT\_SHADER est également présent. L'unique intersection trouvée est considérée comme la « plus proche », même si d'autres intersections potentielles plus proches sur le rayon n'ont peut-être pas été visitées.<br />Cet indicateur est généralement utilisé pour les ombres, où une seule intersection doit être trouvée. |
| D3D12\_RAY\_FLAG\_SKIP\_CLOSEST\_HIT\_SHADER | Même si au moins une intersection a été validée et que le groupe d'intersections de l'intersection la plus proche contient un nuanceur closest hit, l'exécution de ce nuanceur est ignorée. |
| 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, par instance, les triangles orientés vers l'arrière.<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 est mutuellement exclusif 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, par instance, les triangles orientés vers l'arrière.<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 est mutuellement exclusif 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 est mutuellement exclusif 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 est mutuellement exclusif 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/reference/graphics/d3d12_xs/d3d12_xs_members)


## Related topics

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