]> git.sesse.net Git - nageru/blobdiff - README
Make a metadata-only version of InputState to be sent to Lua, in order to not be...
[nageru] / README
diff --git a/README b/README
index 0e61ef0288977c318f8f49cadd3b8c39b4c37512..b983777abc35171a780479cb155fb5507ff8262f 100644 (file)
--- a/README
+++ b/README
@@ -4,20 +4,25 @@ Nageru is a live video mixer, based around the standard M/E workflow.
 Features (those marked with * are still in progress or not started yet):
 
  - High performance on modest hardware (720p60 with two input streams
-   on my Thinkpad X240); almost all pixel processing is done on the GPU.
+   on my Thinkpad X240[1]); almost all pixel processing is done on the GPU.
 
  - High output quality; Lanczos3 scaling, subpixel precision everywhere,
-   white balance adjustment (*), mix of 16- and 32-bit floating point
+   white balance adjustment, mix of 16- and 32-bit floating point
    for intermediate calculations, dithered output.
 
  - Proper sound support: Syncing of multiple unrelated sources through
-   high-quality resampling, mixing (*), dynamic range compression (*),
-   fixed EQ (*), level meters conforming to EBU R128.
+   high-quality resampling, mixing (*), cue out for headphones,
+   dynamic range compression, fixed EQ, level meters conforming to EBU R128.
 
  - Theme engine encapsulating the design demands of each individual
-   event; Lua code is responsible for setting up the pixel proessing
-   pipelines causing transitions etc., so that the visual look is consistent
-   between operators.
+   event; Lua code is responsible for setting up the pixel processing
+   pipelines, running transitions etc., so that the visual look is
+   consistent between operators.
+
+[1] For reference, that is: Core i7 4600U (dualcore 2.10GHz, clocks down
+to 800 MHz after 30 seconds due to thermal constraints), Intel HD Graphics
+4400 (ie., without the extra L4 cache from Iris Pro), single-channel DDR3 RAM
+(so 12.8 GB/sec theoretical memory bandwidth, shared between CPU and GPU).
 
 
 Nageru is in alpha stage. It currently needs:
@@ -46,17 +51,21 @@ Nageru is in alpha stage. It currently needs:
    11.x).
 
  - libzita-resampler, for resampling sound sources so that they are in sync
-   between sources.
+   between sources, and also for oversampling for the peak meter.
+
+ - Lua, for driving the theme engine.
 
 
 To start it, just hook up your requipment, type “make” and then “./nageru”.
 It is strongly recommended to have the rights to run at real-time priority;
 it will make the USB3 threads do so, which will make them a lot more stable.
 (A reasonable hack for testing is probably just to run it as root using sudo,
-although you might not want to do that in production.)
+although you might not want to do that in production.) Note also that if you
+are running a desktop compositor, it will steal significant amounts of GPU
+performance. The same goes for PulseAudio.
 
 Nageru will open a HTTP server at port 9095, where you can extract a live
-H264+MP3 signal in MPEG-TS mux (e.g. http://127.0.0.1:9095/stream.ts).
+H264+PCM signal in QuickTime mux (e.g. http://127.0.0.1:9095/stream.mov).
 It is probably too high bitrate (~25 Mbit/sec depending on content) to send to
 users, but you can easily send it around in your internal network and then
 transcode it in e.g. VLC. A copy of the stream (separately muxed) will also
@@ -73,6 +82,7 @@ Intel's copyright license at h264encode.h.
 
 
 Nageru is Copyright (C) 2015 Steinar H. Gunderson <sgunderson@bigfoot.com>.
+Portions Copyright (C) 2003 Rune Holm.
 Portions Copyright (C) 2010-2011 Fons Adriaensen <fons@linuxaudio.org>.
 Portions Copyright (C) 2012-2015 Fons Adriaensen <fons@linuxaudio.org>.
 Portions Copyright (c) 2007-2013 Intel Corporation. All Rights Reserved.