Vector2

Overview

Vector2는 X, Y의 두 축 값을 통해 2차원 공간상의 벡터를 표현하는 데이터 타입으로, 위치, 방향, 속도, 힘과 같은 다양한 2D 데이터를 다루는 데 사용되며, 공간 내 좌표 및 이동 계산, 물리 연산 등 여러 시스템 전반에서 핵심적으로 활용됩니다.

Constructors

new

전달된 X, Y 값을 기반으로 새로운 벡터를 생성하여 반환합니다.

Parameters

number x	X축 좌표 값입니다.
number y	Y축 좌표 값입니다.

Return

Vector2	생성된 Vector2입니다.

Code Samples

local Vector = Vector2.new(3, 7)
print(Vector)

Properties

X

number

X축 좌표 값입니다.

Code Samples

local Vector = Vector2.new(5, 10)
print(Vector.X)

Y

number

Y축 좌표 값입니다.

Code Samples

local Vector = Vector2.new(5, 10)
print(Vector.Y)

zero

Vector2

모든 축 값이 0으로 구성된 벡터입니다. (0, 0)

Code Samples

local ZeroVector = Vector2.zero
print(ZeroVector)

one

Vector2

모든 축 값이 1으로 구성된 벡터입니다. (1, 1)

Code Samples

local OneVector = Vector2.one
print(OneVector)

xAxis

Vector2

X축 방향으로만 1의 값을 가지며, 나머지 축 값은 모두 0으로 설정된 Vector2입니다. (1, 0)

Code Samples

local XAxis = Vector2.xAxis
print(XAxis)

yAxis

Vector2

Y축 방향으로만 1의 값을 가지며, 나머지 축 값은 모두 0으로 설정된 Vector2입니다. (0, 1)

Code Samples

local YAxis = Vector2.yAxis
print(YAxis)

Methods

Lerp

현재 벡터와 목표 벡터 사이를 선형 보간 방식으로 alpha 비율에 따라 계산한 위치를 새로운 벡터로 반환합니다.

Parameters

Vector2 goal	보간의 대상이 되는 목표 Vector2입니다.
number alpha	보간 비율을 나타내는 값입니다.

Return

Vector2	생성된 Vector2입니다.

Code Samples

local a = Vector2.new(0, 0)
local b = Vector2.new(10, 10)
print("Lerp:", a:Lerp(b, 0.3)) --> Output: 3, 3

Slerp

현재 벡터와 목표 벡터 사이를 구면 선형 보간 방식으로 alpha 비율에 따라 계산한 위치를 새로운 벡터로 반환합니다.

Lerp는 직선 경로를 따라 보간하지만, Slerp는 단위 구면 위의 곡선을 따라 보간하기 때문에 회전 방향 변화가 더 부드럽고 일정합니다.

Parameters

Vector2 goal	보간의 대상이 되는 목표 Vector2입니다.
number alpha	보간 비율을 나타내는 값입니다.

Return

Vector2	생성된 Vector2입니다.

Code Samples

local a = Vector2.new(1, 0)
local b = Vector2.new(0, 1)
print("Slerp:", a:Slerp(b, 0.5)) --> Output: 0.707107, 0.707107