콘솔
콘솔은 문제를 진단하고 무언가를 시험해 보기 위한 엔진 자체의 창입니다. 엔진이 보고하는 내용(구성의 문제, 실패한 스크립트, 대체로 전환된 플러그 인)과 스크립트가 출력하는 내용을 보여 주며, 그 자리에서 스크립트를 작성하고 실행할 수 있는 편집기가 있습니다.
콘솔 열기
트레이 메뉴에서 콘솔 표시를 선택하거나(트레이 아이콘), 작업에서 UIShowConsole 기본 제공 함수를
실행합니다(예: 단축키에 연결). 메시지 수신 시(아래)로 요청하지 않는 한 콘솔이 자동으로 열리는 일은 없습니다.
구성이 암호로 보호되어 있으면, 암호가 아직 기억되어 있지 않은 한 콘솔이 열릴 때 암호를 묻습니다
(보안). 콘솔이 열려 있는 동안에는 기억한 암호가 만료되지 않습니다. UIShowConsole은 암호를
묻는 동안을 포함해 콘솔이 열릴 때까지 기다리며, 예를 들어 암호 입력을 취소해서 콘솔이 열리지 않으면 false를
반환합니다.
콘솔은 닫기 단추로 닫습니다. 닫으면 콘솔이 사용하던 메모리가 해제됩니다.
세 섹션
위쪽의 단추 ①로 세 섹션 사이를 전환하며, 각 섹션에는 자체 도구 모음이 있습니다.
| 섹션 | 표시 내용 | 도구 모음 |
|---|---|---|
| 시스템 | 엔진이 보고하는 내용: 마지막 로드 때의 구성에 대한 알림, 실패한 작업과 스크립트 및 그 이유, 그리지 못해 기본 제공 그리기로 대체된 플러그 인 등 | 복사, 지우기, 메시지 수신 시 |
| 사용자 | 모든 작업에서 스크립트가 UtilityPrint로 출력하는 모든 내용 | 복사, 지우기, 메시지 수신 시 |
| 스크립트 | 출력 창 위의 스크립트 편집기 | 실행, 모두 중지, 콘솔 숨기기, 스크립트 도움말, 복사, 붙여넣기, 지우기 |
복사는 선택한 텍스트를 복사하며, 선택한 것이 없으면 섹션 전체를 복사합니다. 지우기는 섹션을 비웁니다.
스크립트 섹션이 표시되어 있는 동안에는 새 시스템 줄과 사용자 줄도 그 출력 창에 나타나므로, 섹션을 전환하지 않고 실행 중인 스크립트를 지켜볼 수 있습니다.
콘솔이 닫혀 있는 동안
콘솔이 닫혀 있는 동안 들어온 줄은 사라지지 않습니다. 임시 파일에 보관되었다가 다음에 콘솔을 열 때 표시됩니다. Input.Observer가 종료되면 삭제되지만, 엔진 종료 중 이벤트가 출력한 내용은 다음 세션의 콘솔에 표시됩니다.
시스템 및 사용자 도구 모음의 메시지 수신 시 ①은 콘솔이 닫혀 있는 동안 새 줄이 어떻게 처리될지 선택합니다.
| 선택 | 일어나는 일 |
|---|---|
| 아무 작업 안 함 | 콘솔을 열 때까지 줄이 대기합니다. 기본값입니다. |
| UIShowMessageBox 표시 | 줄이 메시지 상자로도 나타납니다. |
| 콘솔 열기 | 콘솔이 그 섹션으로 열립니다. |
콘솔이 열려 있으면 새 줄은 그냥 추가되며, 상자를 띄우거나 섹션을 전환하지 않습니다. 같은 선택이 콘솔 페이지에 새 시스템 메시지와 새 사용자 메시지로 있습니다.
스크립트 실행
- 콘솔의 스크립트 섹션을 엽니다.
- 편집기에 스크립트를 입력하거나 붙여넣습니다. Input.Observer의 스크립트 언어를 사용합니다 (스크립트 언어).
- 실행 ②을 선택하거나 F5를 누릅니다. 선택한 텍스트가 있으면 선택한 부분만, 그렇지 않으면 편집기 전체가 실행됩니다.
- 출력과 오류는 편집기 아래의 출력 창에 나타납니다. 콘솔 숨기기는 그 창을 숨기거나 표시합니다.
- 여기서 실행한 스크립트는 작업처럼 동작합니다. 모든 기본 제공 함수를 사용할 수 있으며, 끝나거나 중지될 때까지 실행됩니다. 모두 중지는 이 스크립트뿐 아니라 실행 중인 모든 스크립트와 작업을 중지합니다.
- 안전 모드에서 스크립트가 실행되는 유일한 곳입니다. 다른 것이 실행되지 않는 동안 문제를 살펴보고 고칠 수 있습니다(문제 해결).
- 편집기는 입력하는 동안 기본 제공 함수 이름을 자동 완성합니다. Ctrl+Space를 누르면 전체 목록이 표시되며, 영역 이름과 마침표를 입력하면 그 영역의 기본 제공 함수가 나열됩니다. 기본 제공 함수를 고르면 현재 매개 변수가 강조 표시된 매개 변수 도움말이 나타납니다. 마우스 오른쪽 단추 메뉴에는 선택한 줄에 대한 주석 처리와 주석 처리 제거가 있습니다.
- 편집기의 텍스트는
console.toml에 세션 간에 보관됩니다.
스크립트 도움말 ③은 Input.Observer가 사용하는 언어로(그 언어의 도움말이 없으면 영어로) 도움말 창에서 스크립트 언어 참조를 엽니다(도움말 창).
콘솔 페이지
고급 모드. 콘솔 페이지는 간단히 모드에서 숨겨집니다. 설정은 계속 적용됩니다.
구성 창의 콘솔 페이지에는 콘솔 설정이 있습니다. 적용이나 저장 후 닫기를 선택할 때 반영됩니다.
| 설정 | 하는 일 | 기본값 | 범위 |
|---|---|---|---|
| 콘솔 줄 수 제한 | 섹션의 줄 수가 이만큼 되면 새 줄이 들어올 때 가장 오래된 줄이 삭제됩니다. 0이면 모두 보관합니다. 다음 줄부터 적용됩니다. | 5000줄 | 0~1000000 |
| 콘솔을 닫을 때 메모리 해제 | 콘솔을 닫는 즉시 콘솔의 메모리를 Windows에 돌려줍니다. 그 직후의 마우스나 키보드 이벤트가 아주 약간 느려질 수 있습니다. | 켬 | 켬 또는 끔 |
| 새 시스템 메시지 | 콘솔이 닫혀 있는 동안 새 시스템 줄이 하는 일: 아무 작업 안 함, 메시지 상자, 콘솔 열기(위의 메시지 수신 시와 같음) | 아무 작업 안 함 | — |
| 새 사용자 메시지 | 사용자 줄에 대해 같은 설정 | 아무 작업 안 함 | — |
| 엔진 창 글꼴 | 콘솔의 레이블과 단추, 엔진의 대화 상자(암호, 라이선스)에 쓰는 글꼴과 크기 | Segoe UI, 12pt | 6~72pt |
| 엔진 편집기 글꼴 | 콘솔의 섹션과 스크립트 편집기에 쓰는 글꼴과 크기 | Consolas, 13pt | 6~72pt |
열려 있는 콘솔은 닫았다가 다시 열 때까지 글꼴을 유지합니다.