TerminalImageViewer

터미널 이미지 뷰어 (TIV)

RGB ANSI 코드 및 유니 코드 블록 그래픽 문자를 사용하여 (현대) 터미널에 이미지를 표시하는 작은 C ++ 프로그램.

유니 코드 반 블록 문자를 사용하여 문자 셀당 2 개의 24 비트 픽셀을 표시하는 다양한 유사한 도구 (예 : timg )가 있습니다. 이 프로그램은 4x8 픽셀 셀을 다른 유니 코드 문자에 매핑하여 해상도를 향상시켜 (잠재적으로 다운 스 칼디 된) 이미지의 각 4x8 픽셀 셀에 대한 다음 알고리즘을 사용하여 다음과 같습니다.

1. 현재 셀의 값 범위가 가장 큰 컬러 채널 (R, G 또는 B)을 찾으십시오.
2. 이 범위를 중간에 분할하고 셀에 해당하는 비트 맵을 만듭니다.
3. 비트 맵을 다양한 유니 코드 블록 그래픽 문자에 대한 가정 된 비트 맵과 비교하십시오.
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 ++ 버전이 생성 된 이래로 오랫동안 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

sudo apt install imagemagick brew install imagemagick 하는 것을 잊지 마십시오.

Mac : 홈 브루

brew install tiv

원래 Apple Shell은 256 개의 색상 모드 (-256) 만 지원하고 이미지를 왜곡하여 추가 라인 간격이있는 것 같습니다. 또한 ITERM2를 설치하는 것이 좋습니다.

 brew install --cask iterm2

타사 패키지

• @Megamaced는 Suse를위한 RPM을 만들었습니다
• @bperel은 Docker 이미지를 만들었습니다

일반적인 문제 / 문제 해결

• "인식되지 않은 파일 형식"과 같은 오류? imagemagic이 설치되어 있는지 확인하십시오.
• 일부 Linux 플랫폼에서는 여분의 플래그가 필요한 것 같습니다. make LDLIBS=-lstdc++fs (그러나 MacOS도 깨뜨립니다) #103을 참조하십시오.
• 이상한 수평선이 보이면 캐릭터가 문자 셀을 완전히 채우지 않습니다. 터미널 앱에서 추가 라인 간격을 제거하십시오
• 잘못된 색? 24 비트 색상 대신 256 개의 컬러 팔레트를 사용하려면 -256을 시도하십시오.
• 이상한 캐릭터? -0을 시도하거나 전체 유니 코드 글꼴 사용을 설치하십시오 (예 : insonsolata 또는 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은 왼쪽 상단을 정의합니다. 호출은 최고의 유니 코드 그래픽 문자와 색상을 검색하여 이미지 의이 셀에 근사하여 Chardata 구조물로 반환합니다.

기여

• 2019-03-26 : 흥미 진진한 주 : @Cabelo는 고정 출력 리디렉션을 보유하고 있으며 @Boretom은 빌드 파일에 교차 컴파일 지원을 추가했으며 @AlandesMet에는 고급 썸네일과 회색체 이미지가 있습니다.
• 2020-07-05 : @CXWX는 고정식 홈 브루 지원을 받았습니다.

Apache 2.0 라이센스에 따라 유용한 기부금을 받아들이게되어 기쁩니다.

• 더 큰 기부금에 투자하기 전에 문제를 사용하여이를 논의하십시오.
• 풀 요청은 가능한 한 "원자"여야합니다. 한 번에 여러 가지 작업을 수행하는 풀 요청을 허용하지 않습니다.
• 이 프로그램은 현재 이미지 처리 라이브러리로서 CIMG 및 Imagemagick에만 의존하며이를 유지하는 것이 좋습니다.
• 추가 플랫폼, CPU 등을 지원하려면 유지 보수에 기꺼이 도와주는 사람, 특히 접근 할 수없는 경우에도 기꺼이 필요합니다.

예

대부분의 예는이 프로그램의 Java 버전으로 촬영되었으며,이 프로그램은 동등한 출력을 가져야하지만 CPU 년에는 Millenia에 의해 느려집니다.

여러 이미지가 파일 이름 사양과 일치하면 썸네일이 표시됩니다.

아래의 예에서, 상단 이미지는 -0 옵션을 통해 비활성화 된 문자 최적화로 생성되었습니다.

라이센스

이 코드는 GPL (3 이상) 또는 Apache 라이센스의 버전 2.0에서 자유롭게 사용할 수 있습니다. CECILL 2.0 (GPL에 가깝고 호환 가능) 또는 [Cecill-C] (https://spdx.org/licenses/cecill-c) (LGPL에 가깝고 APACHE와 호환)에 따라 라이센스가 부여 된 CIMG 라이브러리가 포함됩니다.