OverlapParams 데이터 유형은 WorldRoot 경계 쿼리 함수에 사용할 매개 변수를 저장하며, 특히 WorldRoot:GetPartBoundsInBox() , WorldRoot:GetPartBoundsInRadius() 및 WorldRoot:GetPartsInPart() 입니다.OverlapParams.FilterDescendantsInstances 속성은 열거형 OverlapParams.FilterType에 따라 포함 또는 제외 목록으로 사용할 개체 배열을 저장하고, OverlapParams.CollisionGroup 속성은 경계 쿼리 작업에 대한 충돌 그룹을 지정할 수 있습니다.
Luau의 대부분의 데이터 유형과 달리, 새 개체를 생성하지 않고 모든 OverlapParams 멤버를 변경할 수 있으므로 동일한 개체를 반복해서 사용할 수 있습니다.
요약
생성자
- new()
빈 OverlapParams 개체를 반환합니다.
속성
후손이 필터링 후보에 사용되는 개체 배열.
OverlapParams.FilterDescendantsInstances 목록이 사용되는 방법을 결정합니다.
쿼리에서 반환할 부품의 최대 수입니다.
작업에 사용된 충돌 그룹.
경계 쿼리 작업이 부품의 BasePart.CanCollide 속성 값을 자신의 BasePart.CanQuery 값에 고려하는지 여부를 결정합니다.
활성화되면 쿼리는 모든 부품 충돌 속성을 무시하고 모든 부품에 대해 강제 검사를 수행합니다.
메서드
제공된 인스턴스를 FilterDescendantsInstances에 추가합니다.
생성자
속성
CollisionGroup
작업에 대한 충돌 그룹을 지정합니다.충돌 그룹에 설정된 부품이 아님 으로 설정되면 이 그룹과 충돌하지 않습니다.이 속성이 생략되면 작업은 기본 충돌 그룹을 가정합니다.
RespectCanCollide
이 속성은 true 이면 경계 쿼리 작업이 해당 부분의 BasePart.CanCollide 값을 사용하여 해당 부분이 공간 쿼리 결과 배열에 포함되는지 여부를 결정할 때 해당 부분의 BasePart.CanQuery 값을 선호합니다.
BruteForceAllSlow
활성화되면 쿼리는 모든 부품 충돌 속성을 무시하고 모든 부품에 대해 강제 검사를 수행합니다.이렇게 하면 성능에 부정적인 영향을 미치고 라이브 경험에서 사용되면 안 됩니다.
메서드
AddToFilter
효율성과 단순성을 위해 이 메서드는 필터에 인스턴스를 추가하는 기본 방법입니다.병렬 컨텍스트에서 업데이트할 수 있는 추가 이점이 있습니다 FilterDescendantsInstances.