Vector3

Overview

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

Constructors

new

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

Parameters

Parameter	Description
number x	X축 좌표 값입니다.
number y	Y축 좌표 값입니다.
number z	Z축 좌표 값입니다.

Return

Return	Description
Vector3	생성된 Vector3입니다.

Code Samples

local Vector = Vector3.new(1, 2, 3)
print(Vector) 

Properties

X

number

X축 좌표 값입니다.

Code Samples

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

Y

number

Y축 좌표 값입니다.

Code Samples

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

Z

number

Z축 좌표 값입니다.

Code Samples

local Vector = Vector3.new(10, 5, 8)
print(Vector.Z) 

zero

Vector3

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

Code Samples

local ZeroVector = Vector3.zero
print(ZeroVector)

one

Vector3

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

Code Samples

local OneVector = Vector3.one
print(OneVector)

xAxis

Vector3

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

Code Samples

local XAxis = Vector3.xAxis
print(XAxis) 

yAxis

Vector3

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

Code Samples

local YAxis = Vector3.yAxis
print(YAxis) 

zAxis

Vector3

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

Code Samples

local ZAxis = Vector3.zAxis
print(ZAxis) 

Unit

Vector3

원본과 동일한 방향은 유지하되, 크기는 제거하고 길이를 1로 맞춘 Vector3입니다.

Code Samples

local Vector = Vector3.new(100, 50, 200)
print(Vector.Unit) --> Output: 0.436436, 0.218218, 0.872872

Magnitude

number

Vector3의 크기를 나타내는 값입니다.

Code Samples

local Vector = Vector3.new(100, 50, 200)
print(Vector.Magnitude) --> Output: 229.128784

Methods

Dot

두 벡터의 내적 값을 스칼라로 반환합니다.

Parameters

Vector3 otherVector	내적을 계산할 대상 Vector3입니다.

Return

number	두 벡터의 내적 결과를 스칼라 값으로 반환합니다.

Code Samples

local a = Vector3.new(1, 2, 3)
local b = Vector3.new(4, 5, 6)
print("Dot:", a:Dot(b)) --> Output: 32

Cross

두 벡터의 외적 결과를 새로운 벡터로 반환합니다.

Parameters

Vector3 otherVector	외적을 계산할 대상 Vector3입니다.

Return

Vector3	생성된 Vector3입니다.

Code Samples

local a = Vector3.new(1, 0, 0)
local b = Vector3.new(0, 1, 0)
print("Cross:", a:Cross(b)) --> Output: 0, 0, 1

See also

좌표계