매크로

다른 그래프에서 실행 또는 호출할 수 있는 접힌 노드 망입니다.

Windows
MacOS
Linux

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

블루프린트 매크로 만들기

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

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

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

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

    name_macro_blueprint.png

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

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

add_macro_rtclick.png

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

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

input_output_macro.png

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

new_macro_details.png

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

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

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

    macro_details.png

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

    macro_tunnels_with_pins.png

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

    macro_details_expanded.png

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

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

score_comparison_example_macro.png

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

move_pin_arrows.png

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

data_macro.png

매크로 구현하기

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

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

right_click_add_macro.png

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

pin_macro_summon.png

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

macro_drag_1.png

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

태그
Select Skin
Light
Dark

새로운 언리얼 엔진 4 문서 사이트에 오신 것을 환영합니다!

문서 사이트에 대한 의견을 모을 수 있는 피드백 시스템을 포함해서 여러가지 새로운 기능을 준비하고 있습니다. 아래 Documentation Feedback 포럼(영문) 또는 언리얼 엔진 네이버 공식 카페(한글) 중 편하신 곳에 의견이나 문제점을 알려 주세요.

새 시스템이 준비되면 알려 드리겠습니다.

네이버 카페
공식 포럼