<html><head><meta http-equiv="Content-Type" content="text/html; charset=us-ascii"></head><body style="word-wrap: break-word; -webkit-nbsp-mode: space; line-break: after-white-space;" class=""><br class=""><div><br class=""><blockquote type="cite" class=""><div class="">On Sep 24, 2021, at 5:08 AM, Willem Ferguson via subsurface <<a href="mailto:subsurface@subsurface-divelog.org" class="">subsurface@subsurface-divelog.org</a>> wrote:</div><br class="Apple-interchange-newline"><div class=""><div class="">When right-clicking on a photo in the Subsurface Media tab on my desktop I just came across the option "Save dive data as subtitles". What does this do? I would like to include this in the user manual.<br class=""></div></div></blockquote></div><div class=""><br class=""></div>Well, here's what the manual says today...<div class=""><br class=""></div><blockquote style="margin: 0 0 0 40px; border: none; padding: 0px;" class=""><div class=""><div class=""><i class="">By right-clicking on a video and selecting the "Save dive data as subtitles" option, a subtitles</i></div></div><div class=""><div class=""><i class="">file with the same name as the video but with an ".ass" extension is created that contains</i></div></div><div class=""><div class=""><i class="">time dependent dive data (runtime, depth, temperature, NDL, TTS, surface GF) to be overlayed</i></div></div><div class=""><div class=""><i class="">with the video. The VLC video player automatically finds this file upon playing the video</i></div></div><div class=""><div class=""><i class="">and overlays the dive data. Alternatively, the ffmpeg video encoder can be used to create a</i></div></div><div class=""><div class=""><i class="">new video file with the dive data encoded in the video stream. To do so run</i></div></div><div class=""><div class=""><i class=""><br class=""></i></div></div><div class=""><div class=""><i class="">        ffmpeg -v video.mp4 -vf "ass=video.ass" video_with_data.mp4</i></div></div><div class=""><div class=""><i class=""><br class=""></i></div></div><div class=""><div class=""><i class="">from the command line. You need to have the libass library installed.</i></div></div></blockquote><div class=""><div class=""><br class=""></div><div class=""><br class=""></div><div class="">This is the classic example of a feature that one or two people wanted, one person implemented, and that no one uses or knows about.</div><div class="">I'm tempted to make a bet whether this actually works - or whether this works on a platform different from the one the implementer uses...</div></div><div class=""><br class=""></div><div class="">Well, this feature was added by Robert</div><div class=""><br class=""></div><div class=""><div class=""><font face="Courier New" class="">commit 52105e521720c87e64dbd2519be7bbe5dc243439</font></div><div class=""><font face="Courier New" class="">Author: Robert C. Helling <<a href="mailto:helling@atdotde.de" class="">helling@atdotde.de</a>></font></div><div class=""><font face="Courier New" class="">Date:   Sun Apr 14 16:19:23 2019 +0200</font></div><div class=""><font face="Courier New" class=""><br class=""></font></div><div class=""><font face="Courier New" class="">    Write dive data as video subtitles</font></div><div class=""><font face="Courier New" class="">    </font></div><div class=""><font face="Courier New" class="">    This commit adds an entry to the dive media context</font></div><div class=""><font face="Courier New" class="">    menu which offers to write a subtitle file. This</font></div><div class=""><font face="Courier New" class="">    creates an .ass file for the selected videos.</font></div><div class=""><font face="Courier New" class="">    </font></div><div class=""><font face="Courier New" class="">    In an attempt to to clutter the screen too much, don't</font></div><div class=""><font face="Courier New" class="">    show irrelevant entries (zero temperature or</font></div><div class=""><font face="Courier New" class="">    NDL and show TTS only for dives with stops).</font></div><div class=""><font face="Courier New" class="">    </font></div><div class=""><font face="Courier New" class="">    VLC is able to show these subtitles directly, they</font></div><div class=""><font face="Courier New" class="">    can be integrated into the video file with ffmpeg.</font></div><div class=""><font face="Courier New" class="">    </font></div><div class=""><font face="Courier New" class="">    Signed-off-by: Robert C. Helling <<a href="mailto:helling@atdotde.de" class="">helling@atdotde.de</a>></font></div></div><div class=""><br class=""></div><div class="">So my guess is this works on macOS, this may work on Linux, this is unlikely to have ever been tested on Windows.</div><div class=""><br class=""></div><div class="">/D</div></body></html>