TerminalImageViewer

Visor de imágenes terminales (TIV)

Pequeño programa C ++ para mostrar imágenes en un terminal (moderno) utilizando códigos ANSI RGB y caracteres gráficos de unicode bloque.

Existen varias herramientas similares (como timg ) que usan el carácter de medio bloque Unicode para mostrar dos píxeles de 24 bits por celda de caracteres. Este programa mejora la resolución al mapear células de píxeles 4x8 a diferentes caracteres Unicode, utilizando el siguiente algoritmo para cada celda de 4x8 píxeles de la imagen (potencialmente redactada):

1. Encuentre el canal de color (R, G o B) que tiene el mayor rango de valores para la celda actual
2. Dividir este rango en el medio y crear una mapa de bits correspondiente para la celda
3. Compare el mapa de bits con los mapas de bits supuestos para varios caracteres de gráficos de bloque Unicode
4. Vuelva a calcular los colores de primer plano y de fondo para el personaje elegido.

Consulte la diferencia deshabilitando esta optimización utilizando la opción -0 . O simplemente eche un vistazo a la imagen de comparación al final de este texto.

Uso

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

El caparazón ampliará los comodines. Por defecto, se mostrarán miniaturas y nombres de archivos si se proporciona más de una imagen. Para obtener una lista de opciones, ejecute el comando sin ningún parámetro o con --help .

Noticias

• 2024-03-20: Se agregó una sección sobre cómo usar la API.
• 2024-02-01: Actualmente estamos trabajando en dividir el código fuente en archivos de biblioteca sin dependencia y un cliente que usa CIMG.
• 2023-09-29: Hoy marca el 40 aniversario del proyecto GNU. Si no ha aprendido las noticias sobre ella y Stallman, hágalo. Se ha agregado soporte para MSVC y el repositorio ahora está bajo una licencia Dual Apache 2.0 o GPL3. Con suerte, el edificio CI para cada lanzamiento se configurará pronto. El programa principal también ha adoptado un estilo principalmente de código de Google porque yo (Aaron) creo que simplemente tiene sentido. SPDX-License-Identifier: Apache-2.0 OR GPL-3.0-or-later
• 2021-05-22: Ahora admitimos Apple Clang, gracias a que la biblioteca del sistema de archivos C ++ ya no es experimental. También se han agregado formularios de emisión al repositorio de GitHub.
• 2020-10-22: La versión Java ahora está en desuso . El desarrollo ha cambiado durante mucho tiempo a la versión C ++ desde que se creó, y la última actualización significativa fue en 2016.

Instalación

Importante

Todos los métodos de instalación requieren instalar ImageMagick, una dependencia requerida. La mayoría de los administradores de paquetes deben instalarlo automáticamente.

Todas las plataformas: construir desde la fuente

Nuestro Makefile actualmente solo admite g++ . Debería ser posible compilar tiv manualmente utilizando cualquiera de sus compiladores favoritos que admitan los encabezados C ++ 17 y Unix ( ioctl.h y sysexits.h , específicamente) o windows.h . Los PR son bienvenidos.

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

No olvide instalar ImageMagick ... en Linux con sede en Debian a través de sudo apt install imagemagick y en macOS a través de brew install imagemagick .

Mac: Homebrew

brew install tiv

Como la carcasa de Apple original solo admite 256 modo de color (-256) y parece haber un espacio de línea adicional, distorsionando la imagen, también recomendamos instalar ITERM2:

 brew install --cask iterm2

Paquetes de terceros

• @Megamaced ha creado un RPM para SUSE
• @Bperel ha creado una imagen de Docker

Problemas comunes / solución de problemas

• ¿Errores como "formato de archivo no reconocido"? Asegúrese de que se instale ImageMagic.
• En algunas plataformas de Linux, parece que se requiere una bandera adicional: make LDLIBS=-lstdc++fs (pero también rompe macOS), ver #103
• Si ve líneas horizontales extrañas, los caracteres no llenan completamente la celda de caracteres. Eliminar un espacio de línea adicional en su aplicación terminal
• ¿Coloros equivocados? Pruebe -256 para usar una paleta de 256 colores en lugar de colores de 24 bits
• Personajes extraños? Pruebe -0 o instale una fuente de unicode Use (por ejemplo, inconsolata o firacode)

Usando la API TIV

TIV se puede usar como API. Entonces, si siempre quisiste ejecutar tu FPS favorito en un caparazón, esta es la oportunidad.

Todo el código útil como una biblioteca está aislado en tiv_lib.h y tiv_lib.cc.

El principal punto de entrada es

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

La llamada toma una función std :: que permite que el código TIV solicite píxeles desde su framebuffer.

A partir de este FrameBuffer, la llamada consultará píxeles para un rectángulo de 4x8 píxeles, donde X0 e Y0 definen la esquina superior izquierda. La llamada busca el mejor carácter y colores de unicode gráficos para aproximar esta celda de la imagen, y los devuelve en una estructura de Chardata.

Contribuciones

• 2019-03-26: Semana emocionante: @Cabelo ha fijado la redirección de salida, @boretom ha agregado soporte de compilación cruzada al archivo de compilación y @Alandesmet ha arreglado miniaturas altas e imágenes de escala de grises.
• 2020-07-05: @CXWX ha arreglado el soporte casero.

Me complace aceptar contribuciones útiles bajo la licencia Apache 2.0, pero ...

• Antes de invertir en contribuciones más grandes, utilice un problema para discutir esto
• Las solicitudes de extracción deben ser lo más "atómicas" posible. No aceptaré ninguna solicitud de extracción haciendo varias cosas a la vez.
• Este programa actualmente solo depende de CIMG e ImageMagick como bibliotecas de procesamiento de imágenes y preferiría mantenerlo así.
• El soporte para plataformas adicionales, CPU o similares requerirá a alguien que esté feliz de ayudar con el mantenimiento, en particular si no tengo acceso a ello.

Ejemplos

La mayoría de los ejemplos fueron filmados con la versión Java de este programa, que debería tener una producción equivalente pero más lenta por milenia en los años de la CPU.

Si varias imágenes coinciden con la especificación del nombre de archivo, se muestran miniaturas.

Para el siguiente ejemplo, la imagen superior se generó con la optimización de caracteres deshabilitada a través de la opción -0 .

Licencia

Usted puede usar este código en el GPL (3 o posterior) o la versión 2.0 de la licencia Apache. Incluimos la biblioteca CIMG, que tiene licencia bajo CECILL 2.0 (cerca de GPL y compatible con ella) o [Cecill-C] (https://spdx.org/licenses/cecill-c) (cerca de LGPL y compatible con Apache).