This is an automated email from the git hooks/post-receive script.

Git pushed a commit to branch master
in repository ffmpeg.

commit 7c176c068d0992e277c59bba0e0beea0be47dd46
Author:     Jun Zhao <[email protected]>
AuthorDate: Mon Jun 1 16:28:54 2026 +0800
Commit:     Jun Zhao <[email protected]>
CommitDate: Tue Jun 23 03:57:25 2026 +0000

    doc/filters: document subtitles filter's shaping option
    
    The shaping option is now exposed by both the ass and subtitles filters.
    Document it under subtitles, update the ass filter description to refer
    to the shared option set, and note that complex shaping is required for
    Arabic, Hebrew, Devanagari and Thai and depends on a HarfBuzz-enabled
    libass build.
    
    Signed-off-by: Jun Zhao <[email protected]>
---
 doc/filters.texi | 30 +++++++++++++++++++++++++-----
 1 file changed, 25 insertions(+), 5 deletions(-)

diff --git a/doc/filters.texi b/doc/filters.texi
index 1a649cf794..c899cfe1d6 100644
--- a/doc/filters.texi
+++ b/doc/filters.texi
@@ -8611,21 +8611,24 @@ Same as the @ref{subtitles} filter, except that it 
doesn't require libavcodec
 and libavformat to work. On the other hand, it is limited to ASS (Advanced
 Substation Alpha) subtitles files.
 
-This filter accepts the following option in addition to the common options from
-the @ref{subtitles} filter:
+This filter accepts @option{filename}/@option{f}, @option{original_size},
+@option{fontsdir}, and @option{alpha} from the @ref{subtitles} filter, plus the
+following option:
 
 @table @option
 @item shaping
-Set the shaping engine
+Set the shaping engine.
 
 Available values are:
 @table @samp
 @item auto
 The default libass shaping engine, which is the best available.
 @item simple
-Fast, font-agnostic shaper that can do only substitutions
+Fast, font-agnostic shaper that can do only substitutions.
 @item complex
-Slower shaper using OpenType for substitutions and positioning
+Slower shaper using OpenType for substitutions and positioning. Required
+for correct rendering of complex scripts such as Arabic, Hebrew, Devanagari
+and Thai. Requires libass to be built with HarfBuzz.
 @end table
 
 The default is @code{auto}.
@@ -23389,6 +23392,23 @@ at least libass release 0.17.0 (or LIBASS_VERSION 
0x01600010), @emph{and} libass
 have been built with libunibreak.
 
 The option is enabled by default except for native ASS.
+
+@item shaping
+Set the shaping engine.
+
+Available values are:
+@table @samp
+@item auto
+The default libass shaping engine, which is the best available.
+@item simple
+Fast, font-agnostic shaper that can do only substitutions.
+@item complex
+Slower shaper using OpenType for substitutions and positioning. Required
+for correct rendering of complex scripts such as Arabic, Hebrew, Devanagari
+and Thai. Requires libass to be built with HarfBuzz.
+@end table
+
+The default is @code{auto}.
 @end table
 
 If the first key is not specified, it is assumed that the first value

_______________________________________________
ffmpeg-cvslog mailing list -- [email protected]
To unsubscribe send an email to [email protected]

Reply via email to