LunaTranslator/docs/ko/fastkeys.md

# 단축키

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

## 일반

1. #### 수동 실행 {#anchor-_1}
    현재 텍스트 입력 소스에서 입력을 한 번 읽어 번역을 실행합니다.
    예를 들어 현재 OCR 모드인 경우, OCR을 다시 한 번 실행합니다.

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

1. #### 설정 열기 {#anchor-_3}
    생략

1. #### 원문 표시/숨기기 {#anchor-_5}
    원문 표시 여부를 전환하며 즉시 적용됩니다.

1. #### 번역 표시/숨기기 {#anchor-_51}
    번역 사용 여부를 전환하는 것으로, 번역의 총 스위치 역할을 하며, 비활성화 시 어떠한 번역도 수행되지 않습니다.

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

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

1. #### 기록 텍스트 표시/숨기기 {#anchor-_6}
    이력 텍스트 창을 열거나 닫습니다.

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

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

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

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

1. #### 단어 선택 번역 {#anchor-38}
    현재 마우스로 선택한 텍스트를 번역합니다.

    UIAutomation을 우선적으로 사용하여 텍스트를 추출합니다. 현재 창의 포커스 컨트롤이 UIAutomationTextPattern을 지원하지 않아 추출에 실패할 경우 클립보드를 읽어옵니다.
1. #### 번역 창 표시/숨기기 {#anchor-_16}
    생략

1. #### 종료 {#anchor-_17}
    생략

1. #### 연속 클릭 도구 {#anchor-44}
    생략
    
1. #### 번역 상태 재설정 {#anchor-45}
    번역 상태를 재설정하며, 주로 증가하는 대규모 모델 번역需求에 대응하여 저장된 컨텍스트 및 기타 정보를 삭제할 수 있습니다.

1. #### 구성 즉시 저장 {#anchor-50}
    현재 사용자 구성을 종료할 때까지 기다리지 않고 즉시 저장합니다.

## HOOK

>[!WARNING]
>HOOK 모드에서만 사용 가능

1. #### 게임 선택 {#anchor-_11}
    HOOK할 게임 프로세스를 선택하기 위한 프로세스 선택 창을 표시합니다.
1. #### 텍스트 선택 {#anchor-_12}
    게임 텍스트 선택 창을 팝업하여 후킹된 텍스트 중 번역할 항목을 선택합니다.

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

## OCR


1. #### OCR 범위 선택 {#anchor-_13}
    **OCR 모드에서만 사용 가능**

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

1. #### 범위 프레임 표시/숨기기 {#anchor-_14}
    **OCR 모드에서만 사용 가능**

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

1. #### OCR 범위 지우기 {#anchor-_14_1}
    **OCR 모드에서만 사용 가능**

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

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

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


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

1. #### 다중 영역 모드 이전 영역으로 전환 {#anchor-46}
    **OCR 모드에서만 사용 가능**

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

1. #### 다중 영역 모드 다음 영역으로 전환 {#anchor-47}
    **OCR 모드에서만 사용 가능**

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

1. #### 다중 영역 모드 마우스 인접 영역으로 전환 {#anchor-48}
    **OCR 모드에서만 사용 가능**

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

1. #### 다중 영역 모드 지역 초점 해제 {#anchor-49}
    **OCR 모드에서만 사용 가능**

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

## 클립보드

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

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

1. #### 클립보드에 복사 번역 {#anchor-_28}
    원문이 아닌 번역본을 클립보드에 복사합니다.

## TTS

1. #### 자동 음성 읽기 {#anchor-_32}
    자동 읽기 기능을 전환합니다.

1. #### 음성 읽기 {#anchor-_7}
    현재 텍스트를 음성 합성합니다.

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

1. #### 음성 읽기 중단 {#anchor-_7_1}
    읽기를 중단합니다.

## 게임

1. #### 게임 관리 {#anchor-_10}
    생략

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

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

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

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

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

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

1. #### Magpie 확대/축소 {#anchor-41}
    게임 창을 바인딩한 후, 내장된 Magpie를 사용하여 게임 창을 전체 화면으로 스케일링할 수 있습니다.

1. #### Magpie 창 모드 확대/축소 {#anchor-42}
    게임 창을 바인딩한 후, 내장된 Magpie를 사용하여 게임 창을 창 모드로 스케일링할 수 있습니다.

## 단어 검색

1. #### 단어 선택 검색 {#anchor-37}
    현재 마우스로 선택한 텍스트를 검색합니다.

    UIAutomation을 우선적으로 사용하여 단어를 추출합니다. 현재 창의 포커스 컨트롤이 UIAutomationTextPattern을 지원하지 않아 단어 추출에 실패할 경우, 클립보드를 읽어옵니다.
1. #### 단어 선택 검색 새 창에서 {#anchor-40}
    현재 마우스로 선택한 텍스트를 새 검색 창에서 검색하여 진행 중인 검색을 덮어쓰지 않도록 합니다.

    UIAutomation을 우선적으로 사용하여 단어를 추출합니다. 현재 창의 포커스 컨트롤이 UIAutomationTextPattern을 지원하지 않아 단어 추출에 실패할 경우, 클립보드를 읽어옵니다.
1. #### OCR 단어 검색 {#anchor-39}
    OCR 범위를 선택하여 OCR을 수행한 후 검색합니다.

1. #### Anki 녹음 {#anchor-_29}
    검색 창의 Anki 추가 인터페이스에서 녹음 기능의 단축키

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

1. #### Anki 추가 {#anchor-_35}
    단어를 Anki에 추가합니다.

1. #### 음성 읽기 단어 {#anchor-_33}
    현재 검색 창의 단어를 읽어줍니다.

## 사용자 정의

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