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 as-
       pect  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 ac-
       count.

       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+14.3.quarterly>

home | help