Document screenshot editor and clipboard history with screenshots for v0.6.0

2026-10-29 00:03:05 +02:00
parent c795080c2a
commit 64daa0eabd
9 changed files with 129 additions and 2 deletions
@@ -0,0 +1,49 @@
+# Історія буфера обміну
+
+KSwitcher зберігає скопійовані **тексти, зображення та списки файлів**. Історія допомагає повернутися до попереднього фрагмента, вставити його без форматування, закріпити корисний запис або розпізнати текст зі скріншота.
+
+## Увімкнення та відкриття
+
+У **Settings** увімкніть **Record clipboard history**. Відкривайте історію з меню трея або хоткеєм **Clipboard history**. Стандартна комбінація — **Ctrl+Shift+V**; можна призначити **Win+V**. Поки KSwitcher працює, призначений Win+V відкриває його історію замість системної.
+
+## Пошук і вставлення
+
+![Пошук демонстраційних записів в історії буфера](https://gitea.hrynco.com/hrynco/hrynco-kswitcher/wiki/raw/images/clipboard-history.jpg)
+
+Введіть частину тексту в **Search clipboard history**. Результати показують попередній перегляд, порядковий номер і програму-джерело. Для зображень завантажуються мініатюри. Текст може показувати форматування HTML/RTF; відтворення залежить від вмісту вихідної програми.
+
+1. Перед відкриттям історії поставте курсор у потрібне поле цільової програми.
+2. Відкрийте історію, знайдіть і виберіть запис.
+3. Натисніть **Paste / Enter** для вставлення або **Plain text / Shift+Enter** для звичайного тексту.
+
+Від **v0.6.0** список і поле пошуку розтягуються разом із вікном, а кнопки залишаються внизу. Якщо вікно дуже мале, елементи доступні через прокручування.
+
+## Команди
+
+| Комбінація | Дія |
+| --- | --- |
+| Enter | Вставити вибраний запис у попереднє вікно |
+| Shift+Enter | Вставити звичайний текст без форматування |
+| Ctrl+1 … Ctrl+9 | Швидко вставити запис зі списку |
+| Ctrl+P | Закріпити / відкріпити |
+| Delete | Видалити вибраний запис |
+| Ctrl+O | Відкрити повний перегляд |
+| Esc | Закрити історію |
+
+Кнопки **Pin / unpin**, **Delete** та **Open item** дублюють основні команди. Для додаткових дій клацніть запис правою кнопкою миші.
+
+![Контекстне меню історії: вставлення, закріплення, повний перегляд і OCR](https://gitea.hrynco.com/hrynco/hrynco-kswitcher/wiki/raw/images/clipboard-menu.jpg)
+
+## Зображення, OCR та скріншоттер
+
+Скріншоти KSwitcher одразу потрапляють до буфера й записуються в історію, якщо її запис увімкнений. Після редагування натисніть **Ctrl+C**, щоб скопіювати результат із позначками. Повторні однакові зображення дедуплікуються.
+
+Для розпізнавання виберіть зображення й команду **Copy text from image (Windows OCR)** у контекстному меню. Потрібні встановлені мовні компоненти OCR Windows. Докладніше про захоплення й позначки: [Скріншоти та редактор](Screenshots).
+
+## Ліміти та приватність
+
+У **Settings → History limits** задаються максимальна кількість записів, загальний обсяг у MiB та розмір одного запису. **Clear history…** очищає історію. Поле **Exclude applications** виключає програми за іменами процесів; у меню трея також є тимчасове призупинення запису.
+
+Історія й індекс зашифровані Windows DPAPI для поточного користувача. Повні зображення завантажуються за потреби, а кеш мініатюр обмежений. Для відкриття папки даних використовуйте **Open data folder**. Перенесення цієї зашифрованої історії в інший Windows-акаунт не підтримується.
+
+На скріншотах — демонстраційні записи, додані для документації.
@@ -2,6 +2,12 @@

 ## Як оновити програму?

+Використовуйте перевірку оновлень у меню трея KSwitcher. Для **v0.4.1 і старіших** шлях складається з двох оновлень: спочатку сумісна **v0.4.2**, потім повторна перевірка й перехід на поточний реліз. Із **v0.5.0** програма використовує маніфест файлів із SHA-256 і підтримує додаткові EXE в пакеті. Дані користувача та власні словники зберігаються.
+
+Перед заміною файлів закрийте редактори скріншотів. У пакеті є `KSwitcher.exe`, `KSwitcher.Config.exe` і `KSwitcher.Screenshot.exe`; залишайте їх разом.
+
+Ручне оновлення, якщо потрібне:
+
 1. Завантажте ZIP із [Releases](https://gitea.hrynco.com/hrynco/hrynco-kswitcher/releases).
 2. Закрийте KSwitcher через **Exit** у меню трея.
 3. Зробіть резервну копію папки `data` та власних змін у `dictionaries`.
@@ -1,6 +1,6 @@
 # KSwitcher — розкладка клавіатури та буфер обміну

-KSwitcher — невеликий нативний застосунок для **Windows 10/11 x64**, написаний на C++/Win32. Він виправляє текст, набраний у неправильній розкладці, зберігає історію буфера обміну та розгортає текстові шаблони. Працює з іконки в системному треї; встановлення .NET чи додаткового runtime не потрібне.
+KSwitcher — невеликий нативний застосунок для **Windows 10/11 x64**, написаний на C++/Win32. Він виправляє текст, набраний у неправильній розкладці, зберігає історію буфера обміну розгортає текстові шаблони, захоплює скріншоти й дозволяє додавати позначки. Працює з іконки в системному треї; встановлення .NET чи додаткового runtime не потрібне.

 **[Завантажити останню версію (ZIP)](https://gitea.hrynco.com/hrynco/hrynco-kswitcher/releases/download/latest/KSwitcher-win-x64.zip)** · **[Усі релізи](https://gitea.hrynco.com/hrynco/hrynco-kswitcher/releases)**

@@ -19,6 +19,7 @@ KSwitcher — нативне C++/Win32-переписування Windows-фун
 | OCR | Розпізнавання тексту із зображень через встановлені мовні компоненти Windows |
 | Snippets | Текстові шаблони, багаторядковий текст і позиція курсора |
 | Хоткеї | Запис комбінації натисканням клавіш, зокрема заміна звичайних системних комбінацій |
+| Скріншоти | Win+Shift+S → буфер → сповіщення з мініатюрою → редактор із позначками |
 | Автозапуск | Звичайний або з правами адміністратора |

 ## Швидкий старт
@@ -37,10 +38,17 @@ KSwitcher — нативне C++/Win32-переписування Windows-фун

 Скріншот показує справжній інтерфейс із демонстраційними налаштуваннями. Перелік розкладок залежить від Windows на вашому комп’ютері.

+## Скріншоти та буфер обміну
+
+- **[Скріншоти та редактор позначок](Screenshots)** — стрілки, номери, підсвітка, текст, фігури та гарячі клавіші.
+- **[Історія буфера обміну](Clipboard)** — пошук, мініатюри, вставлення, закріплення та OCR.
+
+![Редактор скріншотів](https://gitea.hrynco.com/hrynco/hrynco-kswitcher/wiki/raw/images/screenshot-editor.jpg)
+
 ## Докладні інструкції

 - [Автовиправлення та словники](https://gitea.hrynco.com/hrynco/hrynco-kswitcher/wiki/Auto-correction)
 - [Гарячі клавіші, буфер обміну та шаблони](https://gitea.hrynco.com/hrynco/hrynco-kswitcher/wiki/Usage)
 - [Оновлення, дані та поширені запитання](https://gitea.hrynco.com/hrynco/hrynco-kswitcher/wiki/FAQ)

-Документація для **v0.1.0**. Інтерфейс застосунку англійською; назви кнопок у посібнику наведені як у програмі.
+Сторінки скріншоттера, історії буфера та оновлення актуалізовано для **v0.6.0**. Інтерфейс застосунку англійською; назви кнопок у посібнику наведені як у програмі.
@@ -0,0 +1,59 @@
+# Скріншоти та редактор позначок
+
+Від **v0.6.0** KSwitcher працює за принципом «захопив — одразу вставляй»: знімок потрапляє до буфера обміну, Windows показує сповіщення з мініатюрою, а редактор відкривається лише за кліком по сповіщенню.
+
+## Швидкий старт
+
+1. Натисніть **Win+Shift+S** або виберіть **Capture screen region…** у меню трея. Хоткей можна змінити в Settings → Screen capture.
+2. Протягніть прямокутник. Екран затемнений, вибрана ділянка залишається світлою. **Esc** скасовує захоплення.
+3. Знімок уже в буфері: вставляйте його через **Ctrl+V** у потрібну програму.
+4. Для позначок клацніть сповіщення **Screenshot copied → Click to edit and annotate**.
+5. У редакторі натисніть **Ctrl+C** або кнопку копіювання. Вікно залишається відкритим, можна редагувати далі.
+
+Якщо сповіщення Windows вимкнені або не можуть бути надіслані, редактор відкриється відразу після копіювання.
+
+## Інструменти
+
+![Редактор KSwitcher: стрілка з підписом і прямокутна рамка на демонстраційних даних](https://gitea.hrynco.com/hrynco/hrynco-kswitcher/wiki/raw/images/screenshot-editor.jpg)
+
+Це справжній редактор із нейтральним демонстраційним зображенням. Панель унизу показує підказки для поточної дії.
+
+| Інструмент | Клавіша | Можливості |
+| --- | --- | --- |
+| Нумерована мітка | N | Переміщення, зміна діаметра; нові номери спочатку заповнюють пропуски |
+| Стрілка | A | Рухомі кінці, товщина, підпис, прив’язка кінців до номерків |
+| Пряма лінія | L | Суцільна, пунктирна, штрихова або штрихпунктирна лінія |
+| Прямокутник | R | Переміщення та зміна розміру |
+| Коло / еліпс | O / E | Контурні фігури |
+| Олівець | F | Довільна лінія; активний за замовчуванням |
+| Підсвітка | H | Напівпрозорий штрих поверх зображення |
+| Текст | T | Введення прямо на зображенні, шрифт, розмір і поворот |
+
+Палітра змінює колір вибраного об’єкта й наступних об’єктів. **Line style** задає тип лінії, а **Ends** — стрілку на початку, в кінці, з обох боків або без наконечників.
+
+## Редагування об’єктів
+
+- Перетягуйте об’єкт для переміщення, ручки — для зміни розміру. Курсор підказує доступну дію.
+- Колесо миші змінює розмір об’єкта під курсором: товщину лінії, діаметр мітки чи розмір тексту. Товщину також можна змінювати окремою ручкою біля лінії.
+- **Клавіші-стрілки** зміщують вибраний об’єкт на один піксель зображення.
+- **Ctrl+D** клонує об’єкт, **Delete** видаляє його.
+- **Ctrl+Z** — Undo; **Ctrl+Y** або **Ctrl+Shift+Z** — Redo.
+- **Ctrl+перетягування** дозволяє малювати поверх наявних об’єктів.
+
+### Текст і підписи
+
+Подвійний клік або **F2** редагує текст чи підпис вибраної лінії. **Enter** додає рядок, **Ctrl+Enter** завершує введення, **Esc** скасовує поточне редагування тексту. Кнопка **Font and size** відкриває діалог шрифту.
+
+Текст повертається за круглу ручку; із **Shift** — кроком **15°**. Підпис стрілки автоматично слідує за її кутом, доки ви не повернете підпис вручну. Переміщення підпису не вимикає автоматичний кут.
+
+### Кілька знімків
+
+Можна робити нові скріншоти, поки редактор відкритий. Вікна мають окремі індекси **Screenshot #1, #2…** і доступні через **Alt+Tab**. **Esc не закриває редактор**. Якщо є зміни, які ще не скопійовані, закриття потребує підтвердження.
+
+## Процеси та тимчасові файли
+
+Захоплення й редактор працюють в окремому **KSwitcher.Screenshot.exe**, який запускається за потреби й завершується після закриття останнього свого вікна. Основний KSwitcher залишається в треї.
+
+Сповіщення має термін дії **24 години**. Оригінали в кеші зашифровані Windows DPAPI; невеликі PNG-прев’ю зберігаються в окремому приватному кеші ProgramData, доступному цьому користувачу та SYSTEM. Старі файли очищаються під час наступних операцій; кожен кеш обмежений 40 файлами та 256 MiB. Це тимчасовий кеш, а не архів скріншотів.
+
+Дивіться також: [Історія буфера обміну](Clipboard) · [Гарячі клавіші](Usage) · [Оновлення](FAQ).
@@ -9,6 +9,7 @@
 | Transliterate | Ctrl+Alt+Shift+T |
 | Undo | Ctrl+Alt+Shift+Z |
 | Clipboard history | Ctrl+Shift+V |
+| Screen capture | Win+Shift+S |
 | Перші три розкладки | Ctrl+Alt+Shift+1 / 2 / 3 |

 Щоб змінити хоткей, клацніть його поле в **Settings**, натисніть потрібні клавіші та збережіть налаштування. **Backspace / Delete** без модифікаторів очищає поле. Для розкладки спочатку виберіть її в списку й змініть **Direct layout shortcut**.
@@ -17,6 +18,8 @@

 ## Історія буфера обміну

+[Докладний посібник зі скріншотами](Clipboard). Захоплення та редагування зображень описані на сторінці [Скріншоти](Screenshots).
+
 Увімкніть **Record clipboard history**. Відкривайте список через іконку в треї або налаштований хоткей. У списку показуються текстові фрагменти та мініатюри зображень; доступні пошук і закріплення. Повторні зображення від Snipping Tool дедуплікуються.

 | У вікні історії | Дія |
@@ -4,4 +4,6 @@
 - [Автовиправлення та словники](https://gitea.hrynco.com/hrynco/hrynco-kswitcher/wiki/Auto-correction)
 - [Хоткеї, буфер, snippets](https://gitea.hrynco.com/hrynco/hrynco-kswitcher/wiki/Usage)
 - [Оновлення та FAQ](https://gitea.hrynco.com/hrynco/hrynco-kswitcher/wiki/FAQ)
+- [Скріншоти та редактор](https://gitea.hrynco.com/hrynco/hrynco-kswitcher/wiki/Screenshots)
+- [Історія буфера обміну](https://gitea.hrynco.com/hrynco/hrynco-kswitcher/wiki/Clipboard)
 - [Релізи](https://gitea.hrynco.com/hrynco/hrynco-kswitcher/releases)