]> git.sesse.net Git - nageru-docs/blobdiff - hardware.rst
Drop documentation of very old versions.
[nageru-docs] / hardware.rst
index 15c4ac749abeb3aafef140186ebb2479615ad9fd..a65ff8ef7bdc8a23c687779d46eba474b38bf5e7 100644 (file)
@@ -39,7 +39,7 @@ output as a sort of “digital intermediate” that can much easier be stored to
 (for future editing or re-streaming) or sent to an encoder on another machine
 for final streaming.
 
-Although you can (since Nageru 1.5.0) use software encoding through x264 for
+Although you can use software encoding through x264 for
 the digital intermediate, it is generally preferred to use a hardware encoder
 if it is available. Currently, VA-API is the only hardware encoding method
 supported for encoding the digital intermediate, although Nageru might support
@@ -104,16 +104,16 @@ The PCI cards (known as DeckLink) require Blackmagic's proprietary driver
 (`Desktop Video <https://www.blackmagicdesign.com/support>`_) installed
 and working. It is non-free and thus not included in most Linux distributions.
 However, the SDK is not needed for building Nageru; the required headers
-are free and included. Note that the PCI cards generally do not autodetect,
-so you will need to right-click on the input to set the right mode.
+are free and included. Most of the PCI cards autodetect, but for some older
+versions, you will need to right-click on the input to set the right mode.
 
 
 Video format conversion
 -----------------------
 
 If you have an input source with a different resolution than the native mode
-(currently locked to 720p; this will be configurable without recompiling
-in the future), Nageru will scale transparently for you using a Lanczos3
+(720p by default, but you can change this using the -w and -h command line
+parameters), Nageru will scale transparently for you using a Lanczos3
 filter (or rather, the :doc:`theme <theme>` will). This requires some extra GPU power,
 so if you can avoid it, use the native mode. Similarly, if you connect an
 interlaced input, Nageru will automatically deinterlace for you.
@@ -126,7 +126,14 @@ account for clock and jitter).
 
 Nageru works in 16-bit floating-point RGBA internally. High-quality conversion to and
 from subsampled Y'CbCr (typically 4:2:2 for inputs and 4:2:0 for outputs)
-is done transparently on the GPU.
+is done transparently on the GPU. Input and output is 8-bit Y'CbCr by default,
+but be aware that 8-bit Y'CbCr, however common, cannot capture the full color
+fidelity of 8-bit RGB (not to mention 10-bit RGB). If you have spare GPU power,
+you can enable 10-bit Y'CbCr input and output with --10-bit-input and
+--10-bit-output, respectively, although you should be aware that client
+support for 10-bit H.264 is very limited. Also, Quick Sync Video does not
+support 10-bit H.264 encoding, so in this case, the digital intermediate needs
+to be encoded in software.
 
 
 Performance tips