TerminalImageViewer

終端圖像查看器（TIV）

小型C ++程序使用RGB ANSI代碼和Unicode塊圖形字符在（現代）終端顯示圖像。

使用Unicode timg Block字符顯示每個字符單元的兩個24位像素。該程序通過使用以下算法對（可能降低的）圖像的每個4x8像素單元格進行以下算法來增強分辨率：使用以下算法：

1. 找到具有當前單元格的最大值範圍的顏色通道（R，G或B）
2. 將此範圍分開在中間，並為單元格創建相應的位圖
3. 將位圖與各種Unicode塊圖形字符的假定位圖進行比較
4. 重新計算所選字符的前景和背景顏色。

通過使用-0選項禁用此優化，請參閱區別。或者只是查看本文末尾的比較圖像。

用法

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

外殼將擴大通配符。默認情況下，如果提供了多個圖像，將顯示縮略圖和文件名。對於選項列表，請在沒有任何參數的情況下運行命令或--help螺旋。

消息

• 2024-03-20：添加了有關如何使用API​​的部分。
• 2024-02-01：我們當前正在努力將源代碼分配到無依賴性庫文件和使用CIMG的客戶端。
• 2023-09-29：今天是GNU項目40週年。如果您還沒有了解有關它的新聞和Stallman，請這樣做。已經添加了對MSVC的支持，並且存儲庫現在處於Apache 2.0或GPL3雙重許可下。有望盡快設置每個版本的CI建築物。主要程序還採用了Google代碼風格，因為我（Aaron）認為這是有道理的。 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++ 。應該使用支持C ++ 17和Unix標頭（ ioctl.h and sysexits.h ，特別是windows.h的任何您喜歡的編譯器）手動編譯tiv 。歡迎PR。

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 ...通過sudo apt install imagemagick和Macos通過brew install imagemagick 。

Mac：自製

brew install tiv

由於原始的Apple Shell僅支持256顏色模式（-256），並且似乎有一些額外的線間距，因此扭曲了圖像，我們還建議安裝Iterm2：

 brew install --cask iterm2

第三方套餐

• @megamaced創建了一個用於SUSE的RPM
• @bperel創建了一個docker映像

常見問題 /故障排除

• 諸如“未識別的文件格式”之類的錯誤？確保已安裝圖像磁性。
• 在某些Linux平台上，似乎需要一個額外的標誌： make LDLIBS=-lstdc++fs （但也會破壞MacOS），請參閱＃103
• 如果您看到奇怪的水平線，則字符不會完全填充字符單元。刪除終端應用中的其他線間距
• 顏色錯誤？嘗試-256使用256調色板代替24位顏色
• 奇怪的角色？嘗試-0或安裝使用完整的Unicode字體（例如Inconsolata或Firacode）

使用TIV API

TIV可以用作API。因此，如果您一直想在外殼中運行自己喜歡的FPS，這就是機會。

所有用作庫的代碼都在tiv_lib.h和tiv_lib.cc中隔離。

主要切入點是

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

呼叫採用std ::函數，該功能允許TIV代碼從Framebuffer請求像素。

從此框架緩衝器中，呼叫將查詢像素的4x8像素矩形，其中x0和y0定義了左上角。呼叫搜索最佳的Unicode圖形字符和顏色，以近似圖像的此單元格，並將其返回在Chardata結構中。

貢獻

• 2019-03-26：激動人心的一周：@Cabelo具有固定的輸出重定向，@boretom已為構建文件增加了交叉兼容支持，並且@alandesmet具有固定的高縮略圖和灰度尺寸的圖像。
• 2020-07-05：@CXWX擁有固定的自製支持。

我很高興接受Apache 2.0許可下的有用捐款，但是...

• 在投資更大的貢獻之前，請使用問題來討論這一點
• 拉請求應盡可能“原子”。我不會一次接受任何拉動請求。
• 該程序當前僅取決於CIMG和ImageMagick作為圖像處理庫，我更喜歡保持這種方式。
• 支持其他平台，CPU或類似平台將需要一個樂於幫助維護的人，特別是如果我無法訪問它。

例子

大多數示例是使用該程序的Java版本拍攝的，該程序的輸出應該等效，但在CPU年中，千禧年的輸出較慢。

如果多個圖像匹配文件名規格，則顯示縮略圖。

在下面的示例中，頂部圖像是通過-0選項禁用字符優化的。

許可

您可以在Apache許可證的GPL（3或更高版本）或版本2.0下免費使用此代碼。我們包括在Cecill 2.0（靠近GPL並與之兼容的）或[Cecill-C]（https://spdx.org/licenses/cecill-c）（靠近LGPL並與Apache兼容）的CIMG庫。