command: add property to return text subtitles in ASS

See manpage additions. This was requested, sort of. Although what has
been requested might be something completely different. So this is
speculative.

This also changes sub_get_text() to return an allocated copy, because
the buffer shit was too damn messy.

1 files changed, 13 insertions, 0 deletions

diff --git a/DOCS/man/input.rst b/DOCS/man/input.rst
index af80052b1d..be48644cfd 100644
--- a/DOCS/man/input.rst
+++ b/DOCS/man/input.rst
@@ -2461,6 +2461,19 @@ Property list
 
     This property is experimental and might be removed in the future.
 
+``sub-text-ass``
+    Like ``sub-text``, but return the text in ASS format. Text subtitles in
+    other formats are converted. For native ASS subtitles, events that do
+    not contain any text (but vector drawings etc.) are not filtered out. If
+    multiple events match with the current playback time, they are concatenated
+    with line breaks. Contains only the "Text" part of the events.
+
+    This property is not enough to render ASS subtitles correctly, because ASS
+    header and per-event metadata are not returned. You likely need to do
+    further filtering on the returned string to make it useful.
+
+    This property is experimental and might be removed in the future.
+
 ``sub-start``
     Return the current subtitle start time (in seconds). If there's multiple
     current subtitles, returns the first start time. If no current subtitle is