Add support for DeckLink PCI cards through the official driver.

[nageru] / README

diff --git a/README b/README
index e85b849656fe42cf13801cbd9746aa7f62ab892d..e5e59648f77eb40ce98b18ff3145d402cb6f5779 100644 (file)
--- a/README
+++ b/README
@@ -29,10 +29,13 @@ to 800 MHz after 30 seconds due to thermal constraints), Intel HD Graphics
 Nageru is in beta stage. It currently needs:
 
  - An Intel processor with Intel Quick Sync, or otherwise some hardware
-   H.264 encoder exposed through VA-API.
+   H.264 encoder exposed through VA-API. Note that you can use VA-API over
+   DRM instead of X11, to use a non-Intel GPU for rendering but still use
+   Quick Sync (by giving e.g. “--va-display /dev/dri/renderD128”).
 
- - Two or more Blackmagic USB3 cards, either HDMI or SDI. These are driven
-   through the “bmusb” driver embedded in bmusb/, using libusb-1.0.
+ - Two or more Blackmagic USB3 or PCI cards, either HDMI or SDI.
+   The PCI cards need Blackmagic's own drivers installed. The USB3 cards
+   are driven through the “bmusb” driver embedded in bmusb/, using libusb-1.0.
    Note that you will want a recent Linux kernel to avoid LPM (link power
    management) and bandwidth allocation issues with USB3.
 
@@ -45,9 +48,11 @@ Nageru is in beta stage. It currently needs:
 
  - ffmpeg for muxing, and for encoding audio.
 
- - Working OpenGL; Movit works with almost any modern OpenGL implementation,
-   but Nageru has been tested with Mesa 10.x and 11.x only (you probably want
-   11.x).
+ - Working OpenGL; Movit works with almost any modern OpenGL implementation.
+   Nageru has been tested with Intel on Mesa 10.x and 11.x (you probably want
+   11.x), and with NVIDIA's proprietary drivers. AMD's proprietary drivers
+   (fglrx) are known not to work due to driver bugs; I am in contact with
+   AMD to try to get this resolved.
 
  - libzita-resampler, for resampling sound sources so that they are in sync
    between sources, and also for oversampling for the peak meter.
@@ -55,13 +60,14 @@ Nageru is in beta stage. It currently needs:
  - Lua, for driving the theme engine.
 
 
-If on Debian sid or something similar (or stretch, once Movit 1.3.0 migrates),
-you can install everything you need with:
+If on Debian stretch or something similar, you can install everything you need
+with:
 
   git submodule update --init
   apt install qtbase5-dev qt5-default pkg-config libmicrohttpd-dev \
     libusb-1.0-0-dev liblua5.2-dev libzita-resampler-dev libva-dev \
-    libavcodec-dev libavformat-dev libswscale-dev libmovit-dev
+    libavcodec-dev libavformat-dev libswscale-dev libmovit-dev \
+    libegl1-mesa-dev libasound2-dev
 
 
 The patches/ directory contains some patches for upstream software that help
@@ -100,7 +106,7 @@ Legalese: TL;DR: Everything is GPLv3-or-newer compatible, and see
 Intel's copyright license at h264encode.h.
 
 
-Nageru is Copyright (C) 2015 Steinar H. Gunderson <sgunderson@bigfoot.com>.
+Nageru is Copyright (C) 2015 Steinar H. Gunderson <steinar+nageru@gunderson.no>.
 Portions Copyright (C) 2003 Rune Holm.
 Portions Copyright (C) 2010-2015 Fons Adriaensen <fons@linuxaudio.org>.
 Portions Copyright (C) 2012-2015 Fons Adriaensen <fons@linuxaudio.org>.
@@ -145,3 +151,31 @@ IN NO EVENT SHALL PRECISION INSIGHT AND/OR ITS SUPPLIERS BE LIABLE FOR
 ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
 TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
 SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+
+All files in decklink/:
+
+Copyright (c) 2009 Blackmagic Design
+Copyright (c) 2015 Blackmagic Design
+
+Permission is hereby granted, free of charge, to any person or organization
+obtaining a copy of the software and accompanying documentation covered by
+this license (the "Software") to use, reproduce, display, distribute,
+execute, and transmit the Software, and to prepare derivative works of the
+Software, and to permit third-parties to whom the Software is furnished to
+do so, all subject to the following:
+
+The copyright notices in the Software and this entire statement, including
+the above license grant, this restriction and the following disclaimer,
+must be included in all copies of the Software, in whole or in part, and
+all derivative works of the Software, unless such copies or derivative
+works are solely in the form of machine-executable object code generated by
+a source language processor.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE, TITLE AND NON-INFRINGEMENT. IN NO EVENT
+SHALL THE COPYRIGHT HOLDERS OR ANYONE DISTRIBUTING THE SOFTWARE BE LIABLE
+FOR ANY DAMAGES OR OTHER LIABILITY, WHETHER IN CONTRACT, TORT OR OTHERWISE,
+ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+DEALINGS IN THE SOFTWARE.