OverlapParams
*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 stocke des paramètres à utiliser avec les fonctions de requête de frontière , et .La propriété OverlapParams.FilterDescendantsInstances stocke un ensemble d'objets à utiliser comme liste d'inclusion ou d'exclusion en fonction de l'enumérité OverlapParams.FilterType et la propriété OverlapParams.CollisionGroup peut spécifier un groupe de collision pour l'opération de requête de bordure.
Contrairement à la plupart des types de données dans Luau, vous pouvez modifier tous les membres de OverlapParams sans créer un nouvel objet, ce qui vous permet de réutiliser le même objet à plusieurs reprises.
Résumé
Constructeurs
- new()
Renvoie un objet vide OverlapParams .
Propriétés
Un ensemble d'objets dont les descendants sont utilisés pour filtrer les candidats.
Détermine comment la liste OverlapParams.FilterDescendantsInstances est utilisée.
Quantité maximale de parties à retourner par la recherche/requête.
Le groupe de collision utilisé pour l'opération.
Détermine si l'opération de requête de frontière prend en compte la valeur de propriété BasePart.CanCollide d'une partie sur sa valeur BasePart.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 OverlapParams .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.
FilterType
Détermine comment l'array est utilisé, en fonction de ce qui est fourni. La valeur par défaut est .
MaxParts
Le montant maximum de parties à retourner par la recherche/requête. La valeur par défaut de zéro ( 0 ) représente pas de limite.
CollisionGroup
Spécifie un groupe de collision pour l'opération.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, l'opération 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 requête de frontière utilise la valeur de BasePart.CanCollide de la partie interceptée en faveur de sa valeur de BasePart.CanQuery lors de la détermination si cette partie est incluse dans l'ensemble des résultats de la requête spatiale.
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.