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库。