Blueprint Macro Library (블루프린트 매크로 라이브러리)란 다른 블루프린트 에 넣어 사용할 수 있는 매크로 또는 독립된 그래프 모음을 담는 그릇입니다. 자주 사용되는 노드 시퀀스를 실행과 데이터 전송을 위한 입력과 출력까지 그대로 포함시켜 저장할 수 있으니, 시간을 절약할 수 있습니다.
매크로 는 자신을 참조하는 모든 그래프에 공유되지만, 컴파일 도중에는 마치 접혀있던 노드인양 원래 그래프로 자동 펼쳐집니다. 즉 블루프린트 매크로 라이브러리 는 컴파일할 필요가 없지만, 매크로 에 가한 변경내용은 그 그래프를 포함하는 블루프린트 가 리컴파일될 때 해당 매크로 를 참조하는 그래프에만 반영됩니다.
블루프린트 매크로 라이브러리 생성하기
블루프린트 매크로 라이브러리 는 다른 에셋들처럼 패키지에 저장되며, 콘텐츠 브라우저를 통해 생성 가능합니다.
-
콘텐츠 브라우저에서
버튼을 클릭합니다.
-
나타나는 메뉴에서 고급 에셋 생성 아래 블루프린트 > 블루프린트 매크로 라이브러리 를 선택합니다.
-
블루프린트 매크로 라이브러리 의 부모 클래스 를 선택합니다.
-
콘텐츠 브라우저에 블루프린트 매크로 라이브러리 가 나타납니다. 콘텐츠 브라우저에서 그 블루프린트 매크로 라이브러리 의 아이콘 아래에 이름을 입력합니다.
블루프린트 매크로 라이브러리 가 처음 생성될 때, 또는 블루프린트 에디터 에서 변경을 가할 때, 콘텐츠 브라우저의 블루프린트 매크로 라이브러리 아이콘에 별표 모양이 추가됩니다. 블루프린트 매크로 라이브러리 가 저장되지 않았음을 나타냅니다.
콘텐츠 브라우저에서 블루프린트 매크로 라이브러리 생성 메뉴에 접근하는 방법은 두 가지 더 있습니다.
-
콘텐츠 브라우저의 (오른쪽) 에셋 뷰 패널, 또는 콘텐츠 브라우저 의 (왼편) 에셋 트리 패널에서 폴더에 우클릭합니다.
-
뜨는 메뉴에서 고급 에셋 생성 아래 블루프린트 > 블루프린트 매크로 라이브러리 를 선택합니다.
-
부모 클래스 선택 창이 뜨는데, 이 시점부터 블루프린트 매크로 라이브러리 생성 프로세스는 새 에셋 버튼을 눌렀을 때와 같습니다.
블루프린트 매크로
Blueprint Macro (블루프린트 매크로) 또는 Macro (매크로)는 본질적으로 노드 그래프를 접은 것과 같습니다. 터널 노드로 지정되는 입구와 출구가 있습니다. 각 터널에는 다른 블루프린트와 그래프에서 사용될 때 매크로 노드에 보이는 실행 또는 데이터 핀이 몇 개든 있을 수 있습니다.
블루프린트 매크로 생성하기
블루프린트 매크로 는 블루프린트 클래스또는 레벨 블루프린트안에서 만들 수 있습니다. 블루프린트 함수처럼요. 또한 블루프린트 매크로 라이브러리에 정리해 넣을 수도 있습니다.
블루프린트 클래스, 레벨 블루프린트, 또는 블루프린트 매크로 라이브러리안에서 블루프린트 매크로를 만들려면:
-
내 블루프린트 탭에서
매크로 목록 제목줄의
추가 버튼 을 클릭하여 새 매크로를 만듭니다.
-
블루프린트 매크로의 이름을 입력합니다.
블루프린트 매크로가 블루프린트 에디터의 그래프 탭 안의 새 탭에 열립니다.
내 블루프린트 탭에 우클릭한 다음 매크로 를 선택하는 것으로 블루프린트 매크로를 만들 수도 있습니다.

블루프린트 매크로 빌드하기
블루프린트 매크로를 처음 만들면, 입력 터널 노드와 출력 터널 노드가 들어있는 그래프가 새로 열립니다.

블루프린트 매크로의 디테일 패널에서 입/출력 실행/데이터 핀을 추가할 수 있습니다. 블루프린트 매크로의 설명, 범주, 인스턴스 컬러 를 설정할 수도 있습니다.

입력 또는 출력 파라미터를 추가하려면:
-
디테일 패널의 입력 또는 출력 섹션 중 하나에서 새 버튼을 누릅니다.
-
드롭다운 메뉴를 사용해서 새 파라미터 유형을 설정하고 이름을 짓습니다. 이 예제에는 Score 라는 이름의 정수데이터 입력, Test 라는 이름의 실행 입력 핀, Win 과 Lose 라는 이름의 출력 실행 핀 두 개가 있습니다.
블루프린트 매크로 그래프 안의 터널 노드가 알맞은 핀으로 자동 업데이트됩니다.
-
또한 파라미터 항목을 펼쳐서 기본값을 설정하는 것도 가능합니다.
노드 가장자리에서의 이 파라미터 핀 위치를 바꾸려면, 펼쳐진 디테일 패널 항목의 위 아래 화살표를 사용하세요.
블루프린트 매크로 에 함수성을 약간 주려면, 데이터나 실행 선을 입력 및 출력 터널 노드의 핀에 연결한 다음 그 사이에 네트워크를 만들어 줍니다.

이 예제 블루프린트 매크로는 매크로에 입력된 점수가 이기는 데 필요한 점수보다 큰지 검사한 다음 비교 결과에 따라 각기 다른 출력 실행 흐름을 선택합니다. 참고로 여기에는 디테일 패널의 위 아래 화살표를 사용해서 Test 와 Score 핀을 뒤집었습니다. 블루프린트 매크로그래프에서 선이 꼬이는 것을 피하기 위해서입니다.

함수와 달리 매크로는 하나 이상의 출력 실행 핀을 가질 수 있어, 그래프 로직의 결과에 따라 이와 같이 다양한 출력 실행 핀이 활성화되는 실행 흐름이 가능합니다. 또한 매크로안의 노드가 실행 노드만 아니라면 데이터만 조작할 뿐 실행 핀이 없는 매크로도 있을 수 있습니다.

블루프린트 매크로 라이브러리에 저장된 매크로 사용하기
블루프린트 매크로 라이브러리 에 매크로 를 저장하면 프로젝트 전반에 걸쳐 블루프린트 클래스 와 레벨 블루프린트 에서 해당 매크로를 사용할 수 있게 됩니다.
다른 블루프린트 그래프에 매크로 노드를 추가하는 방법도 여러가지 있습니다. 펑션 노드와 커스텀 이벤트 콜 노드처럼, 블루프린트의 그래프 전반에 걸쳐 매크로 노드의 사본을 여러 개 추가하는 것도 가능합니다.
매크로 추가를 위해서는, 그래프에 우클릭 하면 뜨는 컨텍스트 메뉴에서 매크로를 선택하면 됩니다.

다른 노드의 핀에 드래그 앤 드롭할 수도 있는데, 거기에 해당 변수 유형의 파라미터 핀과 흐름 방향이 있다면 컨텍스트 메뉴에 매크로가 나타납니다.

매크로 노드를 그래프에 추가하고 나면, 다른 노드와 비슷한 방식으로 작동하며, 입출력 핀도 비슷하게 연결할 수 있습니다. 아무 블루프린트 그래프의 매크로 노드에 더블클릭 하면 매크로의 그래프가 열립니다.