X-Git-Url: https://git.sesse.net/?a=blobdiff_plain;f=README;h=b983777abc35171a780479cb155fb5507ff8262f;hb=78f7565bc0a089afdf957170d179af8b460c28d5;hp=0e61ef0288977c318f8f49cadd3b8c39b4c37512;hpb=150fc5cb55204f4204d0224d0c234ea8f0df6a1a;p=nageru diff --git a/README b/README index 0e61ef0..b983777 100644 --- 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 . +Portions Copyright (C) 2003 Rune Holm. Portions Copyright (C) 2010-2011 Fons Adriaensen . Portions Copyright (C) 2012-2015 Fons Adriaensen . Portions Copyright (c) 2007-2013 Intel Corporation. All Rights Reserved.