Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

Checking the stable version of the documentation...

출력 로그

출력 패널은 화면 하단에 있습니다. **출력**을 클릭하여 엽니다.

출력 패널은 프로젝트(및 편집기)에서 인쇄된 텍스트를 더 쉽게 볼 수 있도록 하는 여러 기능을 제공합니다.

참고

기본적으로 프로젝트를 실행하면 출력 패널이 자동으로 열립니다. 실행 > 하단 패널 > 재생 시 작업 편집기 설정을 변경하여 이 동작을 제어할 수 있습니다.

메시지 카테고리

네 가지 메시지 범주를 사용할 수 있습니다.

로그: 프로젝트에서 인쇄한 표준 메시지입니다. 흰색 또는 검정색으로 표시됩니다(편집기 테마에 따라 다름).
오류: 일종의 실패를 나타내는 프로젝트나 편집자에 의해 인쇄된 메시지입니다. 빨간색으로 표시됩니다.
경고: 중요한 정보를 보고하지만 실패를 나타내지는 않는 프로젝트 또는 편집자에 의해 인쇄되는 메시지입니다. 노란색으로 표시됩니다.
편집기: 편집기에 의해 인쇄되는 메시지로, 일반적으로 실행 취소/다시 실행 작업의 추적을 목적으로 합니다. 회색으로 표시됩니다.

메시지 필터링

오른쪽에 있는 버튼을 클릭하면 특정 메시지 카테고리를 숨길 수 있습니다. 이렇게 하면 원하는 특정 메시지를 더 쉽게 찾을 수 있습니다.

출력 패널 하단에 있는 필터 메시지 상자를 사용하여 텍스트 내용을 기준으로 메시지를 필터링할 수도 있습니다.

메시지 비우기

프로젝트를 실행하면 기본적으로 기존 메시지가 자동으로 지워집니다. 이는 실행 > 출력 > 재생 시 항상 출력 지우기 편집기 설정에 의해 제어됩니다. 또한 출력 패널의 오른쪽 상단에 있는 "청소 브러시" 아이콘을 클릭하여 메시지를 수동으로 지울 수 있습니다.

메시지 출력하기

메시지를 출력하는 데에는 여러 방법이 사용 가능합니다:

print(): 메시지를 인쇄합니다. 이 메소드는 인쇄 시 함께 연결되는 여러 인수를 허용합니다. 이 메서드에는 각각 탭과 공백으로 인수를 구분하는 변형이 있습니다: printt() 및 prints().
print_rich(): ``print()``와 동일하지만 BBCode를 사용하여 인쇄되는 텍스트 형식을 지정할 수 있습니다(아래 참조).
push_error(): 오류 메시지를 인쇄합니다. 실행 중인 프로젝트에서 오류가 인쇄되면 대신 디버거 > 오류 탭에 표시됩니다.
push_warning(): 경고 메시지를 인쇄합니다. 실행 중인 프로젝트에 경고가 인쇄되면 대신 디버거 > 오류 탭에 표시됩니다.

보다 복잡한 사용 사례의 경우 다음을 사용할 수 있습니다.

print_verbose(): print()``와 동일하지만 프로젝트 설정에서 상세 모드가 활성화되거나 프로젝트가 ``--verbose 명령줄 인수로 실행되는 경우에만 인쇄됩니다.
printerr(): ``print()``와 동일하지만 표준 출력 문자열 대신 표준 오류 스트림으로 인쇄합니다. 대부분의 경우 ``push_error()``가 선호됩니다.
printraw(): ``print()``와 동일하지만 끝에 빈 줄 없이 인쇄합니다. 이는 편집기 출력 패널에 인쇄하지 않는 유일한 방법입니다. 표준 출력 스트림으로 만 인쇄합니다. 이는 파일 로깅에 여전히 포함된다는 의미입니다.
print_debug(): Same as print(), but adds the current stack frame on a new line at the end. Only supported when running from the editor, or when the project is exported in debug mode.
print_stack(): 현재 위치에서 스택 추적을 인쇄합니다. 편집기에서 실행하거나 프로젝트를 디버그 모드로 내보낼 때만 지원됩니다.
print_tree(): 현재 노드를 기준으로 씬 트리를 인쇄합니다. 런타임에 생성된 노드 구조를 디버깅하는 데 유용합니다.
print_tree_pretty(): ``print_tree()``와 동일하지만 보다 나무와 같은 모양을 위해 유니코드 문자를 사용합니다. 이는 `상자 그리기 문자 <https://en.wikipedia.org/wiki/Box-drawing_characters>`__에 의존하므로 모든 글꼴에서 올바르게 렌더링되지 않을 수 있습니다.

고급 형식 지정 기능을 얻으려면 위의 인쇄 기능과 함께 :ref:`doc_gdscript_printf`를 사용하는 것이 좋습니다.

엔진의 로깅 기능은 logging 문서에서 다룹니다.

경고 시스템(Warning system)

:ref:`print_rich() <class_@GlobalScope_method_print_rich>`를 사용하면 서식 있는 텍스트를 편집기 출력 패널 및 표준 출력(사용자가 터미널에서 프로젝트를 실행할 때 표시됨)에 인쇄할 수 있습니다. 이는 BBCode를 터미널이 이해하는 `ANSI 이스케이프 코드 <https://en.wikipedia.org/wiki/ANSI_escape_code>`__로 변환하여 작동합니다.

편집기 출력에서 모든 BBCode 태그는 평소와 같이 인식됩니다. 터미널 출력에서는 위의 연결된 print_rich() 메서드 설명에 문서화된 대로 BBCode 태그의 하위 집합만 작동합니다. 터미널에서는 사용자의 테마에 따라 색상이 다르게 보이지만, 편집기의 색상은 프로젝트에서와 동일한 색상을 사용합니다.

참고

ANSI 이스케이프 코드 지원은 터미널 에뮬레이터에 따라 다릅니다. 터미널 출력에 표시되는 정확한 색상은 사용자가 선택한 터미널 테마에 따라 달라집니다.