컨트롤 릭 디버깅

컨트롤 릭 디버깅 툴을 사용하여 컨트롤 릭 그래프 내에서 문제를 찾아 수정합니다.

Choose your operating system:

Windows

macOS

Linux

컨트롤 릭의 디버깅 툴을 사용하여 릭 행동을 평가하고 릭 그래프의 문제를 해결합니다. 이 문서에서는 이러한 툴에 대한 개요를 제공합니다.

전제조건

  • 컨트롤 릭 에셋을 생성한 상태여야 합니다. 생성 방법에 대한 정보는 컨트롤 릭 퀵스타트 페이지를 참조하세요.

디버그 모드

블루프린트 디버깅 과 유사하게 컨트롤 릭 그래프도 디버그 모드(Debug Mode) 를 사용하여 디버그할 수 있습니다. 이 모드를 사용하면 노드에 중단점을 추가하고, 그래프 로직을 살펴보고, 그래프 내 모든 지점의 라이브 프로퍼티 값을 검사할 수 있습니다.

디버그 모드는 컨트롤 릭 툴바의 릴리즈 모드(ReleaseMode) 를 클릭하여 활성화할 수 있습니다. 이 버튼은 디버그 모드와 릴리즈 모드 간을 토글합니다.

컨트롤 릭 디버그 모드

디버그 모드는 솔브 방향 컨텍스트를 지원하며, 정방향 솔브(Forwards Solve), 역방향 솔브(Backwards Solve), 설정 이벤트(Setup Event) 중 어느 것을 평가하고 있는지에 따라 적용됩니다.

중단점

노드 그래프를 디버깅할 때 중단점을 사용하면 지정된 노드에서 그래프의 평가를 중지하고 후속 노드를 살펴볼 수 있습니다. 이를 통해, 뷰포트 내에서 중단점 이전에 평가된 그래프 부분을 일시적으로 프리뷰할 수 있습니다. 중단점을 사용할 때는 평가가 그래프 끝에 도달할 때까지 시간이 흐르지 않으므로 축적된 시간 노드가 결과를 변경하지 않습니다.

릭 그래프 노드를 우클릭하고 중단점 추가(Add Breakpoint) 를 선택하여 중단점을 추가해 선택한 노드에서 그래프 평가를 일시정지할 수 있습니다. 디버그 모드가 활성화되어 있지 않은 경우에 중단점을 추가해도 자동으로 디버그 모드가 활성화됩니다.

컨트롤 릭 중단점

중단점을 지정한 후 스텝(Step) 툴바 버튼을 사용하여 그래프 평가를 노드별로 살펴볼 수 있습니다. 컨트롤 릭은 중단점 또는 현재 평가된 노드까지만 평가할 것입니다.

컨트롤 릭 노드 스텝

스텝 버튼이 수행하는 기능은 다음과 같습니다.

이름

아이콘

설명

재개(Resume)

재개

중단점에서 중단된 실행을 재개합니다. 다른 중단점이 나타나면 중지합니다.

포커스(Focus)

포커스

그래프 뷰의 포커스를 현재 디버깅되고 있는 노드에 맞춥니다.

다음으로 진행(Step Next)

스텝 노드

중단점에서 중지된 경우, 이 버튼을 누르면 평가의 다음 노드로 디버그 포커스가 넘어갑니다.

함수 안으로 진행(Step Into Function)

다음으로 진행

중단점에서 중지된 경우, 이 버튼을 누르면 평가의 다음 노드로 디버그 포커스가 넘어갑니다. 다음 노드가 함수 또는 접힌 그룹에 포함되어 있는 경우 뷰가 함수로 들어가서 해당 그룹의 첫 노드에 포커스를 맞춥니다.

함수 밖으로 진행(Step out of Function)

함수 밖으로 스텝

중단점에서 중지된 경우, 이 버튼을 누르면 평가의 다음 노드로 디버그 포커스가 넘어갑니다. 현재 노드가 함수 또는 접힌 그룹에 포함되어 있고 다음 노드가 함수 또는 그룹 밖에 위치한 경우, 그래프 뷰의 포커스가 그룹 밖의 다음 노드로 바뀝니다.

프로퍼티 감시

디버깅 시, 각 그래프 노드의 프로퍼티 값을 실시간으로 업데이트된 값이 표시되도록 환경설정할 수 있습니다. 이렇게 하려면 실시간으로 업데이트할 노드 핀을 우클릭하고 이 값 감시(Watch this value) 를 선택합니다.

컨트롤 릭 프로퍼티 감시

프로퍼티 감시를 설정하면 노드 상단에 해당 값 정보가 표시되며, 프로퍼티 옆에 감시되고 있음을 나타내는 아이콘이 표시됩니다.

컨트롤 릭 프로퍼티 감시

프로퍼티 디버깅을 중지하려면 핀을 우클릭하고 이 값 감시 중지(Stop watching this value) 를 선택합니다.

컨트롤 릭 프로퍼티 감시

클래스 세팅 디버그 및 프로파일링

클래스 세팅 디테일 패널에는 그래프의 퍼포먼스 디버깅을 위한 툴과 프로퍼티가 포함되어 있습니다. 클래스 세팅(Class Settings) 을 클릭하면 이 패널이 나타납니다.

컨트롤 릭 클래스 세팅

노드 실행 수 표시(Show Node Run Counts) 를 활성화하면 노드가 실행된 횟수가 표시됩니다. 이는 루핑 또는 컬렉션 노드가 제대로 실행되는지 확인할 때 유용합니다.

컨트롤 릭 노드 실행 수 표시

VM 프로파일링

버추얼 머신 프로파일링(Virtual Machine Profiling),VM 프로파일링(VM Profiling) 을 사용해서도 리얼타임 그래프 퍼포먼스 및 노드 실행 속도를 디버깅할 수 있습니다.

VM 런타임 세팅(VMRuntime Settings) 카테고리에 있는 프로파일링 활성화(Enable Profiling) 를 클릭하여 릭 그래프 프로파일링을 시작합니다. 최소(Min)최대 기간 색(Max Duration Color) 프로퍼티는 어떤 노드가 실행 시간이 가장 오래 걸리거나 가장 짧게 걸리는지를 마이크로초 단위로 보여주는 데 사용됩니다. 총 마이크로초(μs) 수도 노드 옆에 표시됩니다.

컨트롤 릭 VM 프로파일링

실행 스택

실행 스택 패널은 그래프 내 노드의 작동 순서에 대한 레퍼런스를 제공합니다. 이는 노드를 디버깅하고 이벤트 시퀀스를 평가하는 용도로 사용 가능합니다.

실행 스택 패널은 컨트롤 릭 메뉴 바로 이동하여 창(Window) > 실행 스택(Execution Stack) 을 선택하면 열 수 있습니다.

실행 스택

실행 스택을 열면 다음 정보가 표시됩니다.

실행 스택

  1. 노드 열(Node Column) 은 주어진 솔브 방향에서 모든 노드의 평가 순서를 표시합니다. 여기서 노드를 더블클릭하면 릭 그래프 뷰의 프레임이 해당 노드에 맞춰집니다. 또한 릭 그래프에서 노드를 선택하면 관련된 인스트럭션이 하이라이트됩니다.

  2. 노드 실행 수(Node Run Count) 는 노드가 실행된 횟수를 표시합니다. 이는 노드 실행 수 표시(Show Node Run Counts)클래스 세팅(Class Settings)에서 활성화된 경우에만 표시됩니다.

  3. 마이크로초 수(Microsecond Count)프로파일링(Profiling)이 활성화된 경우 노드 실행에 걸리는 총 시간을 마이크로초(μs) 단위로 표시합니다.