블루프린트 변수

Variable (변수)는 월드에 있는 Object 나 Actor 에 대한 값이나 주소(reference)를 담는 프로퍼티입니다. 이 프로퍼티는 내부적으로는 그를 담고있는 Blueprint 에서 접근 가능하며, 외부적으로 접근 가능하게 하여 레벨에 놓은 Blueprint 인스턴스 작업을 하는 디자이너가 그 값을 변경하도록 할 수도 있습니다.

Variable (변수)는 변수 이름이 들어간 둥근 박스로 표시됩니다:

마티네를 사용해서 특정 유형 변수값을 변경하는 법에 대한 정보는, 문서를 참고하세요.

변수 유형

변수는 다양한 유형으로 생성 가능한데, Boolean (True / False), Integer (정수), Float (실수) 와 같은 데이터 형은 물론이고 Object, Actor, 특정 Class 와 같은 것을 담는 레퍼런스 형도 생성 가능합니다. 각 변수형을 배열 로도 만들 수 있으며, 각 유형은 색을 통해 쉽게 알아볼 수 있습니다:

변수 유형	색	예제	용도
Boolean	빨강		빨강 변수는 부울 (True / False) 데이터를 나타냅니다.
Integer	청록		청록 변수는 0, 152, -226 와 같은 정수 데이터, 또는 소수점이 없는 숫자를 나타냅니다.
Float	초록		초록 변수는 0.0553, 101.2887, -78.322 와 같은 실수 데이터, 또는 소수점이 있는 숫자를 나타냅니다.
String	자홍		자홍 변수는 Hello World 와 같은 문자열 데이터, 또는 알파벳과 숫자로 된 글자 그룹을 나타냅니다.
Text	분홍		분홍 변수는 표시되는 텍스트, 특히나 현지화가 가능한 텍스트를 나타냅니다.
Vector	금색		금색 변수는 벡터 데이터, 또는 XYZ 나 RGB 처럼 세 개의 실수로 구성되는 요소나 축 정보를 나타냅니다.
Rotator	보라		보라 변수는 3D 공간에서의 회전을 수치로 정의하는 그룹인 로테이터 데이터를 나타냅니다.
Transform	주황		주황 변수는 트랜슬레이션 (3D 위치), 로테이션, 스케일로 구성되는 트랜스폼 데이터를 나타냅니다.
Object	파랑		파랑 변수는 오브젝트, 즉 라이트, 액터, 스태틱 메시, 카메라, 사운드 큐 등을 나타냅니다.

내 블루프린트 탭의 변수

내 블루프린트 탭을 통해 커스텀 변수를 블루프린트 에 추가할 수도 있고, 컴포넌트 리스트 에 추가된 컴포넌트 인스턴스 변수라던가 그래프에서 값을 변수로 승격시켜 만든 변수를 포함해서 기존 변수를 나열할 수도 있습니다.

편집가능 변수

변수가 Editable, 편집가능으로 설정되면, 변수가 들어있는 블루프린트 외부에서 그 변수를 수정할 수 있게 됩니다.

변수에 편집가능 설정은 디테일 패널에서 편집가능 옵션을 체크하거나, 내 블루프린트 창 안의 변수 옆 감긴 눈 모양 아이콘을 클릭하면 됩니다. 눈 아이콘이 감겨 있으면, 변수는 현재 편집 가능한 상태가 아닙니다 (기본). 눈 아이콘이 열려 있으면, 변수가 퍼블릭 (또는 아래와 같이 편집가능) 설정되어 있는 것입니다.

변수가 편집가능 설정되면, 메인 에디터 창의 디테일 패널에서 변수의 값을 설정할 수 있습니다.

위에서, LightColor 변수가 편집가능 설정되어 이 값을 레벨 에디터의 디테일 패널에서 설정할 수 있습니다.

변수 툴팁

에디터에서 변수에 마우스 커서를 올렸을 때 나타나는 변수에 대한 Tooltip, 툴팁을 추가할 수도 있습니다.

변수의 디테일 패널에서 툴팁 을 추가하면 됩니다. 그 때 변수가 퍼블릭 으로 설정된 경우, 눈 아이콘의 색이 노랑에서 초록으로 바뀌어 변수에 툴팁이 작성되었음을 나타냅니다.

스폰시 노출

Expose on Spawn, 스폰시 노출 옵션은 변수가 들어있는 블루프린트 스폰 시점에서 그 변수를 접근 가능하도록 할 것인지 설정할 수 있습니다.

위에서 LightColor 라는 변수가 있는데, 스폰시 노출 설정되어 있는 Linear Color 프로퍼티입니다. 이 변수는 포인트 라이트에 대한 블루프린트에 구현되어 있으며, Set Light Color 노드와 LightColor 변수를 사용하여 라이트의 색을 결정하고 있습니다.

아래 다른 블루프린트 내에서, 스크립트를 사용하여 포인트 라이트 블루프린트를 스폰하고 LightColor 변수가 스폰시 노출 설정되어 있기 때문에, Spawn Actor from Class 노드에 값 설정을 위한 옵션이 사용가능해져, 게임 월드에 라이트가 스폰되면 그 색을 설정할 수 있게 됩니다.

프라이빗 변수

변수에 Private, 프라이빗 옵션이 체크되면, 외부 블루프린트에서 변수를 수정하는 것이 금지됩니다.

예를 들어 아래 프라이빗으로 설정되지 않은 변수가 있습니다:

다른 변수에서, 그 변수가 들어있는 블루프린트를 스폰한 다음, Return Value 를 통해 변수에 접근할 수 있습니다.

하지만 프라이빗으로 설정하고:

블루프린트를 다시 스폰한 뒤 그 변수 접근을 시도해 보면, 안됩니다.

마티네에 노출

변수가 마티네 에 영향받을 수 있도록 하려면, Expose to Matinee, 마티네에 노출 옵션을 체크해야 합니다.

아래에서, 마티네를 만들어 블루프린트가 들어있는 트랙을 추가했습니다. 그런 다음 마티네를 통해 그 블루프린트의 Linear Color 변수를 변경하려면, LinearColor Property Track 을 추가합니다.

그러면 Linear Color 변수 선택을 위한 창이 뜨는데, 블루프린트에서 변경할 (LightColor) 프로퍼티를 선택합니다.

그 이후 트랙에 키를 추가하여 변수 값을 시간에 따라 변경할 수 있습니다.

마티네 작업 관련 상세 정보는 문서를 참고하세요.

변수로 승격

Promote to Variable, 변수로 승격 옵션을 사용해서도 변수를 만들 수 있습니다.

블루프린트 노드의 아무 입력 또는 출력 데이터 핀에 우클릭 한 다음 변수로 승격 옵션을 선택하면 됩니다.

New Light Color 핀에 우클릭 한 다음 변수로 승격 을 선택하는 것으로, 변수에 New Light Color 값을 할당할 수 있습니다.

다른 방법으로는, 입력 또는 출력 핀을 끌어놓은 다음 변수로 승격 옵션을 선택합니다.

블루프린트의 변수 접근하기

블루프린트의 변수 작업을 할 때, 보통 두 가지 방법 중 하나로 접근하게 됩니다. 변수 값을 구해오는 Get 노드 또는 변수 값을 설정하는 Set 노드입니다.

변수에 대한 Set (위에서 1) 또는 Get (위에서 2) 노드 생성은 그래프에 우클릭 한 다음 Set (변수 이름) 또는 Get (변수 이름) 을 선택하면 됩니다. 또다른 방법은, Ctrl 키를 누른 채 내 블루프린트 창에서 변수를 끌어 놓으면 Get 노드가 생성되고, Alt 키를 누른 채 끌어 놓으면 Set 노드가 생성됩니다.

변수 편집하기

변수 값의 설정은 블루프린트 노드 네트워크의 일부에서도 실행 전 기본값으로도 가능합니다. 변수 기본값을 설정하려면:

1. 블루프린트 툴바에 있는 클래스 디폴트 버튼을 클릭하여 디테일 패널에 디폴트를 엽니다.

2. 디테일 패널에서 변수 이름 오른쪽에 원하는 기본값을 입력합니다.

   

   위에서 Color 변수를 선택하여 기본 색을 설정할 수 있습니다.

디폴트 창에 변수가 보이지 않는 경우, 컴파일 버튼을 클릭하세요.

변수 이름변경

변수 이름을 변경하려면:

1. 내 블루프린트 탭에서 변수 이름에 우클릭하면 뜨는 메뉴에서 이름변경 을 선택합니다.

   

2. 글상자에 새로운 변수 이름을 입력한 다음 Enter 키를 눌러 저장합니다.

   

변수 프로퍼티

디테일 패널에서 변수에 대한 모든 프로퍼티를 설정할 수 있습니다. 몇몇 변수는 여기 보이는 것보다 많은 프로퍼티가 있습니다. 이를테면 벡터의 경우 Expose to Matinee (마티네에 노출)이라던가, 정수와 실수와 같은 숫자값의 경우 Slider Range (슬라이더 범위) 라던가요.

변수 값 구하고 설정하기

변수의 편집은 블루프린트 네트워크에서 Get / Set 노드를 통한 방법으로도 가능합니다. 가장 쉬운 방법은 변수 탭에서 Event Graph 에 바로 변수를 끌어 놓는 것입니다. Get / Set 어느 노드를 만들 것인지 묻는 작은 창이 뜹니다.

Get 노드

Get 노드는 네트워크에 변수 값을 줍니다. 이 노드는 생성 이후 적합한 유형을 받는 어느 노드에나 연결할 수 있습니다.

Set 노드

Set 노드는 변수의 값을 바꿔줍니다. 참고로 실행을 위해서는 실행 선의 호출을 받아야 한다는 점, 유념해 주시기 바랍니다.