참고: 키보드 단축키 & 제스처
이 장에서는 StitchKit 에디터에 실제로 정의된 키보드 단축키와 터치(태블릿) 제스처를 정리합니다. 단축키가 작동하려면 에디터 캔버스(canvas)에 포커스가 있어야 합니다. 캔버스를 한 번 클릭한 다음 키를 누르세요. 텍스트 상자나 입력란(예: "Lettering" 텍스트 입력)에 글자를 입력하는 동안에는 한 글자 단축키가 의도적으로 비활성화됩니다. 즉 "s"를 입력해도 3D 미리보기가 켜지지 않습니다.
팁 — 앱 안에는 언제든 최신 단축키 카드가 준비되어 있습니다. 캔버스를 클릭한 뒤 ? 키를 누르거나 오른쪽 아래의 도움말(?) 버튼을 누르세요. 그러면 "Shortcuts" 카드가 열립니다.
Windows Ctrl / macOS Cmd 차이
수정자(modifier) 키가 포함된 모든 단축키에서 Windows는 Ctrl, macOS는 **Cmd (⌘)**를 사용합니다. 두 키는 코드 내부에서 동일하게 처리됩니다. "Shift"는 두 플랫폼에서 동일합니다(macOS에서는 ⇧). 아래 표는 가장 자주 쓰이는 동작을 두 플랫폼별로 보여줍니다.
| 동작 | Windows | macOS |
|---|---|---|
| 명령 팔레트 / AI ("StitchPilot") | Ctrl+K | ⌘K |
| 실행 취소 (Undo) | Ctrl+Z | ⌘Z |
| 다시 실행 (Redo) | Ctrl+Shift+Z | ⌘⇧Z |
| 저장 (빠른 저장) | Ctrl+S | ⌘S |
| 다른 이름으로 저장 ("Save As") | Ctrl+Shift+S | ⌘⇧S |
| 자유 드로잉 ("Pencil") | Ctrl+P | ⌘P |
| 직사각형 그리기 | Ctrl+R | ⌘R |
| 타원 그리기 | Ctrl+E | ⌘E |
| 텍스트 / "Lettering" 패널 | Ctrl+T | ⌘T |
| "Monogram" 패널 | Ctrl+M | ⌘M |
| 시침질 상자 ("Basting") | Ctrl+B | ⌘B |
| 기본값 ("Defaults") | Ctrl+, | ⌘, |
| Basic ↔ Advanced 모드 | Ctrl+Shift+A | ⌘⇧A |
| 단축키 카드 ("Shortcuts") | Ctrl+/ | ⌘/ |
Windows — 수정자 키가 들어가는 모든 단축키에서는 Ctrl 키를 사용하세요. 예를 들어 실행 취소는 Ctrl+Z, 명령 팔레트를 여는 것은 Ctrl+K입니다.
macOS — 동일한 단축키에서 **Cmd (⌘)**를 사용하세요. macOS 자체 단축키와 충돌하는 일부 키(예: ⌘H = 앱 숨기기)는 에디터가 의도적으로 운영체제에 그대로 맡깁니다.
도구 선택 (수정자 없는 키)
아래 키들은 단독으로(수정자 없이) 작동합니다. 텍스트 입력란에 포커스가 있지 않을 때 적용됩니다.
| 키 | 동작 |
|---|---|
| V | 선택 도구 ("Select") |
| Space (스페이스바) | 패닝 / 손 도구 ("Hand") — 캔버스 이동 모드 |
| R | 선택 항목을 90° 회전 |
| Shift+X | 좌우 반전 ("Mirror X") |
| Shift+Y | 상하 반전 ("Mirror Y") |
| Delete / Backspace | 선택한 스티치 삭제 |
| Enter | 베지어 ("Digitize") 경로 완성 |
| Esc | 열린 패널 / 활성 도구 / 선택 → 가장 위 레이어부터 닫기 |
참고 — Space 키는 누르고 있는 동안이 아니라 한 번 누르면 손(패닝) 도구로 전환됩니다. 선택 도구로 돌아가려면 V를 누르세요. 또한 마우스 가운데 버튼(휠 버튼)은 어떤 도구가 선택되어 있든 언제나 패닝을 수행합니다.
보기 및 오버레이 키 (수정자 없음)
| 키 | 동작 |
|---|---|
| 0 | 맞춤 ("Fit to view") — 보기 초기화 |
| + / = | 확대 |
| - / _ | 축소 |
| G | 그리드 ("Grid") 표시/숨기기 |
| F | 밀도 오버레이 ("Density") 표시/숨기기 |
| H | 후프 프레임 ("Hoop frame") 표시/숨기기 |
| Shift+H | 숨겨진/제거 예정 스티치 미리보기 |
| P | 바늘 지점 ("Needle points") 표시/숨기기 |
| J | 점프 스티치 ("Jump stitches") 표시/숨기기 |
| N | 스티치 번호 ("Stitch numbers") 표시/숨기기 |
| X | 전체 화면 십자선 ("Crosshair") |
| S | 3D / 사실적 미리보기 ("3D Preview") |
참고 — 일부 키의 의미는 수정자에 따라 달라집니다. 단독으로 P는 바늘 지점을 켜지만, Ctrl/⌘+P는 자유 드로잉(pencil) 도구를 엽니다. 마찬가지로 단독 R은 회전이지만 Ctrl/⌘+R은 직사각형 도구를 열고, 단독 S는 3D 미리보기, Ctrl/⌘+S는 저장입니다. 파일과 관련된 일부 항목(예: 가져오기 / "Quick Convert")은 앱 내부 Shortcuts 카드에만 표시됩니다. 가장 최신 목록은 **?**로 그 카드를 열어 확인하세요.
태블릿 / 터치 제스처
StitchKit 캔버스는 터치와 펜(스타일러스) 입력을 지원합니다. 아래 제스처는 태블릿과 iPad에서 사용할 수 있습니다.
- 핀치(두 손가락으로 오므리기/벌리기) — 확대 / 축소. 확대/축소는 캔버스 중앙을 기준으로 이루어지며 %5–%800 범위로 제한됩니다.
- 두 손가락으로 드래그 — 캔버스 이동(패닝). 트랙패드에서 두 손가락 스크롤은 확대/축소로 동작할 수도 있습니다.
- 손 도구 ("Hand")로 한 손가락 드래그 — Space로 또는 도구 모음에서 손 도구를 선택한 뒤 한 손가락으로 드래그하여 패닝하세요.
- 펜 / 스타일러스로 그리기 — 드로잉 도구(Pencil, Rectangle, Ellipse, Digitize)가 활성화된 상태에서 펜으로 캔버스 위에 직접 그리세요. 빠르게 움직여도 획이 끊기지 않도록, 그리는 동안 캔버스가 포인터(pointer)를 붙잡아 둡니다.
- 길게 누르기(long-press) — 컨텍스트/객체 선택을 돕는 경우가 있으며, 정확한 동작은 활성 도구에 따라 달라집니다. 확실치 않다면 도구 모음의 선택 도구(V)를 사용하세요.
태블릿 — 가장 자주 쓰게 될 두 제스처는 핀치 = 확대/축소와 두 손가락 = 패닝입니다. 펜으로 정밀하게 그리기 전에 드로잉 도구를 선택했는지 반드시 확인하세요. 그렇지 않으면 손가락/펜 움직임이 선택이나 패닝으로 해석될 수 있습니다.
팁 — 그리는 도중 위치가 어긋난 것 같으면 먼저 0(맞춤)으로 보기를 초기화한 다음 다시 시도하세요. 캔버스를 초기화하면 좌표 매핑도 새로 갱신됩니다.