]> git.sesse.net Git - nageru-docs/blobdiff - futatabi.rst
Correct some durations.
[nageru-docs] / futatabi.rst
index 1b01e56beab9da87d54ce2957cf6e1df873ca6a3..a291c89a8684b3500bc79eb5a25b46bbe49e6a23 100644 (file)
@@ -19,7 +19,10 @@ also be used for frame rate conversion (e.g. 50 to 59.94 fps).
 
 Futatabi currently uses a GPU reimplementation of
 `Fast Optical Flow using Dense Inverse Search (DIS) <https://github.com/tikroeger/OF_DIS>`_
-by Kroeger et al, although this may change in the future.
+by Kroeger et al, together with about half of the algorithm from
+`Occlusion Reasoning for Temporal Interpolation Using Optical Flow <https://www.microsoft.com/en-us/research/publication/occlusion-reasoning-for-temporal-interpolation-using-optical-flow/>`_
+(to do the actual interpolation based on the estimated
+optical flow), although this may change in the future.
 
 Since Futatabi is part of the Nageru source distribution, its version number
 mirrors Nageru. Thus, the first version of Futatabi is version 1.8.0,
@@ -51,9 +54,42 @@ Getting started
 Sample multicamera data
 '''''''''''''''''''''''
 
+Good multicamera sample video is hard to come by, so it can be hard to
+test or train before an actual event. To alleviate this, I've uploaded some
+real-world video from the very first event where an early version of Futatabi
+was tested. (There are some issues with the JPEG quality, but it should
+largely be unproblematic.) You are free to use these for training or
+demonstration purposes. Do note that they will not be displayed entirely
+correctly in most video players (see :ref:`futatabiformat`), although
+they will certainly be watchable.
+
+There are two files:
+
+ * `Trøndisk 2018, finals only (MJPEG, 77 GB) <https://storage.sesse.net/trondisk2018-finals-multicam-mjpeg.mkv>`_:
+   The final match, in MJPEG format (about 30 minutes). This can be downloaded
+   and then fed directly to Nageru as if it were a real camera stream
+   (remember the --slow-down-input option).
+ * `Trøndisk 2018, entire tournament (H.264, 74 GB) <https://storage.sesse.net/trondisk2018-multicam-h264.mp4>`_: The entire tournament,
+   with no cuts (about 12 hours). However, due to space and bandwidth
+   constraints, it has been transcoded to H.264 (with some associated
+   quality loss), and needs to be transcoded to MJPEG before Nageru can use it.
+
+Both files are mixed-resolution, with some cameras at 1080p59.94 and some
+at 720p59.94 (one even switches between matches, as the camera was replaced).
+They contain four different camera angles (overview camera on crane, detail camera
+in tripod, two fixed endzone overhead cameras) with differing quality depending
+on the camera operators. In short, they should be realistic input material
+to practice with.
+
+Please download these files only once, instead of streaming them directly over
+HTTP each time you want to test.
+
+
 Transferring data to and from Nageru
 ------------------------------------
 
+.. _futatabiformat:
+
 Video format specification
 ''''''''''''''''''''''''''