TerminalImageViewer

Visionneuse d'image terminale (TIV)

Petit programme C ++ pour afficher des images dans un terminal (moderne) à l'aide de codes RGB ANSI et de caractères graphiques de bloc Unicode.

Il existe divers outils similaires (tels que timg ) qui utilisent le caractère de demi-bloc Unicode pour afficher deux pixels 24 bits par cellule de caractères. Ce programme améliore la résolution en mappant des cellules de 4x8 pixels à différents caractères Unicode, en utilisant l'algorithme suivant pour chaque cellule 4x8 pixels de l'image (potentiellement réduite):

1. Trouvez le canal de couleur (R, G ou B) qui a la plus grande gamme de valeurs pour la cellule actuelle
2. Divisez cette plage au milieu et créez un bitmap correspondant pour la cellule
3. Comparez le bitmap aux bitmaps supposés pour divers caractères graphiques de bloc Unicode
4. Re-calculer les couleurs de premier plan et d'arrière-plan pour le caractère choisi.

Voir la différence en désactivant cette optimisation à l'aide de l'option -0 . Ou jetez un œil à l'image de comparaison à la fin de ce texte.

Usage

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

La coquille élargira les caractères génériques. Par défaut, les miniatures et les noms de fichiers seront affichés si plusieurs image sont fournies. Pour une liste d'options, exécutez la commande sans aucun paramètre ou avec --help .

Nouvelles

• 2024-03-20: Ajout d'une section sur la façon d'utiliser l'API.
• 2024-02-01: Nous travaillons actuellement sur la division du code source en fichiers de bibliothèque sans dépendance et un client qui utilise CIMG.
• 2023-09-29: Aujourd'hui marque le 40e anniversaire du projet GNU. Si vous n'avez pas appris les nouvelles concernant cela et Stallman, veuillez le faire. La prise en charge de MSVC a été ajoutée et le référentiel est désormais sous une licence double Apache 2.0 ou GPL3. Le bâtiment CI pour chaque version sera, espérons-le, il sera bientôt configuré. Le programme principal a également adopté un style de code Google principalement parce que je (Aaron) pense que cela a tout simplement de sens. SPDX-License-Identifier: Apache-2.0 OR GPL-3.0-or-later
• 2021-05-22: Nous prenons maintenant en charge Apple Clang, grâce à la bibliothèque de systèmes de fichiers C ++ qui n'est plus expérimentale. Des formulaires d'émission ont également été ajoutés au référentiel GitHub.
• 2020-10-22: La version Java est désormais obsolète . Le développement est depuis longtemps passé à la version C ++ depuis sa création, et la dernière mise à jour significative a été en 2016.

Installation

Important

Toutes les méthodes d'installation nécessitent l'installation d'ImageMagick, une dépendance requise. La plupart des gestionnaires de packages devraient l'installer automatiquement.

Toutes les plates-formes: construire à partir de la source

Notre MakeFile ne prend actuellement en charge que g++ . Il devrait être possible de compiler tiv manuellement en utilisant l'un de vos compilateurs préférés qui prennent en charge les en-têtes C ++ 17 et UNIX ( ioctl.h et sysexits.h , en particulier) ou windows.h . Les PR sont les bienvenus.

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

N'oubliez pas d'installer ImageMagick ... sur Linux basé sur Debian via sudo apt install imagemagick et sur MacOS via brew install imagemagick .

Mac: Homebrew

brew install tiv

Comme la coque Apple d'origine prend en charge uniquement le mode 256 couleurs (-256) et qu'il semble y avoir un espacement de ligne supplémentaire, déformant l'image, nous vous recommandons également d'installer ITerm2:

 brew install --cask iterm2

Packages tiers

• @Megamaced a créé un régime pour SUSE
• @bperel a créé une image docker

Problèmes / dépannage communs

• Des erreurs telles que "format de fichier non reconnu"? Assurez-vous que ImageMagic est installé.
• Sur certaines plates-formes Linux, un drapeau supplémentaire semble être nécessaire: make LDLIBS=-lstdc++fs (mais il casse également macOS), voir # 103
• Si vous voyez d'étranges lignes horizontales, les personnages ne remplissent pas complètement la cellule de caractère. Retirez l'espacement des lignes supplémentaires dans votre application Terminal
• Mauvaises couleurs? Essayez -256 pour utiliser une palette de couleurs 256 au lieu de couleurs 24 bits
• Des personnages étranges? Essayez -0 ou installez une police Use Unicode complète (par exemple, inconsolata ou firacode)

En utilisant l'API TIV

TIV peut être utilisé comme API. Donc, si vous avez toujours voulu gérer vos FP préférés dans un shell, c'est l'occasion.

Tout le code utile en tant que bibliothèque est isolé dans TIV_LIB.H et TIV_LIB.CC.

Le point d'entrée principal est

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

L'appel prend une fonction std :: qui permet au code TIV de demander des pixels à votre framebuffer.

À partir de ce FrameBuffer, l'appel interrogera les pixels pour un rectangle de 4x8 pixels, où X0 et Y0 définissent le coin supérieur gauche. L'appel recherche le meilleur caractère graphique Unicode et couleurs pour approximer cette cellule de l'image et les renvoie dans une structure Chardata.

Contributions

• 2019-03-26: Semaine passionnante: @Cabelo a une redirection de sortie fixe, @Boretom a ajouté une prise en charge de la compilation croisée au fichier de construction et @alandesmet a fixé des miniatures hautes et des images de niveaux de greys.
• 2020-07-05: @CXWX a un support de homebrew fixe.

Je suis heureux d'accepter les contributions utiles sous la licence Apache 2.0, mais ...

• Avant d'investir dans des contributions plus importantes, veuillez utiliser un problème pour en discuter
• Les demandes de traction doivent être aussi "atomiques" que possible. Je n'accepterai aucune demande de traction faisant plusieurs choses à la fois.
• Ce programme dépend actuellement uniquement de CIMG et ImageMagick en tant que bibliothèques de traitement d'image et je préférerais le garder ainsi.
• La prise en charge de plates-formes supplémentaires, de processeurs ou similaires nécessitera une personne heureuse d'aider à la maintenance, en particulier si je n'y ai pas accès.

Exemples

La plupart des exemples ont été tournés avec la version Java de ce programme, qui devrait avoir une sortie équivalente mais plus lente par millénaires au cours des années de processeur.

Si plusieurs images correspondent à la spécification du nom de fichier, les miniatures sont affichées.

Pour l'exemple ci-dessous, l'image supérieure a été générée avec l'optimisation des caractères désactivée via l'option -0 .

Licence

Vous êtes libre d'utiliser ce code sous le GPL (3 ou version ultérieure) ou la version 2.0 de la licence Apache. Nous incluons la bibliothèque CIMG, qui est sous licence sous CECILL 2.0 (près de GPL et compatible avec elle) ou [CECILL-C] (https://spdx.org/licenses/cecill-c) (près de LGPL et compatible avec Apache).