LunaTranslator/docs/ko/fastkeys.md

단축키

::: tip 단축키를 사용하려면 먼저 단축키 사용 여부를 활성화한 후, 사용할 단축키를 활성화하고 해당 키를 설정해야 합니다. :::

일반

1. 수동 실행

   현재 텍스트 입력 소스에서 입력을 한 번 읽어 번역을 실행합니다. 예를 들어 현재 OCR 모드인 경우, OCR을 다시 한 번 실행합니다.

2. 자동 모드

   현재 텍스트 입력 소스에서 자동으로 텍스트를 읽는 것을 일시 중지/재개합니다. 예를 들어 현재 HOOK 모드인 경우 게임 텍스트 읽기를 일시 중지하고, OCR 모드인 경우 이미지 자동 인식을 일시 중지하며, 클립보드 모드인 경우 클립보드 자동 읽기를 일시 중지합니다.

3. 설정 열기

   생략

4. 원문 표시/숨기기

   원문 표시 여부를 전환하며 즉시 적용됩니다.

5. 번역 표시/숨기기

   번역 사용 여부를 전환하는 것으로, 번역의 총 스위치 역할을 하며, 비활성화 시 어떠한 번역도 수행되지 않습니다.

   이미 번역이 수행된 경우 비활성화 시 번역 결과가 숨겨지며, 다시 활성화하면 해당 번역 결과가 재표시됩니다.

   번역이 수행되지 않은 상태에서 숨김에서 표시로 전환하면 현재 문장의 번역이 트리거됩니다.

6. 기록 텍스트 표시/숨기기

   이력 텍스트 창을 열거나 닫습니다.

7. 마우스 윈도우 투과

   마우스 클릭 스루 창 상태를 전환합니다. 이 기능은 마우스 클릭 스루 창 도구 버튼과 함께 사용해야 정상적으로 작동합니다.

8. 툴바 잠금

   툴바가 고정되지 않은 상태에서는 마우스가 벗어날 때 툴바가 자동으로 숨겨집니다. 활성화 시 툴바는 항상 표시됩니다.

   툴바가 고정되지 않은 상태에서 '마우스 창 투과'가 활성화된 경우, 마우스 창 투과 버튼 및 그 좌우 한 버튼 영역으로 마우스가 이동할 때만 툴바가 표시됩니다. 그렇지 않으면 번역 창에 마우스가 진입하면 툴바가 표시됩니다.

   현재 창 효과(Aero/Acrylic)를 사용 중이고 툴바를 고정하지 않은 경우, 툴바는 텍스트 영역의 z축 위에 위치하게 됩니다. 이는 Windows의 특성상 창 효과 사용 시 툴바를 단순히 숨기기만 하고 창 높이를 줄이지 않으면 숨겨진 툴바가 아크릴/Aero 배경으로 렌더링되어 해당 영역에 빈 공간이 생기기 때문입니다.

9. 단어 선택 번역

   현재 마우스로 선택한 텍스트를 번역합니다.

   UIAutomation을 우선적으로 사용하여 텍스트를 추출합니다. 현재 창의 포커스 컨트롤이 UIAutomationTextPattern을 지원하지 않아 추출에 실패할 경우 클립보드를 읽어옵니다.

10. 번역 창 표시/숨기기

    생략

11. 종료

    생략

12. 연속 클릭 도구

    생략

13. 번역 상태 재설정

    번역 상태를 재설정하며, 주로 증가하는 대규모 모델 번역需求에 대응하여 저장된 컨텍스트 및 기타 정보를 삭제할 수 있습니다.

14. 구성 즉시 저장

    현재 사용자 구성을 종료할 때까지 기다리지 않고 즉시 저장합니다.

HOOK

Warning

HOOK 모드에서만 사용 가능

1. 게임 선택

   HOOK할 게임 프로세스를 선택하기 위한 프로세스 선택 창을 표시합니다.

2. 텍스트 선택

   게임 텍스트 선택 창을 팝업하여 후킹된 텍스트 중 번역할 항목을 선택합니다.

   다만, 텍스트 선택 창은 프로세스 선택 후 자동으로 팝업되며, 실제로는 선택한 텍스트를 변경하거나 일부 설정을 수정하는 데 사용됩니다.

OCR

1. OCR 범위 선택

   OCR 모드에서만 사용 가능

   OCR 모드에서 OCR 영역을 선택하거나 변경하거나, OCR 설정->기타->다중 영역 모드가 활성화된 경우 새로운 OCR 영역을 추가합니다.

2. 범위 프레임 표시/숨기기

   OCR 모드에서만 사용 가능

   OCR 범위를 선택하지 않은 상태에서 해당 단축키를 사용하면 OCR 범위가 표시되며, 자동으로 마지막으로 선택한 OCR 범위가 설정됩니다.

3. OCR 범위 지우기

   OCR 모드에서만 사용 가능

   선택된 모든 범위를 초기화합니다.

4. OCR 실행

   클립보드 읽기와 유사하게 현재 기본 텍스트 입력 소스와 관계없이 먼저 OCR 범위를 선택한 후 OCR을 실행하고 번역 프로세스를 진행합니다.

   일반적으로 후크 모드에서 선택지가 나타났을 때 일시적으로 OCR을 사용하여 선택지를 번역하거나, OCR 모드에서 가끔 나타나는 새로운 위치를 일시적으로 인식할 때 사용합니다.

5. OCR 다시 실행

   OCR 실행을 한 번 사용한 후 이 단축키를 사용하면 인식 영역을 다시 선택하지 않고도 원래 위치에서 OCR을 다시 실행할 수 있습니다.

6. 다중 영역 모드 이전 영역으로 전환

   OCR 모드에서만 사용 가능

   다중 영역 모드가 활성화된 후, 이 단축키를 사용하여 포커스된 영역을 이전 영역으로 전환하고 즉시 OCR을 다시 수행합니다.

7. 다중 영역 모드 다음 영역으로 전환

   OCR 모드에서만 사용 가능

   다중 영역 모드가 활성화된 후, 이 단축키를 사용하여 포커스된 영역을 다음 영역으로 전환하고 즉시 OCR을 다시 수행합니다.

8. 다중 영역 모드 마우스 인접 영역으로 전환

   OCR 모드에서만 사용 가능

   다중 영역 모드가 활성화된 후, 이 단축키를 사용하여 포커스된 영역을 마우스 커서 근처의 영역으로 전환하고 즉시 OCR을 다시 수행합니다.

9. 다중 영역 모드 지역 초점 해제

   OCR 모드에서만 사용 가능

   다중 영역 모드가 활성화된 후, 이 단축키를 사용하여 영역 포커스를 취소할 수 있습니다.

클립보드

1. 클립보드 읽기

   이것의 실제 의미는 현재 기본 텍스트 입력 소스가 무엇이든 상관없이 클립보드에서 텍스트를 한 번 읽어 들여 이후 번역/TTS/… 프로세스에 전달하는 것입니다.

2. 클립보드에 복사

   현재 추출된 텍스트를 클립보드에 한 번 복사합니다. 자동으로 클립보드에 추출되길 원한다면 텍스트 입력->클립보드->자동 출력->텍스트 자동 출력을 활성화해야 합니다.

3. 클립보드에 복사 번역

   원문이 아닌 번역본을 클립보드에 복사합니다.

TTS

1. 자동 음성 읽기

   자동 읽기 기능을 전환합니다.

2. 음성 읽기

   현재 텍스트를 음성 합성합니다.

   이 읽기 기능은 건너뛰기를 무시합니다(음성 지정에서 현재 텍스트 대상을 건너뛰기로 설정한 경우, 단축키를 사용해 읽을 때 건너뛰기를 무시하고 강제로 읽기를 수행합니다).

3. 음성 읽기 중단

   읽기를 중단합니다.

게임

1. 게임 관리

   생략

2. 창 바인딩 (클릭하여 취소)

   게임 창을 바인딩한 후에만 창 크기 조정, 창 스크린샷, 게임 음소거, 게임 창 따라가기->게임이 포커스를 잃을 때 항상 위 유지 해제 및 게임 창 이동 시 동기화 이동, 그리고 게임 시간 기록 등이 사용 가능해집니다. HOOK/OCR/클립보드 모드와 관계없이 이 단축키는 사용 가능합니다.

   HOOK 모드에서는 연결된 게임에 따라 자동으로 게임 창을 바인딩합니다. 하지만 해당 단축키를 사용해 다른 창을 다시 선택할 수도 있습니다.

   OCR 모드에서는 창 바인딩 후, 추가로 게임 창이 이동할 때 OCR 영역과 범위 박스도 동기화되어 자동으로 이동합니다. OCR/클립보드 모드에서도 창 바인딩 후 HOOK 모드와 마찬가지로 현재 게임과 게임 설정을 연동할 수 있어, 해당 게임 전용 최적화 번역 사전 등을 사용할 수 있습니다.

3. 창 스크린샷

   게임 창을 바인딩한 후, 바인딩된 창의 스크린샷을 찍을 수 있습니다 (기본적으로 GDI와 Winrt 두 장이 찍히며, 둘 다 실패할 가능성이 있습니다). 현재 Magpie로 스케일링 중인 경우, 확대된 창도 캡처됩니다.

4. 게임 음소거

   게임 창을 바인딩한 후, 한 번의 클릭으로 게임을 음소거할 수 있어 시스템 볼륨 믹서에서 게임 음소거를 하는 번거로움을 덜 수 있습니다.

5. 게임 일시 정지

   게임 창을 바인딩한 후, 한 번의 클릭으로 게임 프로세스를 일시 정지하거나 재개할 수 있습니다.

6. Magpie 확대/축소

   게임 창을 바인딩한 후, 내장된 Magpie를 사용하여 게임 창을 전체 화면으로 스케일링할 수 있습니다.

7. Magpie 창 모드 확대/축소

   게임 창을 바인딩한 후, 내장된 Magpie를 사용하여 게임 창을 창 모드로 스케일링할 수 있습니다.

단어 검색

1. 단어 선택 검색

   현재 마우스로 선택한 텍스트를 검색합니다.

   UIAutomation을 우선적으로 사용하여 단어를 추출합니다. 현재 창의 포커스 컨트롤이 UIAutomationTextPattern을 지원하지 않아 단어 추출에 실패할 경우, 클립보드를 읽어옵니다.

2. 단어 선택 검색 새 창에서

   현재 마우스로 선택한 텍스트를 새 검색 창에서 검색하여 진행 중인 검색을 덮어쓰지 않도록 합니다.

   UIAutomation을 우선적으로 사용하여 단어를 추출합니다. 현재 창의 포커스 컨트롤이 UIAutomationTextPattern을 지원하지 않아 단어 추출에 실패할 경우, 클립보드를 읽어옵니다.

3. OCR 단어 검색

   OCR 범위를 선택하여 OCR을 수행한 후 검색합니다.

4. Anki 녹음

   검색 창의 Anki 추가 인터페이스에서 녹음 기능의 단축키

5. Anki 녹음 예문

   검색 창의 Anki 추가 인터페이스에서 녹음 기능의 단축키, 이 단축키로 녹음한 오디오는 예문 필드에 설정됩니다.

6. Anki 추가

   단어를 Anki에 추가합니다.

7. 음성 읽기 단어

   현재 검색 창의 단어를 읽어줍니다.

사용자 정의

OnHotKeyClicked 함수를 직접 구현하면 더 많은 임의의 단축키를 추가할 수 있으며, 단축키가 트리거될 때 호출됩니다.