RaycastParams
*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
- new()
Retourne un blanc RaycastParams vide.
Propriétés
Un ensemble d'objets dont les descendants sont utilisés pour filtrer les candidats de lancer de rayons.
Détermine comment l'array FilterDescendantsInstances est utilisée.
Détermine si le matériau d'eau est pris en compte lors du lancer de rayons contre Terrain .
Le groupe de collision utilisé pour l'opération.
Détermine si l'opération de lancer de rayons prend en compte la valeur de propriété CanCollide d'une partie sur sa valeur CanQuery.
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.
Méthodes
Ajoute les instances fournies à FilterDescendantsInstances.
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.
FilterType
Détermine comment l'array est utilisée, en fonction de ce qui est fourni.
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
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.