bb(1) [debian man page]

BB(1)							      General Commands Manual							     BB(1)

NAME

       bb - an ASCII-art demo

SYNOPSIS

       bb [options]

DESCRIPTION

       bb is a high quality audio-visual demonstration for your text terminal.

OPTIONS

       A summary of options are included below.  For a complete description type bb -help.

       -help  Show summary of options.

       -loop  Play demo in infinite loop.

       -driver
	      Select driver. Available drivers: linux, slang, X11, stdout, stderr.

       -kbddriver
	      Select keyboard driver. Available drivers: slang, X11, stdin.

       -mousedriver
	      Select mouse driver. Available drivers: X11, gpm, dos.

       -width Set width.

       -height
	      Set height.

       -minwidth
	      Set minimum width.

       -minheight
	      Set minimum height.

       -maxwidth
	      Set maximum width.

       -maxheight
	      Set maximum height.

       -recwidth
	      Set recommended width.

       -recheight
	      Set recommended height.

       -dim   Enable usage of dim (half bright) attribute.

       -bold  Enable usage of bold (double bright) attribute.

       -reverse
	      Enable usage of reverse attribute.

       -normal
	      Enable usage of normal attribute.

       -boldfont
	      Enable usage of boldfont attribute.

       -no<attr>
	      Disable attribute (i.e -nobold).

       -extended
	      Use all 256 characters.

       -eight Use eight bit ASCII.

       -font <font>
	      Select  font.  This  option  is  used  on hardware where aalib is unable to determine the current font. Available fonts: vga8, vga9,
	      mda14, vga14, X8x13, X8x16, X8x13bold, vgagl8, line.

       -inverse
	      Enable inverse rendering.

       -noinverse
	      Disable inverse rendering.

       -bright <val>
	      Set brightness (0-255).

       -contrast <val>
	      Set contrast (0-255).

       -gamma <val>
	      Set gamma correction value (0-1).

       -nodither
	      Disable dithering.

       -floyd_steinberg
	      Floyd-Steinberg dithering.

       -error_distribution
	      Error distribution dithering.

       -random <val>
	      Set random dithering value (0-inf).

       -dimmul <val>
	      Multiply factor for dim attribute (5.3).

       -boldmul <val>
	      Multiply factor for bold attribute (2.7).

BUGS

       Please report any bugs you find to Jan Hubicka <hubicka@freesoft.cz>.

LICENCE

       bb is covered by the GNU General Public License (GPL).

SEE ALSO

       aafire(1), aainfo(1), aasavefont(1), aatest(1), aview(1), asciiview(1), aaflip(1), aa3d(1), xaos(6), aatv(1).

AUTHOR

       Jan Hubicka <hubicka@freesoft.cz>

       This manual page was written by Michael Bramer <grisu@debian.org>, for the Debian GNU/Linux system (but may be used by others).

								 December 16, 2001							     BB(1)

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 (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)