.\" $Id: vtxget.1.in,v 1.5 1999/10/04 22:58:50 mb Exp mb $ .TH vtxget 1 "Version 0.6.19991029" VideoteXt .SH NAME vtxget \- videotext-decoder for non-interactive usage .SH SYNOPSIS .B vtxget .RI [ options ] .IR page... | file... .SH DESCRIPTION \fIvtxget\fP is a frontend for videotext-interfaces which is intended mainly for non-interactive usage. Nevertheless it can also be used in a (rather primitive) interactive mode, in case you aren't able to run the X11/XView version of \fIVideoteXt\fP. Instead of reading the videotext-pages from a videotext-interface, \fIvtxget\fP can also be used as a filter to convert pages stored in its native format. \fIvtxget\fP is able to write the videotext pages in a variety of output formats which should be suitable for all kinds of post-processing. .PP In normal mode, you give the page-numbers to search for on the commandline (see \fBPAGE SYNTAX\fP below). Instead of page-numbers, you can also use \fB-\fP as a single argument, which causes \fIvtxget\fP to read the page-numbers to search for from \fBstdin\fP until it encounters the keyword \fBexit\fP. To control \fIvtxget\fP from another process, create a named pipe and redirect \fIvtxget's\fP \fBstdin\fP from it. Then the page-requests written to the named pipe will be served as soon as a data acquisition unit becomes available. .PP To use \fIvtxget\fP as a filter to convert videotext-pages, use the \fB-v\fP option and pass the files to convert as arguments on the commandline. .SH OPTIONS .IP "\fB-t\fP \fItimeout\fP" Set timeout for pages in seconds. Valid \fItimeout\fP-values are greater or equal 0, where 0 means infinity. The default is 60 seconds. When searching for multiple subpages, the timeout for the current pages is doubled automatically after the first subpage was found. .IP "\fB-i\fP \fIinterleave\fP" Set TOP-text interleave value or enable interleaving if no TOP-text is available. Valid \fIinterleave\fP-values range from -100 to 100, the default is 20. .IP "\fB-h\fP" Also output page-header and status bits. .IP "\fB-r\fP" Reveal hidden parts of pages. .IP "\fB-f\fP \fBiso\fP|\fBansi\fP|\fBtext\fP|\fBvtx\fP|\fBppm\fP|\fBgif\fP|\fBgifint\fP|\fBpng\fP|\fBpngint\fP|\fBps\fP|\fBips\fP|\fBcps\fP" \fBiso\fP selects text-output with ISO-latin1 charset. \fBansi\fP uses the same charset as \fBiso\fP but outputs additional escape-codes to change colors. \fBtext\fP replaces control characters with tokens (see \fBCONTROL SEQUENCES\fP below). \fBvtx\fP selects the native \fIvtxget\fP format that can also be read by \fIvideotext\fP. \fBppm\fP, \fBgif\fP, \fBgifint\fP, \fBpng\fP and \fBpngint\fP are bitmap formats, where \fBgifint\fP writes interlaced GIF89a files and \fBpngint\fP write interlaced PNG files. \fBps\fP, \fBips\fP and \fBcps\fP select standard, inverted and color PostScript. EPSF will be generated automatically when not writing to \fBstdout\fP (i.e. when output-files will contain only single videotext-pages). .IP "\fB-F\fP \fIx\fP\fBx\fP\fIy\fP" Use \fIx\fP\fBx\fP\fIy\fP pixel font when writing bitmap files. .IP "\fB-o\fP \fIdir\fP" Write output files to directory \fIdir\fP instead of \fBstdout\fP. .IP "\fB-p\fP \fIprefix\fP" Set prefix for output filenames. .IP "\fB-T\fP" Dump TOP-text information to \fBstdout\fP or file \fBtoptext\fP in directory given with \fB-o\fP. .IP "\fB-V\fP" Also write virtual rows when saving pages in videotext-format .IP "\fB-a\fP \fBa4\fP|\fBa3\fP|\fBletter\fP|\fBlegal\fP" Set papertype for PostScript-output .IP "\fB-n\fP \fIx\fP\fBx\fP\fIy\fP[\fBl\fP[\fBandscape\fP]]" Put \fIx\fP\fBx\fP\fIy\fP videotext-pages on one output-page when writing PostScript-files and optionally use \fBlandscape\fP format .IP "\fB-s\fP" Separate output-pages when writing PostScript-files to \fBstdout\fP. .IP "\fB-c\fP" Don't clear hardware-cache on videotext-interface (if available) .IP "\fB-v\fP" Display pages read from files instead of videotext-device .IP "\fB-D\fP \fIdevice\fP" Override default filename for videotext device-file .IP "\fB-P\fP \fIpath\fP" Override default search path for videotext-fonts .IP "\fB-\e?\fP" Show available \fIvtxget\fP-options .SH "PAGE SYNTAX" Page numbers may be specified with the following syntax: .IP "\fIx\fP" Get next subpage of page \fIx\fP (valid range for \fIx\fP is 100-8FF) .IP "\fIx\fP\fB.\fP\fIy\fP" Get subpage \fIy\fP of page \fIx\fP (valid range for \fIy\fP is 1-7F) .IP "\fIx\fP\fB.0\fP" Get all available subpages of page \fIx\fP .IP "\fIx\fP\fB.l\fP" Keep searching for page \fIx\fP until timeout occurs or \fIvtxget\fP gets killed .IP "\fIx\fP\fB-\fP\fIy\fP" Get next subpage of all pages in range \fIx\fP-\fIy\fP. If either \fIx\fP or \fIy\fP is hexadecimal, include all hexadecimal pages in given range. .IP "\fIx\fP\fB.0-\fP\fIy\fP" Get all subpages of all pages in range \fIx\fP-\fIy\fP .PP You can also use one of the following keywords to search for all pages in the specified category. The station must broadcast TOP-text for this to work: .IP "\fBallnorm\fP" Get all normal pages (no subpages) .IP "\fBallsub\fP" Get all subpages (no normal pages) .IP "\fBall\fP" Get all pages (normal and subpages) .SH "CONTROL SEQUENCES" When using the \fBtext\fP output format, \fIvtxget\fP replaces the videotext control- and graphics characters by the following tokens (surrounded by curly braces): .IP "\fBAL_\fIcolor\fP, \fBGR_\fIcolor\fP" Select color \fIcolor\fP and switch to alphanumerics (\fBAL_\fP) or graphics (\fBGR_\fP) mode. \fIcolor\fP may be one of \fBBLACK\fP, \fBRED\fP, \fBGREEN\fP, \fBYELLOW\fP, \fBBLUE\fP, \fBMAGENTA\fP, \fBCYAN\fP or \fBWHITE. .IP "\fBBG_BLACK\fP" Set background color to black. .IP "\fBBG_NEW\fP" Set background color to current foreground color. .IP "\fBFLASH_ON\fP, \fBFLASH_OFF\fP" Turn flashing on or off. .IP "\fBGR_CONT\fP, \fBGR_SEP\fP" Select continuous or seperated mode for graphics characters. .IP "\fBHEIGHT_NORM\fP, \fBHEIGHT_DBL\fP" Select normal or double height characters. .IP "\fBGR_HOLD\fP, \fBGR_RELEASE\fP" Start or stop repeating the last graphics character. .IP "\fBBOX_START\fP, \fBBOX_END\fP" Begin or end of opaque box (used for insert-mode). .IP "\fBCONCEAL\fP" Beginning of concealed section. .IP "\fBSO\fP, \fBSI\fP, \fBESC\fP" These correspond to the videotext-codes with the same names. I have no idea what purpose they serve. .SH FILES .IP "\fB/dev/vtx\fP" Default device-file to access locally attached videotext-interface .IP "\fB/usr/X11R6/lib/X11/vtx\fP" Default directory for videotext-fonts .SH ENVIRONMENT .IP "\fBVTX_DEVICE\fP" Overrides default filename for videotext device-file .IP "\fBVTX_FONTPATH\fP" Overrides default search path for videotext-fonts .SH BUGS GIF- and PNG-support are compile-time options, so they might not be available in every binary version. .SH AUTHOR Martin Buck .PP The lastest releases, beta-versions and news about \fIVideoteXt\fP can always be found on \fBhttp://home.pages.de/~videotext/\fP. .SH "SEE ALSO" .BR videotext (1), .BR tunerctl (1)