TerminalImageViewer

Penampil gambar terminal (TIV)

Program C ++ Kecil Untuk Menampilkan Gambar di Terminal (Modern) Menggunakan Kode ANSI RGB dan Karakter Grafis Blok Unicode.

Ada berbagai alat serupa (seperti timg ) yang menggunakan karakter setengah blok Unicode untuk menampilkan dua piksel 24bit per sel karakter. Program ini meningkatkan resolusi dengan memetakan sel piksel 4x8 ke karakter unicode yang berbeda, menggunakan algoritma berikut untuk setiap sel piksel 4x8 dari gambar (berpotensi diturunkan):

1. Temukan saluran warna (R, G atau B) yang memiliki kisaran nilai terbesar untuk sel saat ini
2. Pisahkan kisaran ini di tengah dan buat bitmap yang sesuai untuk sel
3. Bandingkan bitmap dengan bitmap yang diasumsikan untuk berbagai karakter grafis blok unicode
4. Menghitung ulang warna latar depan dan latar belakang untuk karakter yang dipilih.

Lihat perbedaan dengan menonaktifkan optimasi ini menggunakan opsi -0 . Atau lihat saja gambar perbandingan di akhir teks ini.

Penggunaan

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

Shell akan memperluas wildcard. Secara default, thumbnail dan nama file akan ditampilkan jika lebih dari satu gambar disediakan. Untuk daftar opsi, jalankan perintah tanpa parameter atau dengan --help .

Berita

• 2024-03-20: Menambahkan bagian tentang cara menggunakan API.
• 2024-02-01: Kami sedang bekerja untuk membagi kode sumber menjadi file perpustakaan bebas dependensi dan klien yang menggunakan CIMG.
• 2023-09-29: Hari ini menandai peringatan ke-40 proyek GNU. Jika Anda belum mempelajari berita tentang itu dan Stallman, silakan lakukan. Dukungan untuk MSVC telah ditambahkan dan repositori sekarang berada di bawah lisensi ganda Apache 2.0 atau GPL3. Bangunan CI untuk setiap rilis semoga akan segera diatur. Program utama juga telah mengadopsi sebagian besar gaya kode Google karena saya (Aaron) berpikir itu masuk akal. SPDX-License-Identifier: Apache-2.0 OR GPL-3.0-or-later
• 2021-05-22: Kami sekarang mendukung Clang Apple, berkat perpustakaan sistem file C ++ yang tidak lagi eksperimental. Formulir masalah juga telah ditambahkan ke repositori GitHub.
• 2020-10-22: Versi Java sekarang sudah usang . Pengembangan telah lama bergeser ke versi C ++ sejak itu dibuat, dan pembaruan terakhir yang berarti untuk itu adalah pada tahun 2016.

Instalasi

Penting

Semua metode instalasi memerlukan pemasangan Imagemagick, ketergantungan yang diperlukan. Sebagian besar manajer paket harus menginstalnya secara otomatis.

Semua Platform: Bangun dari Sumber

Makefile kami saat ini hanya mendukung g++ . Seharusnya dimungkinkan untuk mengkompilasi tiv secara manual menggunakan kompiler favorit Anda yang mendukung header C ++ 17 dan UNIX ( ioctl.h dan sysexits.h , khususnya) atau windows.h . PR dipersilakan.

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

Tolong jangan lupa untuk menginstal Imagemagick ... di Linux berbasis Debian melalui sudo apt install imagemagick dan pada macOS melalui brew install imagemagick .

Mac: Homebrew

brew install tiv

Karena Apple Shell asli hanya mendukung 256 Mode Warna (-256) dan tampaknya ada beberapa jarak garis ekstra, mendistorsi gambar, kami juga merekomendasikan untuk menginstal iterm2:

 brew install --cask iterm2

Paket pihak ketiga

• @Megamaced telah menciptakan RPM untuk SUSE
• @Bperel telah membuat gambar Docker

Masalah umum / pemecahan masalah

• Kesalahan seperti "format file yang tidak dikenal"? Pastikan Imagemagic diinstal.
• Pada beberapa platform Linux, bendera tambahan tampaknya diperlukan: make LDLIBS=-lstdc++fs (tetapi juga merusak macOS), lihat #103
• Jika Anda melihat garis horizontal yang aneh, karakter tidak sepenuhnya mengisi sel karakter. Hapus Jarak Baris Tambahan di Aplikasi Terminal Anda
• Warna yang salah? Coba -256 untuk menggunakan palet 256 warna bukannya 24 bit warna
• Karakter Aneh? Coba -0 atau instal font Use Unicode Full (misalnya inconsolata atau firacode)

Menggunakan API TIV

TIV dapat digunakan sebagai API. Jadi, jika Anda selalu ingin menjalankan FPS favorit Anda dalam cangkang, ini adalah kesempatan.

Semua kode yang berguna sebagai perpustakaan diisolasi dalam tiv_lib.h dan tiv_lib.cc.

Titik masuk utama adalah

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

Panggilan mengambil fungsi std :: yang memungkinkan kode TIV untuk meminta piksel dari framebuffer Anda.

Dari framebuffer ini, panggilan akan meminta piksel untuk persegi panjang piksel 4x8, di mana x0 dan y0 menentukan sudut kiri atas. Panggilan mencari karakter grafis Unicode terbaik dan warna untuk memperkirakan sel gambar ini, dan mengembalikannya dalam struct chardata.

Kontribusi

• 2019-03-26: Minggu yang menarik: @Cabelo telah memperbaiki pengalihan keluaran, @boretom telah menambahkan dukungan kompilasi silang ke file build dan @alandesmet telah memperbaiki thumbnail tinggi dan gambar skala greyscale.
• 2020-07-05: @CXWX telah memperbaiki dukungan homebrew.

Saya senang menerima kontribusi yang berguna di bawah lisensi Apache 2.0, tapi ...

• Sebelum berinvestasi dalam kontribusi yang lebih besar, silakan gunakan masalah untuk membahas ini
• Permintaan tarik harus "atom" mungkin. Saya tidak akan menerima permintaan tarik apa pun yang melakukan banyak hal sekaligus.
• Program ini saat ini hanya tergantung pada CIMG dan Imagemagick sebagai perpustakaan pemrosesan gambar dan saya lebih suka tetap seperti itu.
• Dukungan untuk platform tambahan, CPU atau serupa akan membutuhkan seseorang yang dengan senang hati membantu pemeliharaan, khususnya jika saya tidak memiliki akses ke sana.

Contoh

Sebagian besar contoh diambil dengan versi Java dari program ini, yang seharusnya memiliki output yang setara tetapi lebih lambat oleh milenia pada tahun CPU.

Jika beberapa gambar cocok dengan spesifikasi nama file, thumbnail ditampilkan.

Untuk contoh di bawah ini, gambar atas dihasilkan dengan optimasi karakter dinonaktifkan melalui opsi -0 .

Lisensi

Anda bebas menggunakan kode ini di bawah GPL (3 atau lebih baru) atau versi 2.0 dari lisensi Apache. Kami menyertakan perpustakaan CIMG, yang dilisensikan di bawah Cecill 2.0 (dekat dengan GPL dan kompatibel dengan itu) atau [Cecill-C] (https://spdx.org/licenses/cecill-c) (dekat dengan LGPL dan kompatibel dengan Apache).