stingray.Vector4 오브젝트 참조

설명

3D 벡터를 설명합니다.

참고: Vector4 오브젝트는 임시 오브젝트로, 이 오브젝트가 생성된 프레임에서만 사용할 수 있습니다. Vector4를 여러 프레임에 저장해야 한다면 대신 Vector4Box를 사용하십시오. 자세한 내용은 오브젝트 수명 및 사용자 데이터 바인딩을 참조하십시오.

연산자

+ 및 - 같은 여러 연산자를 사용하여 아래 설명한 Vector4 오브젝트를 수정 및 변환할 수 있습니다.

더하기: +

+ 연산자를 사용하여 두 벡터를 더할 수 있습니다. 예:

newVector = vector1 + vector2

이는 add() 함수와 동일합니다.

빼기: -

- 연산자를 사용하여 한 벡터에서 한 벡터를 뺄 수 있습니다. 예:

newVector = vector1 - vector2

이는 subtract() 함수와 동일합니다.

부정: -

- 연산자를 벡터 변수의 접두사로 사용하여 벡터를 부정할 수 있습니다. 예:

negativeVector = -vector1

곱하기: *

* 연산자를 사용하여 스칼라 값으로 벡터를 곱할 수 있습니다. 예:

newVector = vector * scalarFactor

이는 multiply() 함수와 동일합니다. 요소별로 두 벡터를 곱할 수 있게 해주는 multiply_elements()도 참조하십시오.

나누기: /

/ 연산자를 사용하여 스칼라 값으로 벡터를 나눌 수 있습니다. 예:

newVector = vector / scalarFactor

이는 divide() 함수와 동일합니다. 요소별로 다른 벡터로 한 벡터를 나눌 수 있게 해주는 divide_elements()도 참조하십시오.

구성요소 액세스: []

[] 연산자를 사용하여 구성요소 값을 설정하고 검색할 수 있습니다. X 구성요소에는 색인 1 또는 "x"를, Y 구성요소에는 2 또는 "y"를, Z 구성요소에는 3 또는 "z"를, 그리고 W 구성요소에는 4 또는 "w"를 사용합니다. 예:

yComponentValue = vector[2]
zComponentValue = vector["z"]

생성자 및 액세서

stingray.Vector4() stingray.Vector4.add() stingray.Vector4.divide() stingray.Vector4.divide_elements() stingray.Vector4.lerp() stingray.Vector4.max() stingray.Vector4.min() stingray.Vector4.multiply() stingray.Vector4.multiply_elements() stingray.Vector4.normalize() stingray.Vector4.subtract() stingray.Vector4.zero() stingray.Vector4Box.unbox()

기타 관련 참조 항목

	stingray.Vector4Box
	color
	stingray.LineObject.add_box() stingray.LineObject.add_capsule() stingray.LineObject.add_circle() stingray.LineObject.add_cone() stingray.LineObject.add_half_sphere() stingray.LineObject.add_line() stingray.LineObject.add_sphere() stingray.Replay.record_debug_line() stingray.Replay.record_screen_debug_text() stingray.Replay.record_world_debug_text() stingray.Vector4Box() stingray.Vector4Box.store()
	Math

관련 도움말 항목

릴리스 정보 > Stingray 1.1 릴리스 정보

데이터 구성원

w : number W 구성요소.

x : number X 구성요소.

y : number Y 구성요소.

z : number Z 구성요소.

함수

add ( vector_a, vector_b ) : stingray.Vector4 지정된 두 벡터를 더하고, 결과 벡터를 반환합니다.

매개변수

vector_a :	stingray.Vector4	더할 첫 번째 벡터입니다.
vector_b :	stingray.Vector4	더할 두 번째 벡터입니다.

반환하는 항목

stingray.Vector4

두 입력 벡터의 합입니다.

distance ( vector_a, vector_b ) : number 지정된 두 점 사이의 거리를 반환합니다.

매개변수

vector_a :	stingray.Vector4	첫 번째 점입니다.
vector_b :	stingray.Vector4	두 번째 점입니다.

반환하는 항목

number

vector_a와 vector_b 사이의 스칼라 거리입니다.

distance_squared ( vector_a, vector_b ) : number 지정된 두 점 사이 거리의 제곱을 반환합니다.

매개변수

vector_a :	stingray.Vector4	첫 번째 벡터입니다.
vector_b :	stingray.Vector4	두 번째 벡터입니다.

반환하는 항목

number

vector_a와 vector_b 사이 거리의 제곱입니다.

divide ( vector, factor ) : stingray.Vector4 지정된 벡터를 스칼라 값으로 나누고, 결과 벡터를 반환합니다.

매개변수

vector :	stingray.Vector4	나눌 벡터입니다.
factor :	number	벡터를 나눌 스칼라 값입니다.

반환하는 항목

stingray.Vector4

입력 벡터와 스칼라 값의 몫입니다.

divide_elements ( vector_a, vector_b ) : stingray.Vector4 vector_a의 각 요소를 vector_b의 해당 요소로 나누고, 결과 벡터를 반환합니다.

매개변수

vector_a :	stingray.Vector4	나눌 벡터입니다.
vector_b :	stingray.Vector4	vector_a로 나눌 벡터입니다.

반환하는 항목

stingray.Vector4

두 입력 벡터의 몫입니다.

dot ( vector_a, vector_b ) : number 지정된 두 벡터의 내적을 반환합니다.

매개변수

vector_a :	stingray.Vector4	첫 번째 벡터입니다.
vector_b :	stingray.Vector4	두 번째 벡터입니다.

반환하는 항목

number

내적입니다.

element ( vector, index ) : number 벡터 내 지정된 색인에 저장된 값을 반환합니다.

매개변수

vector :	stingray.Vector4	구성요소를 반환할 벡터입니다.
index :	integer	반환할 구성요소의 색인입니다. X 구성요소에는 1을, Y 구성요소에는 2를, Z 구성요소에는 3을, 그리고 W 구성요소에는 4를 사용합니다.

반환하는 항목

number

지정된 색인에 있는 요소의 값입니다.

equal ( vector_a, vector_b ) : boolean 두 벡터가 동일한지 여부를 나타냅니다.

매개변수

vector_a :	stingray.Vector4	비교할 첫 번째 벡터입니다.
vector_b :	stingray.Vector4	비교할 두 번째 벡터입니다.

반환하는 항목

boolean

두 벡터가 동일하면 true를, 그렇지 않으면 false를 반환합니다.

is_valid ( vector ) : boolean 벡터가 전체적으로 유효한 값으로 구성되어 있는지 여부를 나타냅니다.

매개변수

vector :

stingray.Vector4

유효성을 확인할 벡터입니다.

반환하는 항목

boolean

벡터의 모든 구성요소가 유효한 숫자이면 true를 반환하고, 어느 구성요소가 #NaN 또는 #INF인 경우 false를 반환합니다.

length ( vector ) : number 지정한 벡터의 스칼라 길이를 반환합니다.

매개변수

vector :

stingray.Vector4

길이를 반환할 벡터입니다.

반환하는 항목

number

벡터의 길이입니다.

lerp ( vector_a, vector_b, ratio ) : stingray.Vector4 지정된 두 벡터 사이를 지정된 비율로 선형 보간하여 새 벡터를 생성합니다.

매개변수

vector_a :	stingray.Vector4	첫 번째 벡터입니다.
vector_b :	stingray.Vector4	두 번째 벡터입니다.
ratio :	number	보간 비율, 또는 가중치입니다. 0에서 1 사이(두 값 포함)의 어떠한 값이든 될 수 있습니다. 값이 0에 가까우면 vector_a에 가까운 벡터가 생성되고, 값이 1에 가까우면 vector_b에 가까운 벡터가 생성됩니다.

반환하는 항목

stingray.Vector4

결과 벡터입니다.

max ( vector_a, vector_b ) : stingray.Vector4 지정된 두 벡터 내 각 구성요소에 대해 가장 큰 값을 포함하고 있는 벡터를 반환합니다.

매개변수

vector_a :	stingray.Vector4	첫 번째 벡터입니다.
vector_b :	stingray.Vector4	두 번째 벡터입니다.

반환하는 항목

stingray.Vector4

결과 벡터입니다.

min ( vector_a, vector_b ) : stingray.Vector4 지정된 두 벡터 내 각 구성요소에 대해 가장 작은 값을 포함하고 있는 벡터를 반환합니다.

매개변수

vector_a :	stingray.Vector4	첫 번째 벡터입니다.
vector_b :	stingray.Vector4	두 번째 벡터입니다.

반환하는 항목

stingray.Vector4

결과 벡터입니다.

multiply ( vector, factor ) : stingray.Vector4 지정된 벡터를 스칼라 값으로 곱하고, 결과 벡터를 반환합니다.

매개변수

vector :	stingray.Vector4	곱할 벡터입니다.
factor :	number	벡터를 곱할 스칼라 값입니다.

반환하는 항목

stingray.Vector4

입력 벡터와 스칼라 값의 곱입니다.

multiply_elements ( vector_a, vector_b ) : stingray.Vector4 vector_a의 각 요소를 vector_b의 해당 요소로 곱하고, 결과 벡터를 반환합니다.

매개변수

vector_a :	stingray.Vector4	곱할 첫 번째 벡터입니다.
vector_b :	stingray.Vector4	곱할 두 번째 벡터입니다.

반환하는 항목

stingray.Vector4

두 입력 벡터의 곱입니다.

normalize ( vector ) : stingray.Vector4 지정된 벡터를 정규화, 즉 스칼라 길이를 1로 변환하고, 결과를 반환합니다.

매개변수

vector :

stingray.Vector4

정규화할 벡터입니다.

반환하는 항목

stingray.Vector4

정규화된 벡터입니다.

set_element ( vector, index, value ) 벡터 내 지정된 색인을 지정된 값으로 설정합니다.

매개변수

vector :	stingray.Vector4	구성요소를 설정할 벡터입니다.
index :	integer	설정할 구성요소의 색인입니다. X 구성요소에는 1을, Y 구성요소에는 2를, Z 구성요소에는 3을, 그리고 W 구성요소에는 4를 사용합니다.
value :	number	지정된 색인에 설정할 값입니다.

반환하는 항목

이 함수는 아무 값도 반환하지 않습니다.

set_w ( vector, value ) 벡터의 W 구성요소 값을 설정합니다.

매개변수

vector :	stingray.Vector4	구성요소를 설정할 벡터입니다.
value :	number	W 구성요소의 새로운 값입니다.

반환하는 항목

이 함수는 아무 값도 반환하지 않습니다.

set_x ( vector, value ) 벡터의 X 구성요소 값을 설정합니다.

매개변수

vector :	stingray.Vector4	구성요소를 설정할 벡터입니다.
value :	number	X 구성요소의 새로운 값입니다.

반환하는 항목

이 함수는 아무 값도 반환하지 않습니다.

set_xyzw ( vector, x, y, z, w ) 벡터의 X, Y, Z 및 W 구성요소 값을 설정합니다.

매개변수

vector :	stingray.Vector4	구성요소를 설정할 벡터입니다.
x :	number	X 구성요소의 새로운 값입니다.
y :	number	Y 구성요소의 새로운 값입니다.
z :	number	Z 구성요소의 새로운 값입니다.
w :	number	W 구성요소의 새로운 값입니다.

반환하는 항목

이 함수는 아무 값도 반환하지 않습니다.

set_y ( vector, value ) 벡터의 Y 구성요소 값을 설정합니다.

매개변수

vector :	stingray.Vector4	구성요소를 설정할 벡터입니다.
value :	number	Y 구성요소의 새로운 값입니다.

반환하는 항목

이 함수는 아무 값도 반환하지 않습니다.

set_z ( vector, value ) 벡터의 Z 구성요소 값을 설정합니다.

매개변수

vector :	stingray.Vector4	구성요소를 설정할 벡터입니다.
value :	number	Z 구성요소의 새로운 값입니다.

반환하는 항목

이 함수는 아무 값도 반환하지 않습니다.

subtract ( vector_a, vector_b ) : stingray.Vector4 vector_b를 vector_a에서 빼고, 결과 벡터를 반환합니다.

매개변수

vector_a :	stingray.Vector4	시작 벡터입니다.
vector_b :	stingray.Vector4	뺄 벡터입니다.

반환하는 항목

stingray.Vector4

빼기의 결과입니다.

to_elements ( vector ) : number, number, number, number 지정된 벡터를 해당 구성요소 값으로 분해합니다.

매개변수

vector :

stingray.Vector4

해당 구성요소로 분해할 벡터입니다.

반환하는 항목

number	벡터의 X 구성요소입니다.
number	벡터의 Y 구성요소입니다.
number	벡터의 Z 구성요소입니다.
number	벡터의 W 구성요소입니다.

기타 관련 참조 항목

color

to_string ( vector ) : string 지정된 벡터의 문자열 표현을 반환합니다.

매개변수

vector :

stingray.Vector4

문자열로 반환할 벡터입니다.

반환하는 항목

string

문자열 표현입니다.

이 함수는 디버깅 용도로만 사용하십시오. 문자열을 저장한 다은 새 벡터로 다시 읽어 들이면 안 됩니다. 벡터를 여러 프레임에 저장하려면 Vector4Box를 사용합니다.

w ( vector ) : number 벡터의 W 구성요소 값을 반환합니다.

매개변수

vector :

stingray.Vector4

구성요소를 반환할 벡터입니다.

반환하는 항목

number

W 구성요소의 값입니다.

x ( vector ) : number 벡터의 X 구성요소 값을 반환합니다.

매개변수

vector :

stingray.Vector4

구성요소를 반환할 벡터입니다.

반환하는 항목

number

X 구성요소의 값입니다.

y ( vector ) : number 벡터의 Y 구성요소 값을 반환합니다.

매개변수

vector :

stingray.Vector4

구성요소를 반환할 벡터입니다.

반환하는 항목

number

Y 구성요소의 값입니다.

z ( vector ) : number 벡터의 Z 구성요소 값을 반환합니다.

매개변수

vector :

stingray.Vector4

구성요소를 반환할 벡터입니다.

반환하는 항목

number

Z 구성요소의 값입니다.

zero ( ) : stingray.Vector4 모든 값이 0으로 초기화된 새 벡터를 반환합니다.

매개변수

이 함수는 어떠한 매개변수도 수용하지 않습니다.

반환하는 항목

stingray.Vector4

0 벡터입니다.