Расширения

Сама программа GuoheView занимает всего около 4 МБ. Чтобы никому не приходилось расплачиваться размером за ненужные функции, часть возможностей вынесена в необязательные плагины: без них программа работает как обычно, а после установки они доступны сразу после перезапуска.

Плагины лежат в папке plugins внутри папки программы, по подпапке на каждый тип:

GuoheView.exe
plugins\
  decoder\    Плагины-декодеры (больше форматов изображений)
  ocr\        Плагин распознавания текста (OCR)

Для версии с установщиком папка программы по умолчанию — C:\Program Files\GuoheView; для портативной — та папка, которую вы распаковали. Обе подпапки уже есть после установки / распаковки, и в каждой лежит readme.txt.

Все плагины доступны на странице загрузки. Они распространяются отдельно и не входят в основную программу.

Плагины-декодеры

Они расширяют список форматов, которые можно открыть. Почти все распространённые и профессиональные форматы уже встроены в программу; лишь немногие вынесены в плагины из-за размера или лицензии — например, JPEG XL.

Установка

  1. На странице загрузки в разделе «Плагины → Плагины-декодеры» скачайте нужный плагин (например, jxl.7z).
  2. Распакуйте его и положите файл .dll в plugins\decoder\ в папке программы.
  3. Перезапустите GuoheView — изображения этого формата начнут открываться.

После установки папка выглядит примерно так:

plugins\decoder\
  jxl.dll
  readme.txt

Эскизы в Проводнике

Плагины-декодеры работают и для расширения эскизов. После установки плагина откройте «Настройки → Эскизы» и отметьте нужное расширение (например, .jxl) — тогда и в Проводнике у таких файлов появятся эскизы.

Удаление

Удалите соответствующий .dll, чтобы отключить поддержку формата; на программу и другие плагины это не повлияет.

Плагин распознавания текста (OCR)

Добавляет распознавание текста на изображениях: оно выполняется на вашем компьютере, изображения никуда не отправляются. Результат показывается рядом с картинкой — изображение слева, текст справа: можно выделять текст прямо на изображении и копировать его или выделять текст справа, и выделение на обеих сторонах синхронизируется.

Движок — RapidOCR (модели PP-OCRv3 для китайского и английского); он справляется со смешанным китайско-английским текстом, вертикальным и наклонным письмом. Из-за файлов моделей весь пакет плагина занимает около 20 МБ, поэтому по умолчанию он не входит в комплект.

Установка

  1. На странице загрузки в разделе «Плагины → Плагин распознавания текста (OCR)» скачайте архив плагина.
  2. Распакуйте его в plugins\ocr\ в папке программы. Внутри архива уже есть структура папок plugins\ocr\, так что можно распаковать его прямо в корневую папку программы.
  3. Перезапустите GuoheView.

После установки папка должна выглядеть так:

plugins\ocr\
  gv-ocr.dll
  onnxruntime.dll
  models\
    ch_PP-OCRv3_det_infer.ort
    ch_PP-OCRv3_rec_infer.ort
    ch_ppocr_mobile_v2.0_cls_infer.ort
    ppocr_keys_v1.txt
  readme.txt

Если нет папки models или любого из файлов .ort, распознавание не запустится.

Использование

После установки и перезапуска в правом верхнем углу главного окна, слева от номера изображения, появится значок «OCR». Нажмите его — откроется окно распознавания, которое распознаёт текущее изображение в максимально доступном разрешении.

В окне распознавания:

  • Слева изображение: проведите по тексту, чтобы выделить его, двойной щелчок выделяет слово, тройной — всю строку; Ctrl+C копирует выделенный текст
  • Справа распознанный текст: выделяйте перетаскиванием через несколько строк, Ctrl+C работает и здесь; «Копировать всё» забирает весь текст сразу
  • Выделение синхронизировано: какую строку вы выделили на изображении, та же выделяется справа, и наоборот
  • На панели инструментов по порядку: «Распознать снова», «По размеру окна», «Реальный размер», «Повернуть на 90°» и справа — «Копировать всё»
  • Строка состояния внизу показывает время распознавания и число строк; если изображение было уменьшено из-за слишком большого размера, это тоже указывается здесь

Пока окно распознавания открыто, главное окно не реагирует на действия. Закройте окно (Esc или кнопка закрытия в правом верхнем углу), чтобы вернуться к просмотру.

Включение и управление

Состояние плагина видно в разделе «Настройки → Расширения»:

  • Установлен: есть переключатель «Показывать в главном окне» — если выключить его, значок «OCR» в главном окне больше не показывается
  • Не установлен: показывается ссылка для загрузки с сайта

О качестве распознавания

Результат получается выводом модели и не бывает точным на 100 % — особенно для декоративных шрифтов, очень мелкого текста и изображений с пёстрым фоном. Программа автоматически отбрасывает явный мусор (строки с очень низкой уверенностью, строки из одних символов и т. п.), поэтому иногда на участке, который «похож на текст», результата нет — обычно это отфильтрованная ошибка движка.

Удаление

Удалите файлы из plugins\ocr\, чтобы отключить плагин; программа автоматически скроет значок OCR.

Частые вопросы

Установил плагин, но ничего не изменилось? Сначала убедитесь, что вы перезапустили программу — плагины загружаются только при запуске. Затем проверьте, что файлы лежат в правильном месте: plugins\decoder\ или plugins\ocr\ внутри папки программы, а не в корне plugins\.

Можно ли установить плагины в портативную версию? Да. Структура папок плагинов в портативной версии и версии с установщиком одинакова — просто распакуйте плагин в папку портативной версии.

Пропадут ли плагины после обновления программы? Нет. Обновление заменяет только файлы самой программы, папка plugins не затрагивается.

Выходят ли плагины в интернет? Нет. Плагины-декодеры только декодируют локально, а модели плагина OCR тоже работают на вашем компьютере — изображения не отправляются ни на какие серверы.