From 383cf207859485c4516d29053dafab0bb2d8c347 Mon Sep 17 00:00:00 2001 From: wm4 Date: Mon, 9 Jun 2014 23:54:45 +0200 Subject: tv: remove global option variables Pretty much nothing changes, but using -tv-scan with suboptions doesn't work anymore (instead of "-tv-scan x" it's "-tv scan-x" now). Flat options ("-tv-scan-x") stay compatible. --- DOCS/man/en/options.rst | 264 +++++++++++++++++++++++------------------------- 1 file changed, 128 insertions(+), 136 deletions(-) (limited to 'DOCS') diff --git a/DOCS/man/en/options.rst b/DOCS/man/en/options.rst index ec5061c4de..58b1345922 100644 --- a/DOCS/man/en/options.rst +++ b/DOCS/man/en/options.rst @@ -2395,192 +2395,184 @@ OPTIONS Verify peer certificates when using TLS (e.g. with ``https://...``). (Silently fails with older ffmpeg or libav versions.) -``--tv=`` - This option tunes various properties of the TV capture module. For +``--tv-...`` + These options tune various properties of the TV capture module. For watching TV with mpv, use ``tv://`` or ``tv://`` or - even ``tv://`` (see option ``channels`` for ``channel_name`` + even ``tv://`` (see option ``tv-channels`` for ``channel_name`` below) as a movie URL. You can also use ``tv:///`` to start watching a movie from a composite or S-Video input (see option ``input`` for details). - Available options are: - - ``noaudio`` - no sound - - ``automute=<0-255> (v4l and v4l2 only)`` - If signal strength reported by device is less than this value, audio - and video will be muted. In most cases automute=100 will be enough. - Default is 0 (automute disabled). +``--no-tv-audio`` + no sound - ``driver=`` - See ``--tv=driver=help`` for a list of compiled-in TV input drivers. - available: dummy, v4l2 (default: autodetect) +``--tv-automute=<0-255> (v4l and v4l2 only)`` + If signal strength reported by device is less than this value, audio + and video will be muted. In most cases automute=100 will be enough. + Default is 0 (automute disabled). - ``device=`` - Specify TV device (default: ``/dev/video0``). +``--tv-driver=`` + See ``--tv=driver=help`` for a list of compiled-in TV input drivers. + available: dummy, v4l2 (default: autodetect) - ``input=`` - Specify input (default: 0 (TV), see console output for available - inputs). +``--tv-device=`` + Specify TV device (default: ``/dev/video0``). - ``freq=`` - Specify the frequency to set the tuner to (e.g. 511.250). Not - compatible with the channels parameter. +``--tv-input=`` + Specify input (default: 0 (TV), see console output for available + inputs). - ``outfmt=`` - Specify the output format of the tuner with a preset value supported - by the V4L driver (YV12, UYVY, YUY2, I420) or an arbitrary format given - as hex value. +``--tv-freq=`` + Specify the frequency to set the tuner to (e.g. 511.250). Not + compatible with the channels parameter. - ``width=`` - output window width +``--tv-outfmt=`` + Specify the output format of the tuner with a preset value supported + by the V4L driver (YV12, UYVY, YUY2, I420) or an arbitrary format given + as hex value. - ``height=`` - output window height +``--tv-width=`` + output window width - ``fps=`` - framerate at which to capture video (frames per second) +``--tv-height=`` + output window height - ``buffersize=`` - maximum size of the capture buffer in megabytes (default: dynamical) +``--tv-fps=`` + framerate at which to capture video (frames per second) - ``norm=`` - See the console output for a list of all available norms, also see the - ``normid`` option below. +``--tv-buffersize=`` + maximum size of the capture buffer in megabytes (default: dynamical) - ``normid= (v4l2 only)`` - Sets the TV norm to the given numeric ID. The TV norm depends on the - capture card. See the console output for a list of available TV norms. +``--tv-norm=`` + See the console output for a list of all available norms, also see the + ``normid`` option below. - ``channel=`` - Set tuner to channel. +``--tv-normid= (v4l2 only)`` + Sets the TV norm to the given numeric ID. The TV norm depends on the + capture card. See the console output for a list of available TV norms. - ``chanlist=`` - available: argentina, australia, china-bcast, europe-east, - europe-west, france, ireland, italy, japan-bcast, japan-cable, - newzealand, russia, southafrica, us-bcast, us-cable, us-cable-hrc +``--tv-channel=`` + Set tuner to channel. - ``channels=-[=],-[=],...`` - Set names for channels. - - .. note:: +``--tv-chanlist=`` + available: argentina, australia, china-bcast, europe-east, + europe-west, france, ireland, italy, japan-bcast, japan-cable, + newzealand, russia, southafrica, us-bcast, us-cable, us-cable-hrc - If is an integer greater than 1000, it will be treated as - frequency (in kHz) rather than channel name from frequency table. - Use _ for spaces in names (or play with quoting ;-) ). The channel - names will then be written using OSD, and the slave commands - ``tv_step_channel``, ``tv_set_channel`` and ``tv_last_channel`` - will be usable for a remote control (see LIRC). Not compatible with - the ``frequency`` parameter. +``--tv-channels=-[=],-[=],...`` + Set names for channels. - .. note:: + .. note:: - The channel number will then be the position in the 'channels' - list, beginning with 1. + If is an integer greater than 1000, it will be treated as + frequency (in kHz) rather than channel name from frequency table. + Use _ for spaces in names (or play with quoting ;-) ). The channel + names will then be written using OSD, and the slave commands + ``tv_step_channel``, ``tv_set_channel`` and ``tv_last_channel`` + will be usable for a remote control (see LIRC). Not compatible with + the ``frequency`` parameter. - .. admonition:: Examples + .. note:: - ``tv://1``, ``tv://TV1``, ``tv_set_channel 1``, - ``tv_set_channel TV1`` + The channel number will then be the position in the 'channels' + list, beginning with 1. - ``[brightness|contrast|hue|saturation]=<-100-100>`` - Set the image equalizer on the card. + .. admonition:: Examples - ``audiorate=`` - Set input audio sample rate. + ``tv://1``, ``tv://TV1``, ``tv_set_channel 1``, + ``tv_set_channel TV1`` - ``forceaudio`` - Capture audio even if there are no audio sources reported by v4l. +``--tv-[brightness|contrast|hue|saturation]=<-100-100>`` + Set the image equalizer on the card. - ``alsa`` - Capture from ALSA. +``--tv-audiorate=`` + Set input audio sample rate. - ``amode=<0-3>`` - Choose an audio mode: +``--tv-forceaudio`` + Capture audio even if there are no audio sources reported by v4l. - :0: mono - :1: stereo - :2: language 1 - :3: language 2 +``--tv-alsa`` + Capture from ALSA. - ``forcechan=<1-2>`` - By default, the count of recorded audio channels is determined - automatically by querying the audio mode from the TV card. This option - allows forcing stereo/mono recording regardless of the amode option - and the values returned by v4l. This can be used for troubleshooting - when the TV card is unable to report the current audio mode. +``--tv-amode=<0-3>`` + Choose an audio mode: - ``adevice=`` - Set an audio device. should be ``/dev/xxx`` for OSS and a - hardware ID for ALSA. You must replace any ':' by a '.' in the - hardware ID for ALSA. + :0: mono + :1: stereo + :2: language 1 + :3: language 2 - ``audioid=`` - Choose an audio output of the capture card, if it has more than one. +``--tv-forcechan=<1-2>`` + By default, the count of recorded audio channels is determined + automatically by querying the audio mode from the TV card. This option + allows forcing stereo/mono recording regardless of the amode option + and the values returned by v4l. This can be used for troubleshooting + when the TV card is unable to report the current audio mode. - ``[volume|bass|treble|balance]=<0-100>`` - These options set parameters of the mixer on the video capture card. - They will have no effect, if your card does not have one. For v4l2 50 - maps to the default value of the control, as reported by the driver. +``--tv-adevice=`` + Set an audio device. should be ``/dev/xxx`` for OSS and a + hardware ID for ALSA. You must replace any ':' by a '.' in the + hardware ID for ALSA. - ``gain=<0-100>`` - Set gain control for video devices (usually webcams) to the desired - value and switch off automatic control. A value of 0 enables automatic - control. If this option is omitted, gain control will not be modified. +``--tv-audioid=`` + Choose an audio output of the capture card, if it has more than one. - ``immediatemode=`` - A value of 0 means capture and buffer audio and video together. A - value of 1 (default) means to do video capture only and let the audio - go through a loopback cable from the TV card to the sound card. +``--tv-[volume|bass|treble|balance]=<0-100>`` + These options set parameters of the mixer on the video capture card. + They will have no effect, if your card does not have one. For v4l2 50 + maps to the default value of the control, as reported by the driver. - ``mjpeg`` - Use hardware MJPEG compression (if the card supports it). When using - this option, you do not need to specify the width and height of the - output window, because mpv will determine it automatically from - the decimation value (see below). +``--tv-gain=<0-100>`` + Set gain control for video devices (usually webcams) to the desired + value and switch off automatic control. A value of 0 enables automatic + control. If this option is omitted, gain control will not be modified. - ``decimation=<1|2|4>`` - choose the size of the picture that will be compressed by hardware - MJPEG compression: +``--tv-immediatemode=`` + A value of 0 means capture and buffer audio and video together. A + value of 1 (default) means to do video capture only and let the audio + go through a loopback cable from the TV card to the sound card. - :1: full size +``--tv-mjpeg`` + Use hardware MJPEG compression (if the card supports it). When using + this option, you do not need to specify the width and height of the + output window, because mpv will determine it automatically from + the decimation value (see below). - - 704x576 PAL - - 704x480 NTSC +``--tv-decimation=<1|2|4>`` + choose the size of the picture that will be compressed by hardware + MJPEG compression: - :2: medium size + :1: full size - - 352x288 PAL - - 352x240 NTSC + - 704x576 PAL + - 704x480 NTSC - :4: small size + :2: medium size - - 176x144 PAL - - 176x120 NTSC + - 352x288 PAL + - 352x240 NTSC - ``quality=<0-100>`` - Choose the quality of the JPEG compression (< 60 recommended for full - size). + :4: small size -``--tv-scan=`` - Tune the TV channel scanner. mpv will also print value for - ``--tv=channels=`` option, including existing and just found channels. + - 176x144 PAL + - 176x120 NTSC - Available suboptions are: +``--tv-quality=<0-100>`` + Choose the quality of the JPEG compression (< 60 recommended for full + size). - ``autostart`` - Begin channel scanning immediately after startup (default: disabled). +``--tv-scan-autostart`` + Begin channel scanning immediately after startup (default: disabled). - ``period=<0.1-2.0>`` - Specify delay in seconds before switching to next channel (default: - 0.5). Lower values will cause faster scanning, but can detect inactive - TV channels as active. +``--tv-scan-period=<0.1-2.0>`` + Specify delay in seconds before switching to next channel (default: + 0.5). Lower values will cause faster scanning, but can detect inactive + TV channels as active. - ``threshold=<1-100>`` - Threshold value for the signal strength (in percent), as reported by - the device (default: 50). A signal strength higher than this value will - indicate that the currently scanning channel is active. +``--tv-scan-threshold=<1-100>`` + Threshold value for the signal strength (in percent), as reported by + the device (default: 50). A signal strength higher than this value will + indicate that the currently scanning channel is active. ``--use-filedir-conf`` Look for a file-specific configuration file in the same directory as the -- cgit v1.2.3