# OverlapParams ## Overview OverlapParams는 월드 내에서 파트 영역을 탐색할 때 필요한 조건들을 관리하는 설정 객체입니다. WorldRoot에서 제공하는 영역 탐색 함수들은 이 객체를 참조하여, FilterDescendantsInstances와 FilterType을 통해 특정 객체를 포함하거나 제외하고, CollisionGroup 설정에 따라 충돌 그룹 기준의 탐색을 수행합니다. 또한 이 데이터 타입은 새 객체를 생성하지 않고도 설정 값을 변경할 수 있어, 하나의 OverlapParams를 반복적으로 재사용할 수 있습니다. ## Constructors ### new 새로운 OverlapParams 인스턴스를 생성됩니다. 생성 시에는 초기 설정값이 포함되지 않으며, 이후에 필요한 속성들을 개별적으로 지정하여 사용해야 합니다. #### Parameters #### Return | `OverlapParams` | 생성된 OverlapParams입니다. | | --------------- | --------------------- | #### Code Samples ```lua local Params = OverlapParams.new() ``` ## Properties ### BruteForceAllSlow `boolean` 해당 옵션을 활성화하면 파트의 충돌 설정을 무시한 채 월드에 존재하는 모든 파트를 직접 검사하게 됩니다. 이 방식은 연산 비용이 매우 높아 성능 저하를 초래할 수 있으므로, 테스트 용도를 제외한 실제 환경에서는 사용을 권장하지 않습니다. #### Code Samples ```lua local Params = OverlapParams.new() Params.BruteForceAllSlow = true ``` ### FilterDescendantsInstances `Array` 이 배열은 탐색 수행 시 포함하거나 제외할 기준이 되는 객체들을 지정합니다. 배열에 등록된 각 객체의 모든 자식 요소들이 함께 고려되며, FilterType 설정에 따라 탐색 대상에 포함되거나 무시됩니다. #### Code Samples ```lua local Params = OverlapParams.new() Params.FilterDescendantsInstances = { Workspace.Part1, Workspace.Part2 } ``` ### FilterType `Enum.RaycastFilterType` FilterDescendantsInstances에 포함된 객체들을 탐색 대상에 포함할지 또는 제외할지를 지정합니다. 선택된 RaycastFilterType 열거형 값에 따라, 해당 배열이 탐색 검사 후보를 제한하는 기준으로 적용됩니다. #### Code Samples ```lua local Params = OverlapParams.new() Params.FilterType = Enum.RaycastFilterType.Exclude ``` ### MaxParts `number` 영역 탐색 시 반환 가능한 파트의 수를 제한하는 데 사용됩니다. 값이 0으로 설정된 경우에는 개수 제한 없이 모든 결과가 반환됩니다. #### Code Samples ```lua local Params = OverlapParams.new() Params.MaxParts = 50 ``` ### RespectCanCollide `boolean` 해당 옵션을 활성화하면 영역 탐색 과정에서 파트의 CanQuery 속성보다 CanCollide 속성을 우선 기준으로 검사 여부를 판단하며, 이를 통해 충돌 가능성을 중심으로 한 탐색 결과를 얻을 수 있습니다. #### Code Samples ```lua local Params = OverlapParams.new() Params.RespectCanCollide = false ``` ## Methods ### AddToFilter 지정된 인스턴스들을 FilterDescendantsInstances 목록에 추가합니다. 필터 배열을 직접 수정하는 방식보다 간단하고 효율적이며, 탐색 필터 구성을 보다 안전하고 일관되게 관리할 수 있습니다. 또한 이 메서드는 필터 설정을 단계적으로 누적할 때 적합합니다. #### Parameters | `Value` InValue | 탐색 필터에 추가할 인스턴스 또는 인스턴스 배열입니다. | | --------------- | ------------------------------ | #### Return | `OverlapParams` | 필터가 갱신된 OverlapParams 객체를 반환합니다. | | --------------- | -------------------------------- | #### Code Samples ```lua local Params = OverlapParams.new() Params:AddToFilter(Workspace.Part1) Params:AddToFilter({ Workspace.Part2, Workspace.Part3 }) ``` ## Events ## See also {% content-ref url="/pages/7KwhvgGhSPjT2HIASnwp" %} [WorldRoot](/korean/development/api-reference/classes/worldroot.md) {% endcontent-ref %} --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.overdare.com/korean/development/api-reference/datatype/overlapparams.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.