Vector3 - stingray.Vector3 오브젝트 참조 - Stingray Lua API 참조
설명
3D 벡터를 설명합니다.
참고: Vector3 오브젝트는 임시 오브젝트로, 이 오브젝트가 생성된 프레임에서만 사용할 수 있습니다. Vector3를 여러 프레임에 저장해야 한다면 대신 Vector3Box를 사용하십시오. 자세한 내용은 오브젝트 수명 및 사용자 데이터 바인딩을 참조하십시오.
연산자
+ 및 - 같은 여러 연산자를 사용하여 아래 설명한 Vector3 오브젝트를 수정 및 변환할 수 있습니다.
더하기: +
+ 연산자를 사용하여 두 벡터를 더할 수 있습니다. 예:
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"를 사용합니다. 예:
yComponentValue = vector[2]
zComponentValue = vector["z"]
생성자 및 액세서 
관련 샘플 코드
기타 관련 참조 항목
관련 도움말 항목
데이터 구성원
 |
x : number X축을 따르는 벡터의 범위입니다.
|
| |
y : numberY축을 따르는 벡터의 범위입니다.
|
| |
z : numberZ축을 따르는 벡터의 범위입니다.
|
함수
 |
add ( vector_a, vector_b ) : stingray.Vector3 지정된 두 벡터를 더하고, 결과 벡터를 반환합니다.
|
vector_a : | 더할 첫 번째 벡터입니다. | |
vector_b : | 더할 두 번째 벡터입니다. |
|
두 입력 벡터의 합입니다. |
| |
backward ( ) : stingray.Vector3뒤쪽(음의 Y) 축을 반환합니다.
|
| |
base ( index ) : stingray.Vector3지정된 색인의 기준 벡터를 반환합니다.
|
index : | integer | 반환할 기준 벡터의 색인입니다. X축에는 0을, Y축에는 1을, 그리고 Z축에는 2를 사용합니다. |
|
지정된 색인의 기준 벡터입니다. |
| |
cross ( vector_a, vector_b ) : stingray.Vector3지정된 두 벡터의 외적을 반환합니다.
|
vector_a : | 첫 번째 벡터입니다. | |
vector_b : | 두 번째 벡터입니다. |
|
외적입니다. |
관련 샘플 코드
| |
distance ( vector_a, vector_b ) : number지정된 두 점 사이의 거리를 반환합니다.
|
vector_a : | 첫 번째 점입니다. | |
vector_b : | 두 번째 점입니다. |
number |
vector_a와 vector_b 사이의 스칼라 거리입니다. |
| |
distance_squared ( vector_a, vector_b ) : number지정된 두 점 사이 거리의 제곱을 반환합니다.
|
vector_a : | 첫 번째 점입니다. | |
vector_b : | 두 번째 점입니다. |
number |
vector_a와 vector_b 사이 거리의 제곱입니다. |
| |
divide ( vector, factor ) : stingray.Vector3지정된 벡터를 스칼라 값으로 나누고, 결과 벡터를 반환합니다.
|
vector : | 나눌 벡터입니다. | |
factor : | number | 벡터를 나눌 스칼라 값입니다. |
|
입력 벡터와 스칼라 값의 몫입니다. |
| |
divide_elements ( vector_a, vector_b ) : stingray.Vector3vector_a의 각 요소를 vector_b의 해당 요소로 나누고, 결과 벡터를 반환합니다.
|
vector_a : | 나눌 벡터입니다. | |
vector_b : | vector_a로 나눌 벡터입니다. |
|
두 입력 벡터의 몫입니다. |
| |
dot ( vector_a, vector_b ) : number지정된 두 벡터의 내적을 반환합니다.
|
vector_a : | 첫 번째 벡터입니다. | |
vector_b : | 두 번째 벡터입니다. |
number |
내적입니다. |
| |
down ( ) : stingray.Vector3아래쪽(음의 Z) 축을 반환합니다.
|
| |
element ( vector, index ) : number벡터 내 지정된 색인에 저장된 값을 반환합니다.
|
vector : | 구성요소를 반환할 벡터입니다. | |
index : | integer | 반환할 구성요소의 색인입니다. X 구성요소에는 1을, Y 구성요소에는 2를, 그리고 Z 구성요소에는 3을 사용합니다. |
number |
지정된 색인에 있는 요소의 값입니다. |
| |
equal ( vector_a, vector_b ) : boolean두 벡터가 동일한지 여부를 나타냅니다.
|
vector_a : | 비교할 첫 번째 벡터입니다. | |
vector_b : | 비교할 두 번째 벡터입니다. |
boolean |
두 벡터가 동일하면 true를, 그렇지 않으면 false를 반환합니다. |
관련 샘플 코드
| |
forward ( ) : stingray.Vector3앞쪽(Y) 축을 반환합니다.
|
| |
is_valid ( vector ) : boolean벡터가 전체적으로 유효한 값으로 구성되어 있는지 여부를 나타냅니다.
|
vector : | 유효성을 확인할 벡터입니다. |
boolean |
벡터의 모든 구성요소가 유효한 숫자이면 true를 반환하고, 어느 구성요소가 #NaN 또는 #INF인 경우 false를 반환합니다. |
| |
left ( ) : stingray.Vector3왼쪽(음의 X) 축을 반환합니다.
|
| |
length ( vector ) : number지정한 벡터의 스칼라 길이를 반환합니다.
|
| |
lerp ( vector_a, vector_b, ratio ) : stingray.Vector3지정된 두 벡터 사이를 지정된 비율로 선형 보간하여 새 벡터를 생성합니다.
|
vector_a : | 첫 번째 벡터입니다. | |
vector_b : | 두 번째 벡터입니다. | |
ratio : | number | 보간 비율, 또는 가중치입니다. 0에서 1 사이(두 값 포함)의 어떠한 값이든 될 수 있습니다. 값이 0에 가까우면 vector_a에 가까운 벡터가 생성되고, 값이 1에 가까우면 vector_b에 가까운 벡터가 생성됩니다. |
|
결과 벡터입니다. |
| |
make_axes ( vector ) : stingray.Vector3, stingray.Vector3지정된 vector를 고려하여, 세 벡터가 함께 직교 좌표계로 사용할 수 있는 정규 직교 기반을 형성하도록 두 직교 벡터 Y 및 Z를 반환합니다.
|
vector : | 시작 X 벡터입니다. |
|
vector 및 Z 벡터에 직교하는 Y 벡터입니다. | |
|
vector 및 Y 벡터에 직교하는 Z 벡터입니다. |
| |
max ( vector_a, vector_b ) : stingray.Vector3지정된 두 벡터의 각 구성요소에 대해 가장 큰 값을 포함하고 있는 벡터를 반환합니다.
|
vector_a : | 첫 번째 벡터입니다. | |
vector_b : | 두 번째 벡터입니다. |
|
결과 벡터입니다. |
| |
min ( vector_a, vector_b ) : stingray.Vector3지정된 두 벡터의 각 구성요소에 대해 가장 작은 값을 포함하고 있는 벡터를 반환합니다.
|
vector_a : | 첫 번째 벡터입니다. | |
vector_b : | 두 번째 벡터입니다. |
|
결과 벡터입니다. |
| |
multiply ( vector, factor ) : stingray.Vector3지정된 벡터를 스칼라 값으로 곱하고, 결과 벡터를 반환합니다.
|
vector : | 곱할 벡터입니다. | |
factor : | number | 벡터를 곱할 스칼라 값입니다. |
|
입력 벡터와 스칼라 값의 곱입니다. |
| |
multiply_elements ( vector_a, vector_b ) : stingray.Vector3vector_a의 각 요소를 vector_b의 해당 요소로 곱하고, 결과 벡터를 반환합니다.
|
vector_a : | 곱할 첫 번째 벡터입니다. | |
vector_b : | 곱할 두 번째 벡터입니다. |
|
두 입력 벡터의 곱입니다. |
관련 샘플 코드
| |
normalize ( vector ) : stingray.Vector3지정된 벡터를 정규화, 즉 스칼라 길이를 1로 변환하고, 결과를 반환합니다.
|
| |
right ( ) : stingray.Vector3오른쪽(X) 축을 반환합니다.
|
| |
set_element ( vector, index, value )벡터 내 지정된 색인을 지정된 값으로 설정합니다.
|
vector : | 구성요소를 설정할 벡터입니다. | |
index : | integer | 설정할 구성요소의 색인입니다. X 구성요소에는 1을, Y 구성요소에는 2를, 그리고 Z 구성요소에는 3을 사용합니다. |
value : | number | 지정된 색인에 설정할 값입니다. |
| 이 함수는 아무 값도 반환하지 않습니다. |
| |
set_x ( vector, value )벡터의 X 구성요소 값을 설정합니다.
|
vector : | 구성요소를 설정할 벡터입니다. | |
value : | number | X 구성요소의 새로운 값입니다. |
| 이 함수는 아무 값도 반환하지 않습니다. |
| |
set_xyz ( vector, x, y, z )벡터의 X, Y 및 Z 구성요소 값을 설정합니다.
|
vector : | 구성요소를 설정할 벡터입니다. | |
x : | number | X 구성요소의 새로운 값입니다. |
y : | number | Y 구성요소의 새로운 값입니다. |
z : | number | Z 구성요소의 새로운 값입니다. |
| 이 함수는 아무 값도 반환하지 않습니다. |
| |
set_y ( vector, value )벡터의 Y 구성요소 값을 설정합니다.
|
vector : | 구성요소를 설정할 벡터입니다. | |
value : | number | Y 구성요소의 새로운 값입니다. |
| 이 함수는 아무 값도 반환하지 않습니다. |
| |
set_z ( vector, value )벡터의 Z 구성요소 값을 설정합니다.
|
vector : | 구성요소를 설정할 벡터입니다. | |
value : | number | Z 구성요소의 새로운 값입니다. |
| 이 함수는 아무 값도 반환하지 않습니다. |
| |
subtract ( vector_a, vector_b ) : stingray.Vector3vector_b를 vector_a에서 빼고, 결과 벡터를 반환합니다.
|
vector_a : | 시작 벡터입니다. | |
vector_b : | 뺄 벡터입니다. |
|
빼기의 결과입니다. |
| |
to_elements ( vector ) : number, number, number지정된 벡터를 해당 구성요소 값으로 분해합니다.
|
vector : | 해당 구성요소로 분해할 벡터입니다. |
number |
벡터의 X 구성요소입니다. |
number |
벡터의 Y 구성요소입니다. |
number |
벡터의 Z 구성요소입니다. |
| |
to_string ( vector ) : string지정된 벡터의 문자열 표현을 반환합니다.
|
vector : | 문자열로 반환할 벡터입니다. |
string |
문자열 표현입니다. |
이 함수는 디버깅 용도로만 사용하십시오. 문자열을 저장한 다은 새 벡터로 다시 읽어 들이면 안 됩니다. 벡터를 여러 프레임에 저장하려면 Vector3Box를 사용합니다.
| |
up ( ) : stingray.Vector3위쪽(Z) 축을 반환합니다.
|
| |
x ( vector ) : number벡터의 X 구성요소 값을 반환합니다.
|
| |
y ( vector ) : number벡터의 Y 구성요소 값을 반환합니다.
|
| |
z ( vector ) : number벡터의 Z 구성요소 값을 반환합니다.
|
| |
zero ( ) : stingray.Vector3모든 값이 0으로 초기화된 새 벡터를 반환합니다.
|