OverlapParams

Pokaż przestarzałe

*Ta zawartość została przetłumaczona przy użyciu narzędzi AI (w wersji beta) i może zawierać błędy. Aby wyświetlić tę stronę w języku angielskim, kliknij tutaj.

Typ danych przechowuje parametry do użycia z funkcjami zapytania o granice , i .Właściwość OverlapParams.FilterDescendantsInstances przechowuje tablicę obiektów do użycia jako lista wykluczeń lub wykluczeń na podstawie operacji OverlapParams.FilterType enum, a właściwość OverlapParams.CollisionGroup może określić grupę kolizji dla operacji zapytania o granicę.

W przeciwieństwie do większości typów danych w Luau możesz zmienić wszystkich członków OverlapParams bez tworzenia nowego obiektu, umożliwiając ponowne wykorzystanie tego samego obiektu wielokrotnie.

Podsumowanie

Konstruktorzy

Właściwości

Metody

Konstruktorzy

new

Zwraca pusty obiekt OverlapParams pusty.W przeciwieństwie do innych konstruktorów typu danych nie ma tego konstruktora żadnych parametrów, więc powinieneś ustawić jego właściwości odpowiednio.

Właściwości

FilterDescendantsInstances

Zbiór obiektów, których potomkowie są używane do filtrowania kandydatów.

Określa, w jaki sposób używana jest matryca OverlapParams.FilterDescendantsInstances, w zależności od dostarczonej Enum.RaycastFilterType. Domyślną wartością jest Enum.RaycastFilterType.Exclude.

MaxParts

Maksymalna ilość części, które mają zostać zwrócone przez zapytanie. Domyślna wartość zera (0) nie reprezentuje żadnego ograniczenia.

CollisionGroup

Określa grupę kolizji dla operacji.Części w grupach kolizyjnych, które są ustawione na nie kolizji z tą grupą, są ignorowane.Jeśli ta właściwość zostanie pominięta, operacja przyjmuje domyślną grupę kolizji Domyślna .

RespectCanCollide

Ta właściwość, jeśli true, sprawia, że operacja zapytania o granicę wykorzystuje wartość BasePart.CanCollide z przeciętej części na korzyść jej wartości BasePart.CanQuery, gdy określa, czy część ta jest zawarta w tablicy wyników zapytania przestrzennego.

BruteForceAllSlow

Po włączeniu zapytanie zignoruje wszystkie właściwości kolizji części i przeprowadzi kontrolę siły brutto na każdej części.Będzie to miało negatywny wpływ na wydajność i nie powinno być używane w doświadczeniach na żywo.

Metody

AddToFilter

()
Zapis równoległy

Dla wydajności i prostoty, ta metoda jest preferowanym sposobem dodawania instancji do filtra.Posiada dodatkową zaletę, że umożliwia aktualizowanie FilterDescendantsInstances z równoległego kontekstu.

Parametry

instances: Instance | Array

Instancja lub tablica zawierająca instancje do dodawać.

Zwroty

()