언어:
페이지 정보
태그:
엔진 버전:
언리얼 엔진

블루프린트 디버깅

언리얼 엔진

Blueprint 디버깅은 중단점 사용을 통해 Play In Editor 나 Simulate In Editor 모드에서 게임 실행을 일시정지시키고 블루프린트나 레벨 블루프린트의 어느 그래프로도 들어가 볼 수 있는 매우 강력한 기능입니다.

디버깅 컨트롤

디버그 컨트롤을 통해 에디터에서 플레이에디터에서 시뮬레이트 모드에서의 게임 실행을 제어할 수 있습니다. 게임이 실행중이면 블루프린트 에디터에 컨트롤이 활성화되며, 디버깅중인 블루프린트 의 유형과 현재 디버깅 상태에 따라 툴바 에 다양한 디버깅 전용 버튼이 나타납니다.

debugging_editor.png

디버그 탭은 블루프린트 에디터 의 창 메뉴와 블루프린트 디버거 양쪽에서 열 수 있는데, 에디터에서 시뮬레이트 또는 에디터에서 플레이 모드가 활성 상태일 때는 컨텍스트에 따른 디버깅 버튼이 표시됩니다.

디버그 컨트롤을 통해 에디터에서 플레이에디터에서 시뮬레이트 모드에서의 게임 실행을 제어할 수 있습니다. 게임이 실행중이면 블루프린트 에디터에 컨트롤이 활성화되며, 디버깅중인 블루프린트 의 유형과 현재 디버깅 상태에 따라 툴바 에 다양한 디버깅 전용 버튼이 나타납니다. 일부 컨트롤은 중단점 에 걸렸을 때처럼 관련이 있는 상황에서만 나타납니다.

blueprint_debugger.png

중단점

중단점 (Breakpoints)은 에디터에서 게임을 실행할 때 특정 지점에서 게임 실행을 일시정지시키는 것입니다. 디버그 탭에는 한 그래프나 레벨 블루프린트에 속하는 모든 그래프에 대한 중단점 전부가 표시되지요. 목록에 표시되는 중단점 이름에는 하이퍼링크가 되어 있어, 클릭하면 그 중단점에 연결된 노드가 그래프 탭에 표시됩니다.

중단점은 함수 호출 이나 흐름 제어 같은 작업을 하는 그래프 내 어느 실행 노드에도 우클릭후 Add breakpoint 를 선택하여 설정할 수 있습니다. 그러면 노드 좌상단에 중단점이 설정되었음을 알리는 그래픽이 표시됩니다.

Blueprint Debugging - Breakpoint Enabled

중단점은 노드에 우클릭후 Disable breakpoint 를 선택하거나, 디버그 탭의 중단점 옆에 토글 오프 시키는 아이콘을 클릭하여서도 끌 수 있습니다. 이 작업은 디버그 탭에서 중단점에 우클릭하고 Disable breakpoint 를 선택해서 할 수도 있습니다.

Blueprint Debugging - Breakpoint Disable Option

그러면 중단점이 있기는 해도, 노드 실행시 게임을 중지시키지는 않습니다. 꺼진 중단점은 외곽선으로 표시됩니다.

Blueprint Debugging - Breakpoint Disabled

꺼진 중단점을 켜려면, 노드에 우클릭하고 Enable breakpoint 를 선택하거나 디버그 탭에서 중단점 옆의 아이콘을 클릭합니다. 디버그 탭에서 중단점에 우클릭하고 Enable breakpoint 를 선택해도 됩니다.

Blueprint Debugging - Breakpoint Enable Option

중단점 제거는 노드나 디버그 탭에서 중단점에 우클릭한 다음 Remove breakpoint 를 선택하면 됩니다.

중단점이 걸리면, 그래프는 중단점이 들어있는 노드에 포커스를 맞추고, 그 중단점 위에 표식이 나타납니다.

Blueprint Debugging - Breakpoint Hit Indicator

추가로 플레이어에게 디버깅때문에 게임이 일시정지되었음을 알리는 오버레이가 뷰포트에 표시됩니다.

Blueprint Debugging - Viewport overlay

디버그 탭과 블루프린트 디버거

디버그 탭에는 디자이너가 중단점과 감시값 형태로 중요하다 지정한 정보가 표시됩니다. 그 뿐만 아니라 블루프린트에 속한 여지껏 실행된 모든 노드 스택을 추적하기도 합니다. 이 창에는 중단점 사용시 게임 실행 제어를 위한 컨트롤도 표시됩니다.

감시값

감시값 (Watch value)을 통해 실행 도중 변수의 값을 쉽고 빠르게 살펴볼 수 있습니다. 중단점에 걸리면 선택된 액터는 물론 레벨 블루프린트에 대한 모든 감시값이 디버그 창에 표시되며, 그래프를 파 들어감(step through)에 따라 업데이트도 됩니다.

Blueprint Debugging - Watch Values

감시중인 값은 그래프의 변수 위에 방울 모양으로 직접 표시되게 하는 기능도 있습니다.

블루프린트 디버깅 - 감시값 정보 방울

감시 정보 방울 표시를 켜려면, 변수의 이름 옆에 있는 돋보기 (Blueprint Debugging - Watch Value Button) 버튼을 클릭하기만 하면 됩니다.

실행 추적

실행 추적 (Execution Trace) 스택에는 가장 최근에 실행된 노드가 맨 위로 올라오는 스택 목록이 표시됩니다.

Blueprint Debugging - Execution Trace Stack

디버깅시 그래프를 파고 들어감에 따라 이 목록이 업데이트됩니다.

태그