TerminalImageViewer

ターミナルイメージビューア（TIV）

RGB ANSIコードとUnicodeブロックグラフィック文字を使用して（最新の）端子に画像を表示する小さなC ++プログラム。

Unicodeハーフブロック文字を使用して、文字セルごとに2つの24ビットピクセルを表示するさまざまな同様のツール（ timgなど）があります。このプログラムは、（潜在的にダウンスケールされた）画像の4x8ピクセルセルごとに次のアルゴリズムを使用して、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周年を迎えます。あなたがそれとストールマンに関するニュースを学んだことがないなら、してください。 MSVCのサポートが追加されており、リポジトリはApache 2.0またはGPL3デュアルライセンスの下にあります。各リリースのCIビルディングがまもなくセットアップされることを願っています。また、メインプログラムは、私（アーロン）が単に理にかなっていると考えているため、ほとんどがGoogleコードスタイルを採用しています。 SPDX-License-Identifier: Apache-2.0 OR GPL-3.0-or-later
• 2021-05-22：C ++ファイルシステムライブラリが実験的ではなくなったおかげで、Apple Clangをサポートしています。問題フォームもGitHubリポジトリに追加されています。
• 2020-10-22：Javaバージョンが廃止されました。開発は作成されて以来、C ++バージョンに長い間シフトしており、最後に意味のある更新は2016年でした。

インストール

重要

すべてのインストール方法では、必要な依存関係であるImageMagickをインストールする必要があります。ほとんどのパッケージマネージャーは、自動的にインストールする必要があります。

すべてのプラットフォーム：ソースからビルド

MakeFileは現在、 g++のみをサポートしています。 C ++ 17およびUNIXヘッダー（ ioctl.hおよび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をインストールすることを忘れないでください... DebianベースのLinuxをsudo apt install imagemagick介して、 brew install imagemagick介してMacOSに。

Mac：Homebrew

brew install tiv

元のApple Shellは256カラーモード（-256）のみをサポートしており、画像を歪めている追加のライン間隔があるように思われるため、ITERM2をインストールすることもお勧めします。

 brew install --cask iterm2

サードパーティパッケージ

• @megamacedは、SuseのRPMを作成しました
• @BperelはDocker画像を作成しました

一般的な問題 /トラブルシューティング

• 「認識されていないファイル形式」などのエラー？ ImageMagicがインストールされていることを確認してください。
• 一部のLinuxプラットフォームでは、余分なフラグが必要であるように見えます。LDLIBS make LDLIBS=-lstdc++fs （ただし、MACOも壊れます）、＃103を参照してください。
• 奇妙な水平線が表示されている場合、文字は文字セルを完全に埋めません。ターミナルアプリで追加のライン間隔を削除します
• 間違った色？ -256を試して、24ビット色ではなく256カラーパレットを使用してください
• 奇妙なキャラクター？ -0を試してみるか、完全なユニコードフォント（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)

コールには、TIVコードがフレームバッファーからピクセルを要求できるSTD ::関数を使用します。

このフレームバファーから、コールは4x8ピクセル長方形のピクセルをクエリし、X0とY0は左上隅を定義します。コールは、画像のこのセルを近似するために最高のUnicodeグラフィックスキャラクターと色を検索し、チャルダタ構造体でこれらを返します。

貢献

• 2019-03-26：エキサイティングな週：@Cabeloは出力リダイレクトを修正しました。@Boretomはビルドファイルに相互コンパイルサポートを追加し、@Alandesmetは背の高いサムネイルとグレースケール画像を修正しました。
• 2020-07-05：@CXWXは自家製のサポートを修正しました。

Apache 2.0ライセンスに基づいて有用な貢献を受け入れることができてうれしいですが...

• より大きな貢献に投資する前に、これについて議論するために問題を使用してください
• プルリクエストは、できるだけ「アトミック」である必要があります。私は一度に複数のことを行うプルリクエストを受け入れません。
• このプログラムは現在、画像処理ライブラリとしてCIMGとImageMagickにのみ依​​存しているため、そのように保つことをお勧めします。
• 追加のプラットフォーム、CPUなどのサポートには、特にアクセスできない場合は、メンテナンスを喜んで支援する人が必要です。

例

ほとんどの例は、このプログラムのJavaバージョンで撮影されました。これには、同等の出力があるが、CPU年のミレニアごとに遅くなるはずです。

複数の画像がファイル名の仕様に一致する場合、サムネイルが表示されます。

以下の例では、 -0オプションを介して無効化された文字最適化で上部画像が生成されました。

ライセンス

このコードは、ApacheライセンスのGPL（3以降）またはバージョン2.0のいずれかで自由に使用できます。 CIMGライブラリを含めます。CIMGライブラリには、CECILL 2.0（GPLに近く、CECILL-C]（https://spdx.org/licenses/cecill-c）のいずれかでライセンスされています（LGPLに近く）。