[Unreal 개발기] 5 - FVector API 정리

Caution!!

This document is made in unreal 4.14

---------------------------------------------------------------------------------------------------

본 정리는 

https://docs.unrealengine.com/latest/INT/API/Runtime/Core/Math/FVector/index.html

위 주소의 원문에서 정리한 내용입니다.

알면 바로 사용할 수 있는 함수들만 따로 정리했습니다.

---------------------------------------------------------------------------------------------------

FVector는 앞에 F가 붙어 있는 걸 보았을때 구조체라는 것을 알 수 있습니다.

막상 선언부를 가서 보아도 구조체라는 것을 알 수 있습니다.

FVector 는 3D 공간상에서 xyz의 컴포넌트를 가지는 구조체입니다.

-변수-

X : float

Y : float

Z : float

-Constructor- 

=> FVector 생성시 실행되는 함수들이 Override 되어 있습니다.

FVector()    초기화를 시키지 않는 생성입니다.  ex > Fvector().X=30.f;

FVector(float Inf)    모든 컴포넌트(x,y,z)를 Inf값으로 초기화 시킵니다.

FVector(const FVector4 & V)    FVector4를 이용해 xyz값을 초기화 시킵니다.

..... 중간 Constructor는 생략

FVector(const FVector2D V , float InZ)    FVector2를 이용해 x,y를 초기화 시키고 InZ를 이용

해 Z를 초기화 시킵니다.

FVector(float x, float y, float z)    x,y,z,로 xyz 컴포넌트를 각각 초기화 시킵니다.

-Function-

bool AllComponentsEqual (float Tolerance)

해당 벡터의 모든 컴포넌트(x,y,z)가 Tolerance 이상인지 판별하는 함수

=범위를 넘었는지 판별용

FVector a = this->GetActorLocation();

bool check = true;

check=a.AllComponentsEqual(4);

if (check)

{

UE_LOG(LogClass, Warning, TEXT("check is true"));

}

else

{

UE_LOG(LogClass, Warning, TEXT("check is false"));

}

FVector BoundToCube(float Radius)

해당 벡터의 모든 컴포넌트를 Radius값 이하로 조절하는 함수 

=오브젝트의 최대 움직임 반경 설정

FVector a = this->GetActorLocation();

a=a.BoundToCube(100);

this->SetActorLocation(a);

FVector ClampMaxSize(float MaxSize)

해당 벡터의 모든 컴포넌트를 Maxsize 이하로 조절한다.

사용 방법은 BoundToCube와 동일.

FVector ClampSize(float Min ,float Max)

해당벡터의 모든 컴포넌트를 Min이상 Max이하로 조절한다.

FVector a = this->GetActorLocation();

a = a.ClampSize(100,200);

this->SetActorLocation(a);

bool Coincident(const FVector & Nomal1, const FVector & Nomal2 , float ParallelCosineThreshold)

두 벡터의 방향성이 거의 ParallelCosineThreshold(오차범위) 내외로 비슷한지 판별하는 함수

FVector a = this->GetActorLocation();

bool check = a.Coincident(FVector(0,0,1), FVector(0, 0, 1));

if (check)

{

UE_LOG(LogClass, Warning, TEXT("check is true"));

}

else

{

UE_LOG(LogClass, Warning, TEXT("check is false"));

}

bool ConstainsNaN()

해당 벡터에 x,y,z로 들어갈 수 없는 값이 들어가 있는지 확인하는 함수 

(무한대 숫자들이 걸러진다. 또는 들어가면 안되는게 들어 갔을때 걸러진다.)

FVector a = this->GetActorLocation();

//???????????????????????? CrossProduct에 쓸수 있네

bool check = a.ContainsNaN();

if (check!=true)

{

UE_LOG(LogClass, Warning, TEXT("이상한거 없어"));

}

else

{

UE_LOG(LogClass, Warning, TEXT("미친 뭘 집어넣은 거야"));

}

float Dist(cibst FVector & V1, const FVector & V2)

두 벡터 사이의 거리를 구하는 함수

FVector a;

FVector c;

a.Set(2, 0, 0);

c.Set(0,2,0);

float num = FVector().Dist(a, c);

UE_LOG(LogClass, Warning, TEXT("%f"),num);

bool Equals(const FVector & V , float Tolerance)

해당 벡터가 V 벡터와 같은지 오차범위 Tolerance 안에서 반별하는 함수

FVector a;

FVector c;

c.Set(100,0,0 );

a.Set(100, 0, 0);

bool check = c.Equals(a);

if (check)

{

UE_LOG(LogClass, Warning, TEXT("이상한거 없어"));

}

else

{

UE_LOG(LogClass, Warning, TEXT("미친 뭘 집어넣은 거야"));

}

bool Orthogonal(정규화 벡터 1 , 정규화 벡터 2, 오차범위)

두 정규화 벡터라고 하지만 그냥 벡터를 넣어도 무방하다. 

이 두 벡터가 직각인지 오차 범위 내에서 확인 해준다.

FVector a;

FVector c;

c.Set(0, 1, 0);

a.Set(100, 0, 0);

bool check = FVector().Orthogonal(a, c);//마지막 매개변수는 오차 범위인거 같은데 전혀 도움 안되니 걍 쓰지마

if (check)

{

UE_LOG(LogClass, Warning, TEXT("이상한거 없어"));

}

else

{

UE_LOG(LogClass, Warning, TEXT("미친 뭘 집어넣은 거야"));

}

bool PointsAreNear(벡터 1 , 벡터 2 , 오차범위)

두 벡터가 오차범위 내로 근접해 있는지 확인해주는 함수

FVector a;

FVector c;

c.Set(0, 4, 0);

a.Set(0, 0, 0);

bool check = FVector().PointsAreNear(a, c,3.f);//마지막 매개변수는 오차 범위인거 같은데 전혀 도움 안되니 걍 쓰지마

if (check)

{

UE_LOG(LogClass, Warning, TEXT("이상한거 없어"));

}

else

{

UE_LOG(LogClass, Warning, TEXT("미친 뭘 집어넣은 거야"));

}

그 밖에

Set

ToString

ToText

가 있지만 사용하는 방법이 쉬워 생략합니다.

-Operators-

연산자들

-    마이너스 연산 가능

+    플러스 연산 가능

/    연산 가능

*    연산 가능

!=    조건 연산가능 

==    조건 연산가능

!        조건 연산가능

*=

-=

+=

/=    2항연산 가능

-Constants-

ForwardVector = (1,0,0)

RightVector = (0,1,0)

UpVector = (0,0,1)

ZeroVector = (0,0,0)

각각 FVector T.ForwardVector; 처럼 사용할 수 있다.