git.sesse.net Git - nageru-docs/blob - futatabi.rst

   1 Futatabi: Real-time instant replay with slow motion
   2 ===================================================
   3
   4 Futatabi (after the Japanese word *futatabi*, 再び, meaning “again” or
   5 “for the second time”) is a system for instant replay. Even though Futatabi
   6 is meant to be used with Nageru, shares some code with it and is built from
   7 the same source distribution, it is a separate
   8 application. Futatabi is meant for slow motion for e.g. sports broadcasts, but
   9 can also be used as a more generic multitrack recorder for later editing.
  10
  11 Futatabi supports *interpolated* slow motion, meaning you do not need to buy
  12 a high-speed 120 fps camera to get smooth 60 fps output after slowdown—Futatabi
  13 will automatically synthesize in-between frames for you during playback.
  14 Good interpolation, especially in realtime, is a difficult problem, and not all
  15 content will do equally well. Most content should do quite acceptably, especially
  16 considering that half of the frames will actually be originals, but you
  17 will need to see in practice what actually works for you. Interpolation can
  18 also be used for frame rate conversion (e.g. 50 to 59.94 fps).
  19
  20 Futatabi currently uses a GPU reimplementation of
  21 `Fast Optical Flow using Dense Inverse Search (DIS) <https://github.com/tikroeger/OF_DIS>`_
  22 by Kroeger et al, although this may change in the future.
  23
  24 Since Futatabi is part of the Nageru source distribution, its version number
  25 mirrors Nageru. Thus, the first version of Futatabi is version 1.8.0,
  26 which is the Nageru version when it was first introduced.
  27
  28
  29 System requirements
  30 -------------------
  31
  32 It is strongly recommended to run Futatabi on a separate machine from Nageru,
  33 not the least because you probably want a different person to operate the replay
  34 while the producer is operating Nageru.
  35
  36 Like Nageru, Futatabi uses your GPU for nearly all image processing.
  37 However, unlike Nageru, Futatabi requires a powerful GPU for interpolation;
  38 a GTX 1080 or similar is recommended for interpolated 720p60. (Futatabi
  39 was initially developed on a GTX 950, which is passable, but has little
  40 performance margin.) If you have a slower GPU and are happy with worse
  41 quality, or just wish to test, you can use a faster preset, or turn off
  42 interpolation entirely. Futatabi requires OpenGL 4.5 or newer.
  43
  44 For other required libraries, see :ref:`compile`; when you build Nageru,
  45 you also build Futatabi.
  46
  47
  48 Getting started
  49 ---------------
  50
  51 Sample multicamera data
  52 '''''''''''''''''''''''
  53
  54 Transferring data to and from Nageru
  55 ------------------------------------
  56
  57 Video format specification
  58 ''''''''''''''''''''''''''
  59
  60 Monitoring
  61 ----------
  62
  63 Tally and status talkback
  64 '''''''''''''''''''''''''
  65
  66 Prometheus metrics
  67 ''''''''''''''''''