Document v0.6.8: background OCR, optional Tesseract setup and pencil default

2026-10-29 21:41:26 +02:00
parent 6f62e1c6bd
commit e2eab22a23
1 changed files with 25 additions and 2 deletions
@@ -40,9 +40,32 @@ KSwitcher зберігає скопійовані **тексти, зображе

 ## Зображення, OCR та скріншоттер

-Скріншоти KSwitcher одразу потрапляють до буфера й записуються в історію, якщо її запис увімкнений. Після редагування натисніть **Ctrl+C**, щоб скопіювати результат із позначками. Повторні однакові зображення дедуплікуються.
+Починаючи з **v0.6.8**, нові картинки автоматично розпізнаються у фоні. Старі картинки без OCR обробляються один раз, від найновіших. Після розпізнавання введіть слово з картинки в **Search clipboard history**, щоб знайти оригінальне зображення. Список оновиться автоматично після завершення OCR.

-Для розпізнавання виберіть зображення й команду **Copy text from image (Windows OCR)** у контекстному меню. Потрібні встановлені мовні компоненти OCR Windows. Докладніше про захоплення й позначки: [Скріншоти та редактор](https://gitea.hrynco.com/hrynco/hrynco-kswitcher/wiki/Screenshots-uk).
+Пошук не враховує регістр і шукає точний фрагмент тексту. Він фільтрує записи, зберігаючи їхній порядок. Натискати Enter або переходити в інше вікно не потрібно: пошук починається після паузи в наборі приблизно 180 мс. Він працює окремо від запису буфера, прев’ю та OCR й не завантажує картинки, коли для перевірки достатньо наявного прев’ю.
+
+Розпізнаний текст зберігається поруч із картинкою в зашифрованому DPAPI-файлі, повторно використовується після перезапуску та видаляється разом із зображенням. Пошук не запускає OCR повторно. Автоматичне розпізнавання не змінює буфер обміну й оригінальну картинку. Порожні результати запам’ятовуються; незавершена обробка продовжується після перезапуску. Помилки записуються в лог без спливаючих діалогів.
+
+Команда **Copy text from image (OCR)** копіює збережений текст або дозволяє повторити невдале розпізнавання. Захоплення скріншотів і копіювання відредагованого результату працюють як раніше; див. [Скріншоти](Screenshots-uk).
+
+### Windows OCR — типовий рушій
+
+Windows OCR працює локально та вибирає доступний розпізнавач із мов профілю Windows. Клавіатурна розкладка не гарантує наявність OCR-моделі. Усі мови одночасно автоматично не запускаються. Якість залежить від мови, розміру тексту та чіткості картинки.
+
+### Опціональний Tesseract: український і змішаний текст
+
+Tesseract — **необов’язкова опція, типово вимкнена**. Він не входить у пакет KSwitcher і не завантажується автоматично. Обидва рушії обробляють картинки локально.
+
+1. Відкрийте **Settings → OCR options…**. Кнопка **Download Tesseract…** відкриває [сторінку Windows-інсталятора UB Mannheim](https://github.com/UB-Mannheim/tesseract/wiki#tesseract-installer-for-windows) у браузері. Установіть **64-бітний Tesseract 5** та потрібні мовні моделі. Архіви **Source code** містять вихідний код, а не готовий інсталятор.
+2. Увімкніть **Use optional Tesseract 5 instead of Windows OCR**.
+3. Залиште шлях порожнім для автоматичного пошуку типової інсталяції або виберіть `tesseract.exe` кнопкою **Browse…**. Поруч мають бути `libtesseract-5.dll`, залежності та папка `tessdata`.
+4. Укажіть `ukr+eng+rus` для української, англійської та російської разом або інший набір установлених моделей, наприклад `ukr+eng`. Відсутні моделі спричинять зрозумілу помилку.
+5. Натисніть **Check installation**. Напис **Ready: ukr+eng+rus** лише підтверджує наявність моделей. Він **не вмикає** Tesseract і не зберігає налаштування.
+6. Натисніть **OK**, а потім **Save** в основному вікні налаштувань.
+
+Зміна рушія, шляху або мов оновлює OCR збережених картинок у фоні. Дочекайтеся завершення, перш ніж перевіряти раніше нерозпізнані слова. Щоб повернути Windows OCR, зніміть галочку та збережіть налаштування. Використовується один вибраний рушій, а не обидва одночасно. Для розпізнавання Tesseract установлено межу 30 секунд на картинку.
+
+Якщо слово не знаходиться, перевірте, чи опцію ввімкнено й збережено, дочекайтеся OCR та перегляньте результат через **Copy text from image (OCR)**. Дрібний, нечіткий або перекреслений текст може розпізнатися з помилками. Пошук не виправляє написання приблизно.

 ## Ліміти та приватність