Manpage of hasciicam
Section: User Commands (1)
Updated: July 16, 2001
Return to Main Contents
hasciicam - (h)ascii for the masses!
[ -hvq ]
[ -m mode ]
[ -d device ]
[ -i input ]
[ -n norm ]
[ -s size ]
[ -o output ]
[ -f :user%pass@host:/dir ]
[ rendering-options ]
makes it possible to have live asciivideo on the web. It takes video from a capture device (like tv cards or quickcams) and renders it into ascii, formatting the output into an html page with a refresh tag or in a live ascii window or in a simple text file as well, giving the possiblity to publish on the web a live asciivideo feed browsable without any need for browser's plugins.
grabs frames using Video4Linux api, renders them into ascii using AA-lib engine and is capable of armoring them with auto-refreshing
code. It's being used also jpeglib for optionally refresh a small jpeg image, so that it can work also as a simple webcam (or showing both, jpeg and asciivideo).
Display a help text and quit.
Display version and quit.
Be quiet and don't show hardware detection.
Selects the mode in wich hasciicam will run:
- -h --help
live will use the console (or eventually open one under X display) to show full speed ascii video.
html will write html formatted ascii video every refresh seconds into file aafile.
text will write plain text ascii video every refresh seconds into file aafile.
Default mode is live. Mode selection is XOR'ed.
Use specified capture device. Default is /dev/video.
Selects the device's input channel to be used for grabbing frames. Default is 1.
Selects video format to be used on tuner: pal | ntsc | secam | auto. Default is auto.
Sets rendered ascii frames size to WxH characters. Grabbed frame size is computed from this value, resulting into (W<<1)x(H<<1). Default is 96x72, or the minimum grabbing size supported by the device if greater.
Defines the file where to save rendered ascii, overwrited every refresh seconds. Default is hasciicam.html when in html mode, hasciicam.txt when in text mode (unuseful when in live mode).
Ftp pushes the selected output file to an ftp account specified within an expression like :email@example.com:/home/user/www. If the password is not specified (omit %pass) hasciicam asks for it on stdin (hidden while typing). If the directory is not specified it is assumed to be the first ftp directory where user logs in. Remote file is refreshed depending on refresh rate and connection bandwidth, a scolopendro temporary file is created to keep clients on the other side refreshing smooth.
Forks to background and runs in daemon mode.
Selects a font size from 1 to 4 used in html rendering. default is 1 (only useful when in html mode).
Selects a font face to be used in html rendering, it should be fixed size for better results. default is courier (only useful when in html mode).
Specifies the refresh interval in seconds between each grabbed frame. Default is 2 (unuseful when in live mode).
Specifies brightness level for the aa_render, from 0 to 100. Default is 50.
Specifies contrast level for the aa_render, from 0 to 100. Default is 10.
Specifies gamma correction level for the aa_render, from 0 to 100. Default is 10.
Invert and render the resulting negative ascii.
Specifies the background color to be used in the form of a hex RGB triplet (without the leading #). Default is 000000 for black (only useful when in html mode).
Specifies the foreground color to be used in the form of a hex RGB triplet (without the leading #). Default is 00FF00 for green (only useful when in html mode).
- -S --font-size
hasciicam -m html -o watchme.html
puts your html formatted ascii into watchme.html
hasciicam -m text -s79x24 -o ~/.plan
puts your ascii into your local .plan (fingercam)
hasciicam -m html -S 2 -o index.html -f :firstname.lastname@example.org:korova
generates an hascii video with font size +1 and uploads the frames in ftp passive mode on the dyne.org server, with user jaromil password sasuchen, inside the korova directory
When using a usb webcam, a supported size needs to be specified. The minimum or maximum detected size should work, also a size of 160x120 mostly gives good results, with unsupported sizes you will get unexpected results.
Report bugs to email@example.com. Please include a complete, self-contained example that will allow the bug to be reproduced, informations about which version of hasciicam you are using, which operative system and the complete device detection output.
jaromil [aka Denis Roio] <firstname.lastname@example.org>
Copyright (c) 2001 email@example.com
Permission is granted to copy, distribute and/or modify this manual under the terms of the GNU Free Documentation License, Version 1.1 or any later version published by the Free Software Foundation; with the Invariant Sections being NAME, SYNOPSIS, DESCRIPTION, AUTHOR and with the Front-Cover Texts including "hasciicam - (h)ascii for the masses! - manual pages". Permission is granted to make and distribute verbatim copies of this manual page provided the above copyright notice and this permission notice are preserved on all copies.
The most recent version of hasciicam sourcecode is always available for download from http://ascii.dyne.org.
- SEE ALSO
This document was created by
using the manual pages.
Time: 12:01:35 GMT, December 14, 2003