TerminalImageViewer

Терминальный просмотрщик изображений (TIV)

Small C ++ Программа для отображения изображений в (современном) терминале с использованием кодов RGB ANSI и графических символов блока Unicode.

Существуют различные аналогичные инструменты (такие как timg ), которые используют символ полукодного половины блока для отображения двух 24 -битных пикселей на ячейку символа. Эта программа усиливает разрешение путем отображения 4x8 пиксельных ячеек с разными символами Unicode, используя следующий алгоритм для каждой 4x8 пиксельной ячейки (потенциально опускаемого) изображения:

1. Найдите цветный канал (R, G или B), который имеет наибольший диапазон значений для текущей ячейки
2. Разделите этот диапазон посередине и создайте соответствующую растровую карту для ячейки
3. Сравните растровый карту с предполагаемыми растровыми картами для различных символов графики Unicode Block
4. Повторно рассчитывайте на передний план и фоновые цвета для выбранного персонажа.

Смотрите разницу, отключив эту оптимизацию, используя опцию -0 . Или просто посмотрите на сравнение изображения в конце этого текста.

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

tiv [options] < filename > [ < filename > ...]

Оболочка расширит подстановочные знаки. По умолчанию миниатюры и имена файлов будут отображаться, если будет предоставлено более одного изображения. Для списка параметров запустите команду без каких -либо параметров или с --help .

Новости

• 2024-03-20: добавил раздел о том, как использовать API.
• 2024-02-01: В настоящее время мы работаем над разделением исходного кода на файлы библиотеки без зависимостей и клиента, который использует CIMG.
• 2023-09-29: Сегодня отмечается 40-летие проекта GNU. Если вы не узнали новости об этом и Stallman, пожалуйста, сделайте. Поддержка MSVC была добавлена, и в настоящее время репозиторий находится под двойной лицензией Apache 2.0 или GPL3. Надеемся, что здание CI для каждого выпуска будет настроено в ближайшее время. Основная программа также приняла в основном стиль кода Google, потому что я (Аарон) считаю, что это просто имеет смысл. SPDX-License-Identifier: Apache-2.0 OR GPL-3.0-or-later
• 2021-05-22: Теперь мы поддерживаем Apple Clang, благодаря библиотеке файловой системы C ++ больше не экспериментальной. Формы проблем также были добавлены в репозиторий GitHub.
• 2020-10-22: версия Java теперь устарела . Разработка давно перешла к версии C ++ с тех пор, как она была создана, и последнее значимое обновление было в 2016 году.

Установка

Важный

Все методы установки требуют установки ImageMagick, необходимой зависимости. Большинство менеджеров пакетов должны установить его автоматически.

Все платформы: построить из источника

Наш Makefile в настоящее время поддерживает только g++ . Должно быть возможно компилировать tiv вручную, используя любой из ваших любимых компиляторов, которые поддерживают заголовки C ++ 17 и Unix ( ioctl.h и sysexits.h , в частности) или windows.h . PRS приветствуются.

git clone https://github.com/stefanhaustein/TerminalImageViewer.git
cd TerminalImageViewer/src
make

# To move the tiv binary into your PATH (hopefully), also do
sudo make install

Пожалуйста, не забудьте установить ImageMagick ... на Linux на базе Debian через sudo apt install imagemagick и на MacOS через brew install imagemagick .

Мак: Домашний

brew install tiv

Поскольку оригинальная Apple Shell поддерживает только цветовой режим 256 (-256), и, похоже, есть дополнительное расстояние между линиями, искажая изображение, мы также рекомендуем установить iTerm2:

 brew install --cask iterm2

Сторонние пакеты

• @megamaced создал RPM для SUSE
• @bperel создал изображение Docker

Общие проблемы / устранение неполадок

• Ошибки, такие как «нераспознанный формат файлов»? Убедитесь, что Imagemagic установлен.
• На некоторых платформах Linux, кажется, требуется дополнительный флаг: make LDLIBS=-lstdc++fs (но он также ломает MacOS), см. #103
• Если вы видите странные горизонтальные линии, персонажи не полностью заполняют ячейку символа. Удалить дополнительное расстояние между линиями в вашем приложении терминала
• Неправильные цвета? Попробуйте -256, чтобы использовать цветовую палитру 256 вместо 24 -битных цветов
• Странные персонажи? Попробуйте -0 или установите шрифт Unicode Full Unicode (например, unconsolata или Firacode)

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

TIV можно использовать в качестве API. Так что, если вы всегда хотели запустить свой любимый FPS в оболочке, это возможность.

Весь код, полезный в виде библиотеки, изолирован в tiv_lib.h и tiv_lib.cc.

Основная точка входа

CharData findCharData (GetPixelFunction get_pixel, int x0, int y0, const int &flags)

Вызов принимает функцию std ::, которая позволяет коду TIV запросить пиксели с вашего кадриста.

Из этого кадриста вызов будет запросить пиксели для прямоугольника 4x8 пикселей, где x0 и y0 определяют верхний левый угол. Вызов ищет лучшего символа и цветов Unicode Graphics, чтобы приблизить эту ячейку изображения, и возвращает их в структуре Chardata.

Вклад

• 2019-03-26: Захватывающая неделя: @cabelo имеет фиксированное перенаправление выхода, @boretom добавила поддержку межкомпиляции в файл сборки, а @Alandesmet имеет фиксированные миниатюры и изображения в сети.
• 2020-07-05: @cxwx имеет исправленную поддержку домашнего завода.

Я рад принять полезные взносы по лицензии Apache 2.0, но ...

• Прежде чем инвестировать в более крупные взносы, используйте проблему для обсуждения этого
• Запросы на вывод должны быть как можно более «атомными». Я не приму никаких запросов на привлечение, делая несколько вещей одновременно.
• В настоящее время эта программа зависит только от CIMG и ImageMagick как библиотеки обработки изображений, и я бы предпочел, чтобы это было так.
• Поддержка дополнительных платформ, процессоров или подобных потребует того, кто рад помочь с техническим обслуживанием, в частности, если у меня нет доступа к ней.

Примеры

Большинство примеров были сняты с Java -версией этой программы, которая должна иметь эквивалентный выход, но медленнее на тысячелетия в годы CPU.

Если несколько изображений соответствуют спецификации файла, отображаются миниатюры.

Для примера ниже, верхнее изображение было сгенерировано с помощью оптимизации символов отключена через опцию -0 .

Лицензирование

Вы можете использовать этот код в GPL (3 или позже) или версии 2.0 лицензии Apache. Мы включаем библиотеку CIMG, которая лицензирована либо в Cecill 2.0 (близко к GPL и совместимой с ней) или [cecill-c] (https://spdx.org/licenses/cecill-c) (близко к LGPL и совместимо с Apache).