TerminalImageViewer

Visualizador de imagem terminal (TIV)

Programa C ++ pequeno para exibir imagens em um terminal (moderno) usando códigos RGB ANSI e caracteres gráficos de bloco unicode.

Existem várias ferramentas semelhantes (como timg ) que usam o caractere de meio bloco Unicode para exibir dois pixels de 24 bits por célula de caracteres. Este programa aprimora a resolução mapeando células de 4x8 pixels para diferentes caracteres Unicode, usando o algoritmo a seguir para cada célula de 4x8 pixels da imagem (potencialmente reduzida):

1. Encontre o canal de cores (R, G ou B) que possui a maior variedade de valores para a célula atual
2. Divida esse intervalo no meio e crie um bitmap correspondente para a célula
3. Compare o bitmap com os bitmaps assumidos para vários caracteres gráficos de blocos unicode
4. Recalcular as cores de primeiro plano e plano de fundo para o personagem escolhido.

Veja a diferença desativando essa otimização usando a opção -0 . Ou apenas dê uma olhada na imagem de comparação no final deste texto.

Uso

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

A concha expandirá curingas. Por padrão, as miniaturas e nomes de arquivos serão exibidos se mais de uma imagem for fornecida. Para uma lista de opções, execute o comando sem parâmetros ou com --help .

Notícias

• 2024-03-20: Adicionado uma seção sobre como usar a API.
• 2024-02-01: Atualmente, estamos trabalhando para dividir o código-fonte em arquivos de biblioteca sem dependência e um cliente que usa o CIMG.
• 2023-09-29: Hoje marca o 40º aniversário do projeto GNU. Se você não aprendeu as notícias sobre isso e Stallman, por favor, faça. O suporte ao MSVC foi adicionado e o repositório está agora em uma licença dupla Apache 2.0 ou GPL3. A construção do CI para cada lançamento será configurada em breve. O programa principal também adotou um estilo de código principalmente do Google porque eu (Aaron) acho que simplesmente faz sentido. SPDX-License-Identifier: Apache-2.0 OR GPL-3.0-or-later
• 2021-05-22: Agora apoiamos a Apple Clang, graças à biblioteca de sistemas de arquivos C ++ que não é mais experimental. Os formulários de emissão também foram adicionados ao repositório do GitHub.
• 2020-10-22: A versão Java está agora depreciada . O desenvolvimento mudou há muito tempo para a versão C ++ desde que foi criada, e a última atualização significativa foi em 2016.

Instalação

Importante

Todos os métodos de instalação requerem a instalação do ImageMagick, uma dependência necessária. A maioria dos gerentes de pacotes deve instalá -lo automaticamente.

Todas as plataformas: construir a partir da fonte

Nosso Makefile atualmente suporta apenas g++ . Deve ser possível compilar tiv usando qualquer um dos seus compiladores favoritos que suportam cabeçalhos C ++ 17 e Unix ( ioctl.h e sysexits.h , especificamente) ou windows.h . Os PRs são bem -vindos.

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

Por favor, não se esqueça de instalar o ImageMagick ... no Linux, com sede no Debian, via sudo apt install imagemagick e no macOS via brew install imagemagick .

Mac: Homebrew

brew install tiv

Como o Apple Shell original suporta apenas o modo de cor 256 (-256) e parece haver algum espaçamento extra de linha, distorcendo a imagem, também recomendamos a instalação do ITERM2:

 brew install --cask iterm2

Pacotes de terceiros

• @megamaced criou um RPM para o SUSE
• @bperel criou uma imagem do docker

Problemas comuns / solução de problemas

• Erros como "formato de arquivo não reconhecido"? Verifique se o ImageMagic está instalado.
• Em algumas plataformas Linux, uma bandeira extra parece ser necessária: make LDLIBS=-lstdc++fs (mas também quebra o macOS), consulte #103
• Se você vê linhas horizontais estranhas, os caracteres não preenchem completamente a célula do personagem. Remova o espaçamento de linha adicional em seu aplicativo de terminal
• Cores erradas? Tente -256 para usar uma paleta de cores 256 em vez de cores de 24 bits
• Personagens estranhos? Tente -0 ou instalar uma fonte unicode completa (por exemplo, inconsolata ou piracode)

Usando a API TIV

O TIV pode ser usado como uma API. Portanto, se você sempre quis executar seu FPS favorito em uma concha, esta é a oportunidade.

Todo o código útil como uma biblioteca é isolado em tiv_lib.h e tiv_lib.cc.

O ponto de entrada principal é

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

A chamada pega uma função STD :: que permite que o código TIV solicite pixels do seu FrameBuffer.

A partir deste Framebuffer, a chamada consultará pixels para um retângulo de 4x8 pixels, onde X0 e Y0 definem o canto superior esquerdo. A chamada pesquisa o melhor caractere e cores gráficas Unicode para aproximar esta célula da imagem e as retorna em uma estrutura chardata.

Contribuições

• 2019-03-26: Semana emocionante: @Cabelo tem redirecionamento de saída fixa, o @BoreTom adicionou suporte de compilação cruzada ao arquivo de compilação e o @AlandesMet corrigiu miniaturas altas e imagens em escala de escala.
• 2020-07-05: @cxwx fixou suporte homebrew.

Fico feliz em aceitar contribuições úteis sob a licença Apache 2.0, mas ...

• Antes de investir em contribuições maiores, use um problema para discutir isso
• As solicitações de tração devem ser o mais "atômicas" possível. Não aceitarei nenhuma solicitação de puxão fazendo várias coisas de uma só vez.
• Atualmente, este programa depende apenas do CIMG e do ImageMagick como bibliotecas de processamento de imagens e eu prefiro mantê -lo dessa maneira.
• O suporte a plataformas adicionais, CPUs ou similares exigirá que alguém que esteja feliz em ajudar na manutenção, em particular se eu não tiver acesso a ela.

Exemplos

A maioria dos exemplos foi filmada com a versão Java deste programa, que deve ter saída equivalente, mas mais lenta por Millenia nos anos da CPU.

Se várias imagens correspondem à especificação do nome do arquivo, as miniaturas serão mostradas.

Para o exemplo abaixo, a imagem superior foi gerada com a otimização de caracteres desativada através da opção -0 .

Licenciamento

Você é livre para usar este código no GPL (3 ou posterior) ou versão 2.0 da licença Apache. Incluímos a biblioteca CIMG, licenciada no Cecill 2.0 (próxima a GPL e compatível com ela) ou [Cecill-C] (https://spdx.org/license/cecill-c) (próximo ao LGPL e compatível com apache).