vdr-plugin-softhddevice/README.txt

175 lines
4.3 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
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
o planned: Software Deinterlacer
2012-01-02 15:27:03 +01:00
o planned: Video XvBA/XvBA
o Audio FFMpeg/Alsa/Analog
o Audio FFMpeg/Alsa/Digital
o Audio FFMpeg/OSS/Analog
o planned: Alsa HDMI/SPDIF Passthrough
o planned: OSS HDMI/SPDIF Passthrough
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
cd vdr-softhddevice
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-01-02 15:27:03 +01:00
only if alsa is configured
ALSA_DEVICE=default
alsa PCM device name
ALSA_MIXER=default
alsa control device name
ALSA_MIXER_CHANNEL=PCM
alsa control channel name
2012-01-02 15:27:03 +01:00
only if oss is configured
OSS_AUDIODEV=/dev/dsp
oss dsp device name
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
2011-12-16 22:34:54 +01:00
softhddevice.Deinterlace = 0
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.SkipChromaDeinterlace = 0
0 = disabled, 1 = enabled (for slower cards, poor qualit<69>t)
softhddevice.Denoise = 0
0 .. 1000 noise reduction level (0 off, 1000 max)
softhddevice.Sharpness = 0
-1000 .. 1000 noise reduction level (0 off, -1000 max blur,
1000 max sharp)
2011-12-16 22:34:54 +01:00
softhddevice.Scaling = 0
0 = normal, 1 = fast, 2 = HQ, 3 = anamorphic
softhddevice.AudioDelay = 0
+n or -n ms
softhddevice.AudioPassthrough = 0
0 = none, 1 = AC-3
Commandline:
------------
Use vdr -h to see the command line arguments support by the plugin.
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
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: