Blueprint Macro (블루프린트 매크로) 또는 Macro (매크로)는 본질적으로 노드 그래프를 접은 것과 같습니다. 터널 노드로 지정되는 입구와 출구가 있습니다. 각 터널에는 다른 블루프린트와 그래프에서 사용될 때 매크로 노드에 보이는 실행 또는 데이터 핀이 몇 개든 있을 수 있습니다.
블루프린트 매크로 만들기
블루프린트 매크로 는 블루프린트 클래스또는 레벨 블루프린트안에서 만들 수 있습니다. 블루프린트 함수처럼요. 또한 블루프린트 매크로 라이브러리에 정리해 넣을 수도 있습니다.
블루프린트 클래스, 레벨 블루프린트, 또는 블루프린트 매크로 라이브러리안에서 블루프린트 매크로를 만들려면:
-
내 블루프린트 탭에서
매크로 목록 제목줄의
추가 버튼 을 클릭하여 새 매크로를 만듭니다.
-
블루프린트 매크로의 이름을 입력합니다.
블루프린트 매크로가 블루프린트 에디터의 그래프 탭 안의 새 탭에 열립니다.
내 블루프린트 탭에 우클릭한 다음 매크로 를 선택하는 것으로 블루프린트 매크로를 만들 수도 있습니다.

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

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

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

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

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

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

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

다른 방법으로는, 내 블루프린트 탭에서 매크로를 끌어 그래프에 떨구면 됩니다.

매크로 노드가 그래프에 추가되면 다른 여느 노드처럼 작동하며, 입출력 핀도 그에 맞게 연결됩니다. 매크로노드에 더블클릭 하면 매크로의 그래프가 열립니다.