.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.14
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sh \" Subsection heading
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  | will give a
.\" real vertical bar.  \*(C+ will give a nicer C++.  Capital omega is used to
.\" do unbreakable dashes and therefore won't be available.  \*(C` and \*(C'
.\" expand to `' in nroff, nothing in troff, for use with C<>.
.tr \(*W-|\(bv\*(Tr
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
'br\}
.\"
.\" If the F register is turned on, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.if \nF \{\
.    de IX
.    tm Index:\\$1\t\\n%\t"\\$2"
..
.    nr % 0
.    rr F
.\}
.\"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.hy 0
.if n .na
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "VBIREC 1"
.TH VBIREC 1 " " "vbirec (C) 2002,2005 Tom Zoerner" "VBI recorder"
.SH "NAME"
vbirec \- TV application interaction monitor and EPG recorder
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
\&\fBvbirec\fR [\ options\ ]
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
\&\fBvbirec\fR is a tool that helps in debugging \s-1TV\s0 application's interaction
with nxtvepg.  \fBvbirec\fR takes the place of nxtvepg in the communication.
It monitors the shared memory which is used for communication with the
\&\s-1TV\s0 app. and displays all \s-1TV\s0 app controlled values in it's main window.
.SH "OPTIONS"
.IX Header "OPTIONS"
Summary of command line options (it's a sub-set of the options
supported by nxtvepg):
.IP "\fB\-geometry\fR \fIgeometry\fR" 4
.IX Item "-geometry geometry"
Specifies the position of the main window, e.g.  \fB\-geometry \-0+0\fR
to put the main window in the upper right corner of the visible screen.
The size of the window cannot be changed.
.IP "\fB\-iconic\fR" 4
.IX Item "-iconic"
Start with the main window iconified (i.e. minimized).
.IP "\fB\-card\fR \fIindex\fR" 4
.IX Item "-card index"
\&\s-1UNIX\s0 only: Specify which tuner card to use, if you have more than one,
for details see nxtvepg manual.  Note this option is not supported on
Windows because there the \s-1TV\s0 application is forwarding teletext data;
on \s-1UNIX\s0 vbirec and nxtvepg are accessing the driver directly.
.IP "\fB\-help\fR" 4
.IX Item "-help"
List all available command line options.
.SH "MONITORING VBI RECEPTION"
.IX Header "MONITORING VBI RECEPTION"
The following shared memory elements are displayed
and updated every 500 millyseconds:
.IP "\fB\s-1TTX\s0 pkg count\fR" 4
.IX Item "TTX pkg count"
The total number of teletext packets the \s-1TV\s0 app. has received since the
last channel change.
.IP "\fB\s-1TTX\s0 pkg per frame avg.\fR" 4
.IX Item "TTX pkg per frame avg."
A running average of the number of \s-1VBI\s0 lines containing teletext packets
per video frame.
.IP "\fB\s-1VPS\s0 lines count\fR" 4
.IX Item "VPS lines count"
The total number of \s-1VPS\s0 lines the \s-1TV\s0 app. has received since the
last channel change.  For networks that transmit \s-1VPS\s0 there should
be one \s-1VPS\s0 line in each frame.
.IP "\fB\s-1EPG\s0 page count\fR" 4
.IX Item "EPG page count"
The number or \s-1EPG\s0 pages since the last channel change, i.e. the number
of teletext packets with packet address zero on the designated \s-1EPG\s0
teletext page.
.IP "\fB\s-1EPG\s0 packet count\fR" 4
.IX Item "EPG packet count"
The total number or teletext packets on the designated \s-1EPG\s0 teletext page
since the last channel change.
.IP "\fB\s-1VPS\s0 \s-1CNI\s0 and \s-1PIL\s0\fR" 4
.IX Item "VPS CNI and PIL"
The last received and confirmed \s-1VPS\s0 network and program identifiers.
\&\s-1VPS\s0 is only used by German, Austrian and Swiss networks.
.IP "\fB\s-1PDC\s0 \s-1CNI\s0 and \s-1PIL\s0\fR" 4
.IX Item "PDC CNI and PIL"
The last received and confirmed \s-1PDC\s0 (teletext packet 8/30/2) network
and program identifiers.  If the network transmits only a network
identifier value of zero, but does include a status display text
(which usually contains channel name and sometimes also the title
of the current programme) it's displayed here instead.
\&\s-1VPS\s0 is mainly used by British and French networks.
.IP "\fBPacket 8/30/1\fR" 4
.IX Item "Packet 8/30/1"
The last received and confirmed packet 8/30/1 network identifier.
If the network transmits only a network identifier value of zero
but does include a status display text it's displayed here instead.
.IP "\fB\s-1EPG\s0 teletext page no\fR" 4
.IX Item "EPG teletext page no"
The teletext page number on which \s-1EPG\s0 is tranmitted according to the
provider.  Note: the default page is 0x1DF; other page numbers can be
specified in the teletext magazine inventory page of each magazine.
.IP "\fBTeletext header\fR" 4
.IX Item "Teletext header"
The text part of the last received teletext packet with address 0.
Usually the text contains the teletext page number, network name,
clock and date.  This element is provided here mainly to allow detecting
which \s-1TV\s0 network was tuned by the \s-1TV\s0 application.
.IP "\fBNetwork by \s-1VPS/PDC/NI\s0\fR" 4
.IX Item "Network by VPS/PDC/NI"
A human readable network identification derived from the \s-1VPS\s0, \s-1PDC\s0 or
P8/30/2 \s-1CNI\s0 codes (in this order, if several alternatives are available).
.SH "MONITORING TV APP CONTROLS"
.IX Header "MONITORING TV APP CONTROLS"
The following shared memory elements are displayed
and updated whenever updates are signalled by the \s-1TV\s0 application:
.IP "\fB\s-1TV\s0 app. channel name\fR" 4
.IX Item "TV app. channel name"
The \s-1TV\s0 application's station name for the currently tuned channel.
This element should be updated after ever channel change.
.IP "\fB\s-1TV\s0 app. channel \s-1CNI\s0\fR" 4
.IX Item "TV app. channel CNI"
The \s-1TV\s0 application's numerical network identifier for the currenlty
tuned channel.  If unavailable it should be set to zero.
.IP "\fB\s-1TV\s0 app. input source\fR" 4
.IX Item "TV app. input source"
The \s-1TV\s0 application's current video input source (0=TV tuner, 1=composite,
2=S\-Video or Composite #2).
.IP "\fB\s-1TV\s0 app. tuner freq.\fR" 4
.IX Item "TV app. tuner freq."
The current \s-1TV\s0 tuner frequency from which \s-1VBI\s0 data is forwarded. This
value must be updated after every channel change.
.IP "\fB\s-1TV\s0 app. grants tuner\fR" 4
.IX Item "TV app. grants tuner"
Boolean flag that indicates if the \s-1TV\s0 application currently honors
the \s-1EPG\s0 application's input source and tuner frequency requests.
The \s-1TV\s0 application should grant the tuner when video capturing is
disabled of the \s-1TV\s0 window minimized or completely obscured by other
windows.
.SH "TV APP INTERACTION"
.IX Header "TV APP INTERACTION"
The following dialog section allows to send requests to a connected
\&\s-1TV\s0 application.
.IP "\fBSend \s-1EPG\s0 Information to \s-1OSD\s0\fR" 4
.IX Item "Send EPG Information to OSD"
You can enter a programme title, start time, duration and date offset
which is sent to the \s-1TV\s0 app when you press the \fISend\fR button.
The \s-1TV\s0 app should display the data on-screen (\s-1OSD\s0) 
When you don't enter a time and date, \fIvbirec\fR invents start and
stop times by itself: start is the last full hour, duration 60 minutes.
.IP "\fBSend \s-1TV\s0 Control Command\fR" 4
.IX Item "Send TV Control Command"
You can enter a command and press \fISend\fR to pass it to the \s-1TV\s0 app.
Command arguments are separated by blanks (there's currently no way
to escape possible blanks inside command arguments)
.Sp
Which commands are supported depends on the \s-1TV\s0 application.  At minimum
they should support command \*(L"setstation\*(R" with a network name as argument.
A list of commands which are used by nxtvepg is available in the
drop-down menu below the command entry field.
.SH "EPG RECORDING"
.IX Header "EPG RECORDING"
Packets received on the designated \s-1EPG\s0 teletext page can be stored
into a file for later playback by \fBvbiplay\fR.  The intended use is
to allow me debugging decoding errors, e.g. for providers that I
cannot receive at my location.
.PP
The name of the output file is specified by the entry field at the
bottom of the window.  The file is created as soon as recording is
enabled by checking the \fIEnable teletext recorder\fR button.
.SH "FILES"
.IX Header "FILES"
.IP "\fBttx.dat\fR" 4
.IX Item "ttx.dat"
Default output file name for recorded teletext packets.
.IP "\fBvbi_map.dat\fR" 4
.IX Item "vbi_map.dat"
This hidden file is used to set up shared memory to allow information
exchange between vbirec and an attached \s-1TV\s0 application.  It's
automatically removed when vbirec terminates and should never be
accessed (i.e. being written to or removed) by external applications.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
See also the manuals for \fBnxtvepg\fR, \fBtvsim\fR and \fBvbiplay\fR.
.SH "AUTHOR"
.IX Header "AUTHOR"
Th. \*(L"Tom\*(R" Zoerner, Nuremberg, Germany.
.PP
Email: tomzo (at) users (dot) sourceforge (dot) net
.SH "COPYRIGHT"
.IX Header "COPYRIGHT"
Copyright (C) 2002,2004 by Th. 'Tom' Zoerner.
All rights reserved.
.PP
This program is free software; you can redistribute it and/or modify
it under the terms of the \s-1GNU\s0 General Public License Version 2 as
published by the Free Software Foundation, e.g. at
http://www.fsf.org/
.PP
This program is distributed in the hope that it will be useful, but
\&\fB\s-1WITHOUT\s0 \s-1ANY\s0 \s-1WARRANTY\s0\fR; without even the implied warranty of
merchantability or fitness for a particular purpose. See the
file \fI\s-1COPYRIGHT\s0\fR for more details.