RaycastResult

Overview

RaycastResult는 레이캐스트가 실제로 어떤 대상과 충돌했는지에 대한 결과 정보를 담는 데이터 타입입니다. WorldRoot:Raycast 호출이 성공했을 때 반환되며, 충돌 지점, 충돌한 객체, 표면 정보 등 레이캐스트 결과 분석에 필요한 다양한 데이터를 제공합니다.

Constructors

Properties

Distance

number

Raycast가 시작된 위치로부터 충돌이 발생한 지점까지의 직선 거리를 나타냅니다.

Code Samples

local Workspace = game:GetService("Workspace")

local Origin = Vector3.new(0, 50, -0)
local Direction = Vector3.new(0, 0, -3000)

local Result = Workspace:Raycast(Origin, Direction)
if Result then
   print("Hit distance:", Result.Distance)
end

Instance

Instance

Raycast가 충돌한 대상 객체를 의미합니다.

Code Samples

local Workspace = game:GetService("Workspace")

local Origin = Vector3.new(0, 50, -0)
local Direction = Vector3.new(0, 0, -3000)

local Result = Workspace:Raycast(Origin, Direction)
if Result then
   print("Hit instance:", Result.Instance.Name)
end

Position

Vector3

Raycast가 대상과 충돌한 위치를 월드 공간 기준의 좌표로 나타냅니다.

Code Samples

local Workspace = game:GetService("Workspace")

local Origin = Vector3.new(0, 50, -0)
local Direction = Vector3.new(0, 0, -3000)

local Result = Workspace:Raycast(Origin, Direction)
if Result then
   print("Hit position:", Result.Position)
end

Normal

Vector3

Raycast가 충돌한 표면이 바라보고 있는 방향을 나타내는 벡터입니다. 충돌 지점의 면에 수직인 방향을 기준으로 하며, 반사 처리, 각도 계산, 표면 방향 판정과 같은 후속 연산에 활용됩니다.

Code Samples

local Workspace = game:GetService("Workspace")

local Origin = Vector3.new(0, 50, -0)
local Direction = Vector3.new(0, 0, -3000)

local Result = Workspace:Raycast(Origin, Direction)
if Result then
   print("Surface normal:", Result.Normal)
end

Methods

See also

WorldRoot