summaryrefslogtreecommitdiffstats
path: root/Documentation
diff options
context:
space:
mode:
authorGravatar Robert C. Helling <helling@atdotde.de>2019-04-14 16:19:23 +0200
committerGravatar bstoeger <32835590+bstoeger@users.noreply.github.com>2019-04-16 20:38:19 +0200
commit52105e521720c87e64dbd2519be7bbe5dc243439 (patch)
treec8483c1d7163a9bf6b40b6f984467ccfd549c7d9 /Documentation
parent0573b19b653d0b4963fe11efdc2303289d2b7994 (diff)
downloadsubsurface-52105e521720c87e64dbd2519be7bbe5dc243439.tar.gz
Write dive data as video subtitles
This commit adds an entry to the dive media context menu which offers to write a subtitle file. This creates an .ass file for the selected videos. In an attempt to to clutter the screen too much, don't show irrelevant entries (zero temperature or NDL and show TTS only for dives with stops). VLC is able to show these subtitles directly, they can be integrated into the video file with ffmpeg. Signed-off-by: Robert C. Helling <helling@atdotde.de>
Diffstat (limited to 'Documentation')
-rw-r--r--Documentation/user-manual.txt11
1 files changed, 11 insertions, 0 deletions
diff --git a/Documentation/user-manual.txt b/Documentation/user-manual.txt
index 359c37b01..71e0b6487 100644
--- a/Documentation/user-manual.txt
+++ b/Documentation/user-manual.txt
@@ -1638,6 +1638,17 @@ or play the video, overlaying the _Subsurface_ window. Delete media from the _Me
it (single-click) and then by pressing the _Del_ key on the keyboard. This removes it BOTH
from the _Media_ tab as well as the dive profile.
+By right-clicking on a video and selecting the "Save dive data as subtitles" option, a subtitles
+file with the same name as the video but with an ".ass" extension is created that contains
+time dependent dive data (runtime, depth, temperature, NDL, TTS, surface GF) to be overlayed
+with the video. The VLC video player automatically finds this file upon playing the video
+and overlays the dive data. Alternatively, the ffmpeg video encoder can be used to create a
+new video file with the dive data encoded in the video stream. To do so run
+
+ ffmpeg -v video.mp4 -vf "ass=video.ass" video_with_data.mp4
+
+from the command line. You need to have the libass library installed.
+
==== Media on an external hard disk
Most underwater photographers store media on an external drive. If such a drive can be mapped by the operating system
(almost always the case) the media can be directly accessed by _Subsurface_. This eases the interaction