TerminalImageViewer

Terminaler Bild Betrachter (TIV)

Kleines C ++ - Programm zum Anzeigen von Bildern in einem (modernen) Terminal mit RGB -ANSI -Codes und Unicode -Blockgrafikzeichen.

Es gibt verschiedene ähnliche Werkzeuge (z. B. timg ), die das Unicode -Halbblock -Zeichen verwenden, um zwei 24 -Bit -Pixel pro Zeichenzelle anzuzeigen. Dieses Programm verbessert die Auflösung, indem 4x8 Pixelzellen auf verschiedene Unicode -Zeichen abgebildet werden, wobei der folgende Algorithmus für jede 4x8 -Pixel -Zelle des (potenziell heruntergezogenen) Bildes verwendet wird:

1. Finden Sie den Farbkanal (R, G oder B), der den größten Wertebereich für die aktuelle Zelle hat
2. Teilen Sie diesen Bereich in der Mitte auf und erstellen Sie eine entsprechende Bitmap für die Zelle
3. Vergleichen Sie die Bitmap mit den angenommenen Bitmaps für verschiedene Unicode -Block -Grafikzeichen
4. Qualculieren Sie den Vordergrund und die Hintergrundfarben für den gewählten Charakter neu.

Sehen Sie den Unterschied an, indem Sie diese Optimierung mit der Option -0 deaktivieren. Oder schauen Sie sich einfach das Vergleichsbild am Ende dieses Textes an.

Verwendung

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

Die Schale wird Wildcards erweitern. Standardmäßig werden Miniaturansichten und Dateinamen angezeigt, wenn mehr als ein Bild bereitgestellt wird. Führen Sie für eine Liste von Optionen den Befehl ohne Parameter oder mit --help aus.

Nachricht

• 2024-03-20: Fügte einen Abschnitt zur Verwendung der API hinzu.
• 2024-02-01: Wir arbeiten derzeit daran, den Quellcode in abhängige Bibliotheksdateien und einen Client aufzuteilen, der CIMG verwendet.
• 2023-09-29: Heute jährt sich das 40. Jahrestag des GNU-Projekts. Wenn Sie die Nachrichten über sie und Stallman nicht erfahren haben, tun Sie dies bitte. Die Unterstützung für MSVC wurde hinzugefügt und das Repository befindet sich jetzt unter einer Doppellizenz von Apache 2.0 oder GPL3. Das CI -Gebäude für jede Veröffentlichung wird hoffentlich bald eingerichtet. Das Hauptprogramm hat auch einen meist Google-Code-Stil angenommen, weil ich (Aaron) der Meinung ist, dass es einfach Sinn macht. SPDX-License-Identifier: Apache-2.0 OR GPL-3.0-or-later
• 2021-05-22: Wir unterstützen jetzt Apple Clang, dank der C ++-Dateisystembibliothek, die nicht mehr experimentell ist. Problemformulare wurden auch zum GitHub -Repository hinzugefügt.
• 2020-10-22: Die Java-Version ist jetzt veraltet . Die Entwicklung hat sich seitdem seit langem in die C ++ - Version verschoben, und das letzte aussagekräftige Update war im Jahr 2016.

Installation

Wichtig

Alle Installationsmethoden erfordern die Installation von Imagemagick, eine erforderliche Abhängigkeit. Die meisten Paketmanager sollten es automatisch installieren.

Alle Plattformen: Erstellen Sie aus der Quelle

Unser Makefile unterstützt derzeit nur g++ . Es sollte möglich sein, tiv manuell mit einem Ihrer Lieblings -Compiler zu kompilieren, die C ++ 17 und UNIX -Header ( ioctl.h und sysexits.h , speziell) oder windows.h unterstützen. PRs sind willkommen.

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

Bitte vergessen Sie nicht, Imagemagick zu installieren ... unter Debian -basiertes Linux über sudo apt install imagemagick und auf MacOS über brew install imagemagick .

MAC: Homebrew

brew install tiv

Da die ursprüngliche Apple-Shell nur den 256-Farbmodus (-256) unterstützt und es einen zusätzlichen Zeilenabstand zu geben scheint. Wenn Sie das Bild verzerren, empfehlen wir außerdem, ITERM2 zu installieren:

 brew install --cask iterm2

Pakete von Drittanbietern

• @Megamaced hat eine Drehzahl für SUSE erstellt
• @bperel hat ein Docker -Bild erstellt

Häufige Probleme / Fehlerbehebung

• Fehler wie "nicht anerkanntes Dateiformat"? Stellen Sie sicher, dass Imagemagic installiert ist.
• Auf einigen Linux-Plattformen scheint ein zusätzliches Flag erforderlich zu sein: make LDLIBS=-lstdc++fs (aber es bricht auch MacOS), siehe #103
• Wenn Sie seltsame horizontale Linien sehen, füllen die Zeichen die Zeichenzelle nicht vollständig. Entfernen Sie den zusätzlichen Linienabstand in Ihrer Terminal -App
• Falsche Farben? Versuchen Sie -256, um eine 256 Farbpalette anstelle von 24 -Bit -Farben zu verwenden
• Seltsame Charaktere? Versuchen Sie es -0 oder installieren Sie eine Verwendung einer vollständigen Unicode -Schriftart (z. B. Inkonsolata oder Firacode).

Verwenden der TIV -API

TIV kann als API verwendet werden. Wenn Sie also immer Ihre Lieblings -FPS in einer Hülle betreiben wollten, ist dies die Gelegenheit.

Der gesamte als Bibliothek nützliche Code ist in tiv_lib.h und tiv_lib.cc isoliert.

Der Haupteintrittspunkt ist

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

Der Anruf enthält eine STD :: -Funktion, mit der der TIV -Code Pixel von Ihrem FrameBuffer anfordern kann.

Aus diesem FrameBuffer wird der Anruf Pixel für ein 4x8 -Pixel -Rechteck abfragt, wobei X0 und Y0 die obere linke Ecke definieren. Der Anruf sucht nach dem besten Unicode -Grafikcharakter und den Farben, um diese Bildzelle zu approximieren, und gibt diese in einer Chardata -Struktur zurück.

Beiträge

• 2019-03-26: Spannende Woche: @Cabelo hat die Umleitung von Ausgaben festgelegt. @Boretom hat der Build-Datei Cross-Compilation-Unterstützung hinzugefügt, und @Alandesmet hat große Miniaturansichten und Grauskala-Bilder festgelegt.
• 2020-07-05: @CXWX hat Homebrew-Unterstützung behoben.

Gerne akzeptiere ich nützliche Beiträge unter der Apache 2.0 -Lizenz, aber ...

• Bevor Sie in größere Beiträge investieren, verwenden Sie bitte ein Problem, um dies zu besprechen
• Pull -Anfragen sollten so "atomic" wie möglich sein. Ich werde keine Pull -Anfrage akzeptieren, die mehrere Dinge gleichzeitig erledigt.
• Dieses Programm hängt derzeit nur von CIMG und Imagemagick als Bildverarbeitungsbibliotheken ab, und ich würde es vorziehen, es so zu halten.
• Die Unterstützung für zusätzliche Plattformen, CPUs oder ähnliches benötigt jemanden, der gerne bei der Wartung hilft, insbesondere wenn ich keinen Zugriff darauf habe.

Beispiele

Die meisten Beispiele wurden mit der Java -Version dieses Programms gedreht, die in CPU -Jahren eine gleichwertige Ausgabe haben sollte, aber für Millenia langsamer.

Wenn mehrere Bilder mit der Dateinamenspezifikation übereinstimmen, werden Miniaturansichten angezeigt.

Für das folgende Beispiel wurde das obere Bild mit der Zeichenoptimierung über die Option -0 generiert.

Lizenzierung

Sie können diesen Code entweder unter der GPL (3 oder später) oder Version 2.0 der Apache -Lizenz verwenden. Wir enthalten die CIMG-Bibliothek, die entweder unter Cecill 2.0 (in der Nähe von GPL und damit kompatibel) oder [CECILL-C] (https://spdx.org/licenses/cecill-c) (in der Nähe von LGPL und mit Apache kompatibel) lizenziert ist.