vdr-plugin-softhddevice/README.txt

307 lines
7.5 KiB
Plaintext
Raw Normal View History

2011-12-06 18:36:57 +01:00
@file README.txt @brief A software HD output device for VDR
2012-01-02 15:27:03 +01:00
Copyright (c) 2011, 2012 by Johns. All Rights Reserved.
2011-12-06 18:36:57 +01:00
Contributor(s):
License: AGPLv3
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU Affero General Public License as
published by the Free Software Foundation, either version 3 of the
License.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU Affero General Public License for more details.
$Id$
A software and GPU emulated HD output device plugin for VDR.
2012-01-02 15:27:03 +01:00
o Video VA-API/VA-API (with intel, nvidia and amd backend supported)
o Video CPU/VA-API
o Video VDPAU/VDPAU
o Video CPU/VDPAU
2012-01-20 15:33:37 +01:00
o Audio FFMpeg/Alsa/Analog
o Audio FFMpeg/Alsa/Digital
o Audio FFMpeg/OSS/Analog
o HDMI/SPDIF Passthrough
o VA-API bob software deinterlace
o Auto-crop
2011-12-06 18:36:57 +01:00
o planned: Video VA-API/Opengl
2012-01-02 15:27:03 +01:00
o planned: Video VDPAU/Opengl
2011-12-06 18:36:57 +01:00
o planned: Video CPU/Xv
o planned: Video CPU/Opengl
2012-01-20 15:33:37 +01:00
o planned: Improved Software Deinterlacer (yadif or/and ffmpeg filters)
2012-01-02 15:27:03 +01:00
o planned: Video XvBA/XvBA
2012-01-20 15:33:37 +01:00
o planned: atmo light support
2011-12-06 18:36:57 +01:00
To compile you must have the 'requires' installed.
Good luck
johns
Quickstart:
-----------
Just type make and use.
Install:
--------
1a) git
git clone git://projects.vdr-developer.org/vdr-plugin-softhddevice.git
cd vdr-plugin-softhddevice
make VDRDIR=<path-to-your-vdr-files> LIBDIR=.
gentoo: make VDRDIR=/usr/include/vdr LIBDIR=.
2a) tarball
Download latest version from:
http://projects.vdr-developer.org/projects/plg-softhddevice/files
tar vxf vdr-softhddevice-*.tar.bz2
2012-01-19 00:16:15 +01:00
cd softhddevice-*
2011-12-06 18:36:57 +01:00
make VDRDIR=<path-to-your-vdr-files> LIBDIR=.
You can edit Makefile to enable/disable VDPAU / VA-API / Alsa / OSS
support.
Setup: environment
2012-01-02 15:27:03 +01:00
------
Following is supported:
DISPLAY=:0.0
x11 display name
2012-02-13 14:25:38 +01:00
NO_HW=1
if set don't use the hardware decoders
NO_MPEG_HW=1
if set don't use the hardware decoder for mpeg1/2
STUDIO_LEVELS=1
if set use studio levels with vdpau (deprecated use setup)
2012-01-02 15:27:03 +01:00
only if alsa is configured
ALSA_DEVICE=default
alsa PCM device name
ALSA_AC3_DEVICE=
alsa AC3/pass-though device name
ALSA_MIXER=default
alsa control device name
ALSA_MIXER_CHANNEL=PCM
alsa control channel name
2012-02-13 14:25:38 +01:00
2012-01-02 15:27:03 +01:00
only if oss is configured
OSS_AUDIODEV=/dev/dsp
oss dsp device name
OSS_AC3_AUDIODEV=
oss AC3/pass-though device name
2012-01-02 15:27:03 +01:00
OSS_MIXERDEV=/dev/mixer
oss mixer device name
2012-01-04 16:59:48 +01:00
OSS_MIXER_CHANNEL=pcm
oss mixer channel name
2011-12-16 22:34:54 +01:00
Setup: /etc/vdr/setup.conf
2012-01-02 15:27:03 +01:00
------
2011-12-16 22:34:54 +01:00
Following is supported:
softhddevice.MakePrimary = 1
0 = no change, 1 make softhddevice primary at start
softhddevice.HideMainMenuEntry = 0
0 = show softhddevice main menu entry, 1 = hide entry
<res> of the next parameters is 576i, 720p, 1080i_fake or 1080i.
1080i_fake is 1280x1080 or 1440x1080
1080i is "real" 1920x1080
softhddevice.<res>.Scaling = 0
0 = normal, 1 = fast, 2 = HQ, 3 = anamorphic
softhddevice.<res>.Deinterlace = 0
2011-12-16 22:34:54 +01:00
0 = bob, 1 = weave, 2 = temporal, 3 = temporal_spatial, 4 = software
2012-01-02 15:27:03 +01:00
(only 0, 1 supported with vaapi)
2011-12-16 22:34:54 +01:00
softhddevice.<res>.SkipChromaDeinterlace = 0
0 = disabled, 1 = enabled (for slower cards, poor qualit<69>t)
softhddevice.<res>.InverseTelecine = 0
0 = disabled, 1 = enabled
softhddevice.<res>.Denoise = 0
0 .. 1000 noise reduction level (0 off, 1000 max)
softhddevice.<res>.Sharpness = 0
-1000 .. 1000 noise reduction level (0 off, -1000 max blur,
1000 max sharp)
2011-12-16 22:34:54 +01:00
softhddevice.AudioDelay = 0
+n or -n ms
2012-02-21 22:24:28 +01:00
delay audio or delay video
softhddevice.AudioPassthrough = 0
0 = none, 1 = AC-3
for AC-3 the pass-through device is used.
2012-02-21 22:24:28 +01:00
softhddevice.AudioDownmix = 0
0 = none, 1 = downmix
downmix AC-3 to stero.
2012-01-20 15:33:37 +01:00
softhddevice.AutoCrop.Interval = 0
0 disables auto-crop
n each 'n' frames auto-crop is checked.
softhddevice.AutoCrop.Delay = 0
if auto-crop is over 'n' intervals the same, the cropping is
2012-01-20 15:33:37 +01:00
used.
softhddevice.AutoCrop.Tolerance = 0
if detected crop area is too small, cut max 'n' pixels at top and
bottom.
2012-02-24 15:42:32 +01:00
softhddevice.Background = 0
32bit RGBA background color
(Red * 16777216 + Green * 65536 + Blue * 256 + Alpha)
or hex RRGGBBAA
2012-03-12 17:58:19 +01:00
grey 127 * 16777216 + 127 * 65536 + 127 * 256 => 2139062016
in the setup menu this is entered as (24bit RGB and 8bit Alpha)
(Red * 65536 + Green * 256 + Blue)
2012-02-24 15:42:32 +01:00
softhddevice.SkipLines = 0
skip 'n' lines at top and bottom of the video picture.
2012-02-13 14:25:38 +01:00
softhddevice.StudioLevels = 0
0 use PC levels (0-255) with vdpau.
1 use studio levels (16-235) with vdpau.
softhddevice.Suspend.Close = 0
1 suspend closes x11 window, connection and audio device.
(use svdrpsend plug softhddevice RESU to resume, if you have no lirc)
softhddevice.Suspend.X11 = 0
1 suspend stops X11 server (not working yet)
softhddevice.60HzMode = 0
0 disable 60Hz display mode
1 enable 60Hz display mode
softhddevice.SoftStartSync = 0
0 disable soft start of audio/video sync
1 enable soft start of audio/video sync
VideoDisplayFormat = ?
0 pan and scan
1 letter box
2 center cut-out
Setup: /etc/vdr/remote.conf
------
Add "XKeySym." definitions to /etc/vdr/remote.conf to control
the vdr and plugin with the connected input device.
fe.
XKeySym.Up Up
XKeySym.Down Down
...
Additional to the x11 input sends the window close button "Close".
fe.
XKeySym.Power Close
Commandline:
------------
Use vdr -h to see the command line arguments supported by the plugin.
2012-01-19 00:16:15 +01:00
-a audio_device
Selects audio output module and device.
"" to disable audio output
/... to use oss audio module (if compiled with oss
support)
other to use alsa audio module (if compiled with alsa
support)
SVDRP:
------
2012-03-01 22:12:22 +01:00
Use 'svdrpsend.pl plug softhddevice HELP'
or 'svdrpsend plug softhddevice HELP' to see the SVDRP commands help
and which are supported by the plugin.
2012-02-19 19:22:03 +01:00
Keymacros:
----------
See keymacros.conf how to setup the macros.
This are the supported key sequences:
@softhddevice Blue 1 0 disable pass-through
@softhddevice Blue 1 1 enable pass-through
@softhddevice Blue 1 2 toggle pass-through
Running:
--------
2012-01-13 16:31:29 +01:00
Click into video window to toggle fullscreen/window mode, only if you
have a window manager running.
2012-01-02 15:27:03 +01:00
Warning:
--------
libav is not supported, expect many bugs with it.
2011-12-06 18:36:57 +01:00
Requires:
---------
2012-01-02 15:27:03 +01:00
media-video/ffmpeg (version >=0.7)
2011-12-06 18:36:57 +01:00
Complete solution to record, convert and stream audio and
video. Includes libavcodec.
http://ffmpeg.org
media-libs/alsa-lib
Advanced Linux Sound Architecture Library
http://www.alsa-project.org
or
kernel support for oss/oss4 or alsa oss emulation
2011-12-06 18:36:57 +01:00
x11-libs/libva
Video Acceleration (VA) API for Linux
http://www.freedesktop.org/wiki/Software/vaapi
x11-libs/libva-intel-driver
HW video decode support for Intel integrated graphics
http://www.freedesktop.org/wiki/Software/vaapi
or
x11-libs/vdpau-video
VDPAU Backend for Video Acceleration (VA) API
http://www.freedesktop.org/wiki/Software/vaapi
2012-01-02 15:27:03 +01:00
or
2011-12-06 18:36:57 +01:00
x11-libs/xvba-video
XVBA Backend for Video Acceleration (VA) API
http://www.freedesktop.org/wiki/Software/vaapi
2012-03-19 17:15:21 +01:00
x11-libs/libvdpau
VDPAU wrapper and trace libraries
http://www.freedesktop.org/wiki/Software/VDPAU
2011-12-06 18:36:57 +01:00
x11-libs/libxcb,
X C-language Bindings library
http://xcb.freedesktop.org
x11-libs/xcb-util,
x11-libs/xcb-util-wm,
x11-libs/xcb-util-keysyms
X C-language Bindings library
http://xcb.freedesktop.org
2012-01-02 15:27:03 +01:00
Only versions >= 0.3.8 are good supported
2011-12-06 18:36:57 +01:00
x11-libs/libX11
X.Org X11 library
http://xorg.freedesktop.org
GNU Make 3.xx
http://www.gnu.org/software/make/make.html
Optional: