Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   14563 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

img2txt(1)							    img2txt(1)

NAME
       img2txt - convert images to various text-based coloured files

SYNOPSIS
       img2txt [ -W width ] [ -H height ] [ -x font-width ] [ -y font-height ]
	       [ -b brightness ] [ -c contrast ] [ -g gamma ]
	       [ -d dither ] [ -f format ] FILE

DESCRIPTION
       img2txt	converts images to colour ASCII characters and outputs them to
       text-based coloured files.

       img2txt can load the most widespread image  formats:  PNG,  JPEG,  GIF,
       PNG, BMP etc (see NOTES for details).  By default the output text is 60
       columns wide, and the line count is  computed  accordingly  to  respect
       aspect  ratio  of original file.	 The default output format is standard
       ANSI coloured text.

OPTIONS
       -W, --width=<width>
	      Change output column count. If not given, the default is set  to
	      60.

       -H, --height=<height>
	      Change  output  line count. If not given, the height is computed
	      to match correct aspect ratio.

       -x, --font-width=<width>
	      Change output font width. If not given, the default is set to 6.
	      This value will be used for computing aspect ratio.

       -y, --font-height=<height>
	      Change  output  font height. If not given, the default is set to
	      10. This value will be used for computing aspect ratio.

       -b, --brightness=<brightness>
	      Change image brightness. Default to 1.0.

       -c, --contrast=<contrast>
	      Change image contrast. Default to 1.0.

       -g, --gamma=<gamma>
	      Change image gamma. Default to 1.0.

       -d, --dither=<dither>
	      Change dithering algorithm. This can be  one  of	the  following
	      (default to fstein) :
		none	 : Nearest color
		ordered2 : Ordered 2x2
		ordered4 : Ordered 4x4
		ordered8 : Ordered 8x8
		random	 : Random
		fstein	 : Floyd Steinberg

       -f, --format=<format>
	      Change  output format. This can be one of the following (default
	      to ansi) :
		ansi   : coloured ANSI
		caca   : internal libcaca format
		utf8   : UTF8 with CR
		utf8cr : UTF8 with CRLF (MS Windows)
		html   : HTML with CSS and DIV support
		html3  : Pure HTML3 with tables
		irc    : IRC with ctrl-k codes
		bbfr   : BBCode (French)
		ps     : Postscript
		svg    : Scalable Vector Graphics
		tga    : Targa Image

       -h, --help
	      Display help message and exit.

       -v, --version
	      Display version of the program and exit.

EXAMPLES
       img2txt hello.jpg > hello.ans

       img2txt --width=40 --format=svg hello.jpg > tinyhello.svg

NOTES
       Setting both column and line count (using --width  and  --height)  will
       let  you	 choose	 the  exact output size without taking aspect ratio in
       account.

       You must compile libcaca package with support of Imlib2 to be  able  to
       load  a wide variety of image formats. Otherwise you will only  be able
       to load regular BMP files.

SEE ALSO
       cacaview(1)

AUTHOR
       This manual page was written by Sam Hocevar <sam@hocevar.net> and Jean-
       Yves Lamoureux <jylam@lnxscene.org>.

libcaca				  2007-11-07			    img2txt(1)

                             _         _         _ 
                            | |       | |       | |     
                            | |       | |       | |     
                         __ | | __ __ | | __ __ | | __  
                         \ \| |/ / \ \| |/ / \ \| |/ /  
                          \ \ / /   \ \ / /   \ \ / /   
                           \   /     \   /     \   /    
                            \_/       \_/       \_/ 

Vote for polarhome