.TH NVTV "1x" "March 2002" "User Commands" "User Commands"
.SH NAME
nvtv \(em GUI to control TV output hardware settings
.SH DESCRIPTION
nvtv is a small utility to control the output modes of TV-OUT encoders on many
Nvidia-based video cards, as well as on the Voodoo3 video card. Use this with 
care, you may damage your hardware with a wrong set of options! You can find 
more detailed descritiptions of each option in the file 
.B /usr/share/doc/nvtv/USAGE.gz .
.SH OPTIONS
.TP
\fB\-h\fR \fB\-\-help\fR
Print help message
.TP
\fB\-\-display\fR hst:#
X server to contact
.TP
\fB\-m\fR \fB\-\-tv\-off\fR
TV off, switch to monitor
.TP
\fB\-t\fR \fB\-\-tv\-on\fR
TV on
.TP
\fB\-b\fR \fB\-\-tv\-bars\fR
Color bars
.TP
\fB\-p\fR \fB\-\-print\fR
Calculate and print register values
.TP
\fB\-F\fR \fB\-\-fetch\fR
Fetch current mode (use only for printing)
.TP
\fB\-l\fR \fB\-\-list\fR
List available modes on stdout. Must be combined with \-T if hardware is
not accessible. Can be combined with \-S. Fields are separated by
tabs, and contain TV system, resolution, size, overscan compenstation
percentage, and aspect in that order.
.TP
\fB\-r\fR \fB\-\-resolution\fR x,y
Select resolution (screen size in pixels)
.TP
\fB\-o\fR \fB\-\-overscan\fR x,y
Select overscan compensation percentage (as float)
.TP
\fB\-s\fR \fB\-\-size\fR #
Select size (for predefined modes)
.TP
\fB\-S\fR \fB\-\-system\fR
NTSC,NTSC-J,PAL,PAL-60,PAL-NC,PAL-M,PAL-M60,PAL-X,SECAM

Select the TV system. PAL-X is a pseudo-PAL system with slightly different
subcarrier frequencies.
.TP
\fB\-C\fR \fB\-\-connector\fR
AUTO, COMPOSITE, SVIDEO, BOTH, CONVERT

Select the video connecter. CONVERT compensates for cheap SVideo to
composite converter cables that don't merge both lines. FBAS and SVHS
are still recognized for compatibility reasons.
.TP
\fB\-T\fR \fB\-\-chip\fR <encoder type> or <bus>:<addr>
Select the encoder chip by I2C bus and address, or by type 
(BROOKTREE, CONEXANT, NVIDIA, CHRONTEL1,C HRONTEL2, PHILIPS1, PHILIPS2).
CHRONTEL and PHILIPS default to CHRONTEL1 and PHILIPS1.
.TP
\fB\-A\fR \fB\-\-card-addr\fR <bus>:<slot>.<func>
Graphics card pci address (hexadecimal), as given by lspci.
.TP
\fB\-W\fR \fB\-\-win\-id\fR id
Select window by numerical id
.TP
\fB\-w\fR \fB\-\-win\-name\fR name
Select window by name
.TP
\fB\-c\fR \fB\-\-center\fR
Center selected window
.TP
\fB\-X\fR \fB\-\-switch\-mode\fR
Switch X mode
.TP
\fB\-1\fR 
Use first head
.TP
\fB\-2\fR 
Use second head (if available)
.TP
\fB\-q\fR \fB\-\-query\fR
Query status of display (monitor, TV, flatpanel)
.TP
\fB\-P\fR \fB\-\-probe\fR
Probe and print system information
.TP
\fB\-N\fR \fB\-\-nvdev\fR
Enable usage of /dev/nv* devices
.TP
\fB\-g\fR \fB\-\-gui\fR
Always use gui
.TP
\fB\-n\fR \fB\-\-no\-root\fR
(only for debugging)
.TP
\fB\-d\fR \fB\-\-debug\fR
(only for debugging)
.TP
\fB\-\-set\fR name:val    
Specify the setting \fIname\fR with value \fIval\fR (see below). 

.SH SETTINGS

A complete list of all available settings can be obtained with the
option \fB\-h\fR. The values may be adjusted according to the
capabilities of the TV encoder chip, and not all encoders support all
settings. Also, equal values may have different effects for
different encoder chips.

Settings include

.TP
.B Contrast
from \-100 (percent) to 100 (percent).
.TP
.B Saturation
from \-100 (percent) to 100 (percent).
.TP
.B Brightness#
from \-50 (percent) to 50 (percent). This setting and the two following
settings change the TV signal directly and should be used carefully.
Extreme values may degrade the signal up to the point where it cannot be
properly displayed anymore.
.TP
.B Contrast#
from \-50 (percent) to 50 (percent).
.TP
.B Saturation#
from \-50 (percent) to 50 (percent).
.TP
.B Phase
from \-60 (degrees) to 60 (degrees).
.TP
.B Hue
from \-60 (degrees) to 60 (degrees).
.TP
.B Flicker
Flicker filter, from 0 (percent) to 100 (percent).
.TP
.B AdaptFlicker
Adaptive flicker filter, from 0 (percent) to 100 (percent).
.TP
.B LumaBandwidth
Bandwidth filter for the luminance channel, from 0 (percent) to 100 (percent).
Larger bandwidth gives more horizontal detail, but is also more sensitive
to noise.
.TP
.B ChromaBandwidth
Bandwidth filter for the chrominance channel, 
from 0 (percent) to 100 (percent).
.TP
.B Sharpness
Sharpness (or text enhancement) filter, from 0 (percent) to 100 (percent).
.TP
.B CrossColor
Cross color reduction filter, from 0 (percent) to 100 (percent).
.TP
.B Dualview
Flag to dislay the image both on the monitor and the TV. Not supported for
all modes.
.TP
.B Monochrome
Flag to display TV image in monochrome.
.TP
.B Non-Interlaced
Flag to display TV image in non-interlaced mode. Reduces vertical detail,
but decreases flicker.
.TP
.B Macrovision
Flag to enable macrovision.
.TP
.B FreeCarrier
Flag to let the color carrier generator run free.
.TP
.B Colorfix
Flag to fix the color format for Philips encoder chips.
.TP
.B AdjustCursor
Flag to adjust cursor when in \fIshared view\fR dualhead mode.
.TP
.B ViewportCursor       (flag)     
Flag to adjust the TV viewport by cursor when in \fIshared view\fR
dualhead mode.
.TP
.B ViewportMonitor      (flag)       
Flag to adjust the TV viewport by the monitor viewport 
when in \fIshared view\fR dualhead mode.
.SH "SEE ALSO"
The full documentation for
.B nvtv
is located in 
.B /usr/share/doc/nvtv/
directory.
.SH "AUTHORS" 
.PP 
Dirk Thierbach
.br
dthierbach@gmx.de

Eduard Bloch, for the the \fBDebian\fP system.
.br
blade@debian.org

Permission is granted to copy, distribute and/or modify this document
under the terms of the BSD License.