RaycastParams

Overview

RaycastParams는 Raycast 실행 시 적용될 조건과 필터를 정의하는 설정용 데이터 타입입니다. WorldRoot:Raycast를 호출할 때 사용되며, 어떤 객체를 충돌 대상에 포함하거나 제외할지, 어떤 충돌 그룹 기준으로 검사할지를 세밀하게 제어할 수 있습니다.

Constructors

new

새로운 RaycastParams 인스턴스를 생성합니다. 생성 시에는 초기 설정값이 포함되지 않으며, 레이캐스트에 사용할 필터, 충돌 그룹 등의 속성은 사용 목적에 맞게 개별적으로 지정해야 합니다.

Parameters

Return

RaycastParams	생성된 RaycastParams입니다.

Code Samples

local RaycastParams = RaycastParams.new()

Properties

FilterDescendantsInstances

array

이 배열은 레이캐스트 수행 시 포함하거나 제외할 기준이 되는 객체들을 지정합니다. 배열에 등록된 각 객체의 모든 자식 요소들이 함께 고려되며, FilterType 설정에 따라 레이캐스트 충돌 대상에 포함되거나 무시됩니다.

Code Samples

local RaycastParams = RaycastParams.new()
RaycastParams.FilterDescendantsInstances = 
{
    Workspace.Part1, 
    Workspace.Part2 
}

FilterType

Enum.RaycastFilterType

FilterDescendantsInstances에 포함된 객체들을 레이캐스트 대상에 포함할지 또는 제외할지를 지정합니다. 선택된 RaycastFilterType 열거형 값에 따라, 해당 배열이 충돌 검사 후보를 제한하는 기준으로 적용됩니다.

Code Samples

local RaycastParams = RaycastParams.new()
RaycastParams.FilterType = Enum.RaycastFilterType.Exclude 

IgnoreWater

boolean

현재 지원되지 않습니다.

Code Samples

CollisionGroup

string

레이캐스트가 어떤 충돌 그룹 규칙을 기준으로 동작할지를 정의합니다. 지정된 충돌 그룹과 상호 충돌이 허용되지 않은 파트들은 레이캐스트 대상에서 자동으로 제외됩니다. 별도의 설정이 없을 경우, 기본 충돌 그룹이 사용되어 레이캐스트가 처리됩니다.

Code Samples

local RaycastParams = RaycastParams.new()
RaycastParams.CollisionGroup = "MyCollisionGroup"

RespectCanCollide

boolean

현재 지원되지 않습니다.

Code Samples

BruteForceAllSlow

boolean

현재 지원되지 않습니다.

Code Samples

Methods

AddToFilter

지정된 인스턴스들을 FilterDescendantsInstances 목록에 추가합니다.

필터 배열을 직접 수정하는 방식보다 간단하고 효율적이며, 레이캐스트 필터 구성을 보다 안전하고 일관되게 관리할 수 있습니다. 또한 이 메서드는 필터 설정을 단계적으로 누적할 때 적합합니다.

Parameters

Instance|array InValue	레이캐스트 필터에 추가할 인스턴스 또는 인스턴스 배열입니다.

Return

RaycastParams	필터가 갱신된 RaycastParams 객체를 반환합니다.

Code Samples

local RaycastParams = RaycastParams.new()
RaycastParams:AddToFilter(Workspace.Part1)
RaycastParams:AddToFilter({ Workspace.Part2, Workspace.Part3 })

See also

WorldRoot