Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
img2txt(1)		     General Commands Manual		      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 (de-
	    fault 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)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=img2txt&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help