언리얼 엔진 5 문서가 에픽 디벨로퍼 커뮤니티로 이전되었습니다

Blueprint Macro (블루프린트 매크로) 또는 Macro (매크로)는 본질적으로 노드 그래프를 접은 것과 같습니다. 터널 노드로 지정되는 입구와 출구가 있습니다. 각 터널에는 다른 블루프린트와 그래프에서 사용될 때 매크로 노드에 보이는 실행 또는 데이터 핀이 몇 개든 있을 수 있습니다.

블루프린트 매크로 만들기

블루프린트 매크로 는 블루프린트 클래스또는 레벨 블루프린트안에서 만들 수 있습니다. 블루프린트 함수처럼요. 또한 블루프린트 매크로 라이브러리에 정리해 넣을 수도 있습니다.

블루프린트 클래스, 레벨 블루프린트, 또는 블루프린트 매크로 라이브러리안에서 블루프린트 매크로를 만들려면:

1. 내 블루프린트 탭에서 매크로 목록 제목줄의 추가 버튼 을 클릭하여 새 매크로를 만듭니다.

2. _블루프린트 매크로 의 이름을 입력합니다.

블루프린트 매크로 가 블루프린트 에디터의 그래프 탭 안의 새 탭에 열립니다.

내 블루프린트 탭에 우클릭한 다음 매크로 를 선택하는 것으로 블루프린트 매크로를 만들 수도 있습니다.

블루프린트 매크로 빌드하기

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

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

입력 또는 출력 파라미터를 추가하려면:

1. 디테일 패널의 입력 또는 출력 섹션 중 하나에서 새 버튼을 누릅니다.

2. 드롭다운 메뉴를 사용해서 새 파라미터 유형을 설정하고 이름을 짓습니다. 이 예제에는 Score 라는 이름의 정수데이터 입력, Test 라는 이름의 실행 입력 핀, Win 과 Lose 라는 이름의 출력 실행 핀 두 개가 있습니다.

   블루프린트 매크로 그래프 안의 터널 노드가 알맞은 핀으로 자동 업데이트됩니다.

3. 또한 파라미터 항목을 펼쳐서 기본값을 설정하는 것도 가능합니다.

노드 가장자리에서의 이 파라미터 핀 위치를 바꾸려면, 펼쳐진 디테일 패널 항목의 위 아래 화살표를 사용하세요.

블루프린트 매크로 에 함수성을 약간 주려면, 데이터나 실행 선을 입력 및 출력 터널 노드의 핀에 연결한 다음 그 사이에 네트워크를 만들어 줍니다.

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

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

매크로 구현하기

다른 블루프린트그래프에 매크로노드를 추가하는 방법도 여러가지 있습니다. 펑션노드와 커스텀 이벤트 콜노드처럼, 블루프린트의 그래프 전반에 걸쳐 매크로노드의 사본을 여럿 추가하는 것도 가능합니다.

매크로 추가를 위해서는, 그래프에 우클릭하면 뜨는 컨텍스트 메뉴에서 매크로를 선택하면 됩니다.

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

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

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