RaycastParams

Afficher les obsolètes

*Ce contenu est traduit en utilisant l'IA (Beta) et peut contenir des erreurs. Pour consulter cette page en anglais, clique ici.

Le type de données RaycastParams stocke les paramètres pour les opérations WorldRoot:Raycast().La propriété FilterDescendantsInstances stocke un ensemble d'objets à utiliser comme liste d'inclusion ou d'exclusion en fonction du RaycastParams.FilterType enum.Si nécessaire, la propriété RaycastParams.IgnoreWater peut être utilisée pour ignorer l'eau Terrain et la propriété RaycastParams.CollisionGroup peut spécifier un groupe de collision pour l'opération de lancer de rayons.

Cet objet est différent de l'objet de même nom RaycastResult qui fournit les résultats d'un lancer de rayon.

Contrairement à la plupart des types de données dans Luau, vous pouvez modifier tous les membres de RaycastParams sans créer un nouvel objet, ce qui vous permet de réutiliser le même objet à plusieurs reprises.

Résumé

Constructeurs

Propriétés

Méthodes

Constructeurs

new

Renvoie un objet vide RaycastParams .Contrairement aux autres constructeurs de type de données, ce constructeur n'a pas de paramètres, vous devez donc définir ses propriétés de manière appropriée.

Propriétés

FilterDescendantsInstances

Un ensemble d'objets dont les descendants sont utilisés pour filtrer les candidats de lancer de rayons.

Détermine comment l'array est utilisée, en fonction de ce qui est fourni.

IgnoreWater

Détermine si le matériau d'eau est pris en compte lors du lancer de rayons contre Terrain .

CollisionGroup

Spécifie un groupe de collision pour l'opération de lancer de rayons.Les parties des groupes de collision qui sont réglées sur non ne se heurtent pas à ce groupe.Si cette propriété est omise, le raycast suppose le groupe de collision par défaut par défaut .

RespectCanCollide

Cette propriété, si true , fait en sorte que l'opération de lancer de rayons utilise la valeur de CanCollide d'une partie interceptée en faveur de sa valeur de CanQuery lors de la détermination de savoir si cette partie est incluse dans la valeur de RaycastResult.

BruteForceAllSlow

Lorsqu'il est activé, la requête ignorera toutes les propriétés de collision de parties et effectuera un contrôle de force brute sur chaque partie.Cela aura un impact négatif sur les performances et ne devrait pas être utilisé dans des expériences en direct.

Méthodes

AddToFilter

()
Écrire en parallèle

Pour l'efficacité et la simplicité, cette méthode est la façon préférée d'ajouter des instances au filtres.Il a l'avantage supplémentaire de permettre à FilterDescendantsInstances d'être mis à jour à partir d'un contexte parallèle.

Paramètres

instances: Instance | Array

Une instance ou un tableau contenant des instances à ajouter.

Retours

()