| 1 |
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" |
| 2 |
"http://www.w3.org/TR/html4/loose.dtd"> |
| 3 |
<html><head> |
| 4 |
<title>hasciicam man page</title> |
| 5 |
<meta name="generator" content="roffit 0.7"> |
| 6 |
<STYLE type="text/css"> |
| 7 |
P.level0 { |
| 8 |
padding-left: 2em; |
| 9 |
} |
| 10 |
|
| 11 |
P.level1 { |
| 12 |
padding-left: 4em; |
| 13 |
} |
| 14 |
|
| 15 |
P.level2 { |
| 16 |
padding-left: 6em; |
| 17 |
} |
| 18 |
|
| 19 |
span.emphasis { |
| 20 |
font-style: italic; |
| 21 |
} |
| 22 |
|
| 23 |
span.bold { |
| 24 |
font-weight: bold; |
| 25 |
} |
| 26 |
|
| 27 |
span.manpage { |
| 28 |
font-weight: bold; |
| 29 |
} |
| 30 |
|
| 31 |
h2.nroffsh { |
| 32 |
background-color: #e0e0e0; |
| 33 |
} |
| 34 |
|
| 35 |
span.nroffip { |
| 36 |
font-weight: bold; |
| 37 |
font-size: 120%; |
| 38 |
font-family: monospace; |
| 39 |
} |
| 40 |
|
| 41 |
p.roffit { |
| 42 |
text-align: center; |
| 43 |
font-size: 80%; |
| 44 |
} |
| 45 |
</STYLE> |
| 46 |
</head><body> |
| 47 |
|
| 48 |
<p class="level0"><a name="NAME"></a><h2 class="nroffsh">NAME</h2> |
| 49 |
<p class="level0">hasciicam - (h)ascii for the masses! <a name="SYNOPSIS"></a><h2 class="nroffsh">SYNOPSIS</h2> |
| 50 |
<p class="level0"><span Class="bold">hasciicam</span> [ fB-hvqfR ] [ fB-m fImodefR ] [ fB-d fIdevicefR ] [ fB-i fIinputfR ] [ fB-o fIoutputfR ] [ fB-f fI:user%pass@host:/dirfR ] [ fBrendering-optionsfR ] <a name="DESCRIPTION"></a><h2 class="nroffsh">DESCRIPTION</h2> |
| 51 |
<p class="level0"><span Class="bold">hasciicam</span> 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 fBhtml pagefP with a refresh tag or in a fBlive asciifP window or in a simple fBtext filefP as well, giving the possiblity to publish on the web a live asciivideo feed browsable without any need for browser's plugins. |
| 52 |
<p class="level0"><span Class="bold">hasciicam</span> grabs frames using fBVideo4LinuxfP api, renders them into ascii using fBAA-libfP engine and is capable of armoring them with auto-refreshing |
| 53 |
<p class="level0">code. It's being used also fBjpeglibfP for optionally refresh a small jpeg image, so that it can work also as a simple webcam (or showing both, jpeg and asciivideo). <a name="OPTIONS"></a><h2 class="nroffsh">OPTIONS</h2> |
| 54 |
<p class="level0"><span Class="bold"></span> |
| 55 |
<p class="level0"><a name="-h"></a><span class="nroffip">-h --help</span> |
| 56 |
<p class="level1">Display a help text and quit. <span Class="bold"></span> |
| 57 |
<p class="level0"><a name="-v"></a><span class="nroffip">-v --version</span> |
| 58 |
<p class="level1">Display version and quit. <span Class="bold"></span> |
| 59 |
<p class="level0"><a name="-q"></a><span class="nroffip">-q --quiet</span> |
| 60 |
<p class="level1">Be quiet and don't show hardware detection. <span Class="bold"></span> |
| 61 |
<p class="level0"><a name="-m"></a><span class="nroffip">-m --mode</span> |
| 62 |
<p class="level1">Selects the mode in wich hasciicam will run: |
| 63 |
<p class="level1"><span Class="bold">live will use the console (or eventually open one under X display) to show full speed ascii video.</span> |
| 64 |
<p class="level1"><span Class="bold">html will write html formatted ascii video every refresh seconds into file aafile.</span> |
| 65 |
<p class="level1"><span Class="bold">text will write plain text ascii video every refresh seconds into file aafile.</span> |
| 66 |
<p class="level1">Default mode is fBlivefP. Mode selection is XOR'ed. <span Class="bold"></span> |
| 67 |
<p class="level0"><a name="-d"></a><span class="nroffip">-d --device</span> |
| 68 |
<p class="level1">Use specified capture device. Default is fB/dev/videofP. <span Class="bold"></span> |
| 69 |
<p class="level0"><a name="-i"></a><span class="nroffip">-i --input</span> |
| 70 |
<p class="level1">Selects the fBdevicefP's input channel to be used for grabbing frames. Default is fB1fP. <span Class="bold"></span> |
| 71 |
<p class="level0"><a name="-o"></a><span class="nroffip">-o --aafile</span> |
| 72 |
<p class="level1">Defines the file where to save rendered ascii, overwrited every fIrefreshfP seconds. Default is fBhasciicam.htmlfP when in fBhtmlfP mode, fBhasciicam.txtfP when in fBtextfP mode (useless when in fBlivefP mode). <span Class="bold"></span> |
| 73 |
<p class="level0"><a name="-f"></a><span class="nroffip">-f --ftp</span> |
| 74 |
<p class="level1">Ftp pushes the selected output file to an ftp account specified within an expression like fB:user%[email protected]:/home/user/wwwfP. 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 fBrefreshfP rate and connection bandwidth, a fIscolopendrofP temporary file is created to keep clients on the other side refreshing smooth. <span Class="bold"></span> |
| 75 |
<p class="level0"><a name="-D"></a><span class="nroffip">-D --daemon</span> |
| 76 |
<p class="level1">Forks to background and runs in daemon mode. |
| 77 |
<p class="level1"><a name="RENDERING-OPTIONS"></a><h2 class="nroffsh">RENDERING-OPTIONS</h2> |
| 78 |
<p class="level0"><span Class="bold"></span> |
| 79 |
<p class="level0"><a name="-S"></a><span class="nroffip">-S --font-size</span> |
| 80 |
<p class="level1">Selects a font size from fB1fP to fB4fP used in html rendering. default is fB1fP (only useful when in fBhtmlfP mode). <span Class="bold"></span> |
| 81 |
<p class="level0"><a name="-a"></a><span class="nroffip">-a --font-face</span> |
| 82 |
<p class="level1">Selects a font face to be used in html rendering, it should be fixed size for better results. default is fBcourierfP (only useful when in fBhtmlfP mode). <span Class="bold"></span> |
| 83 |
<p class="level0"><a name="-r"></a><span class="nroffip">-r --refresh</span> |
| 84 |
<p class="level1">Specifies the refresh interval in seconds between each grabbed frame. Default is fB2fP (useless when in fBlivefP mode). <span Class="bold"></span> |
| 85 |
<p class="level0"><a name="-b"></a><span class="nroffip">-b --aabright</span> |
| 86 |
<p class="level1">Specifies brightness level for the aa_render, from 0 to 100. Default is fB60fP. <span Class="bold"></span> |
| 87 |
<p class="level0"><a name="-c"></a><span class="nroffip">-c --aacontrast</span> |
| 88 |
<p class="level1">Specifies contrast level for the aa_render, from 0 to 100. Default is fB4fP. <span Class="bold"></span> |
| 89 |
<p class="level0"><a name="-g"></a><span class="nroffip">-g --aagamma</span> |
| 90 |
<p class="level1">Specifies gamma correction level for the aa_render, from 0 to 100. Default is fB3fP. <span Class="bold"></span> |
| 91 |
<p class="level0"><a name="-I"></a><span class="nroffip">-I --invert</span> |
| 92 |
<p class="level1">Invert and render the resulting negative ascii. <span Class="bold"></span> |
| 93 |
<p class="level0"><a name="-B"></a><span class="nroffip">-B --background</span> |
| 94 |
<p class="level1">Specifies the background color to be used in the form of a fIhex RGB tripletfR (without the leading #). Default is fB000000fP for black (only useful when in fBhtmlfP mode). <span Class="bold"></span> |
| 95 |
<p class="level0"><a name="-F"></a><span class="nroffip">-F --foreground</span> |
| 96 |
<p class="level1">Specifies the foreground color to be used in the form of a fIhex RGB tripletfR (without the leading #). Default is fB00FF00fP for green (only useful when in fBhtmlfP mode). <a name="EXAMPLES"></a><h2 class="nroffsh">EXAMPLES</h2> |
| 97 |
<p class="level0"><span Class="bold">hasciicam -m html -o watchme.html</span> |
| 98 |
<p class="level0">puts your fIhtmlfP formatted ascii into watchme.html - then just open it with your favourite browser. |
| 99 |
<p class="level0"><span Class="bold">hasciicam -m text -o ~/.plan</span> |
| 100 |
<p class="level0">puts your ascii into your local .plan (fingercam) <span Class="bold">hasciicam -m html -S 2 -o index.html -f :jaromil%[email protected]:korova</span> |
| 101 |
<p class="level0">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 <a name="NOTES"></a><h2 class="nroffsh">NOTES</h2> |
| 102 |
<p class="level0">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. <a name="BUGS"></a><h2 class="nroffsh">BUGS</h2> |
| 103 |
<p class="level0">Report bugs to [email protected]. Please include a complete, self-contained example that will allow the bug to be reproduced, information about which version of hasciicam you are using, which operative system and the complete device detection output. <a name="AUTHOR"></a><h2 class="nroffsh">AUTHOR</h2> |
| 104 |
<p class="level0">jaromil [aka Denis Roio] <[email protected]> <a name="COPYING"></a><h2 class="nroffsh">COPYING</h2> |
| 105 |
<p class="level0">Copyright (c) 2001-2006 Denis Roio <[email protected]> |
| 106 |
<p class="level0">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. 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. <a name="AVAILABILITY"></a><h2 class="nroffsh">AVAILABILITY</h2> |
| 107 |
<p class="level0">The most recent version of hasciicam sourcecode and up to date documentation is always available for download from fI<a href=".">http://ascii.dyne.orgf</a>R. <a name="SEE"></a><h2 class="nroffsh">SEE ALSO</h2> |
| 108 |
<p class="level0">info aalib <p class="roffit"> |
| 109 |
This HTML page was made with <a href="http://daniel.haxx.se/projects/roffit/">roffit</a>. |
| 110 |
</body></html> |