[FFmpeg-devel] [PATCH v2] doc/filters: drawtext: add example of printing texts on same baseline

[Andrey Utkin]

Height of canvas produced by drawtext varies depending on symbols in
text, so add example for printing separate texts aligned horizontally.

Wording suggested by Lou Logan <lou at lrcd.com>

Signed-off-by: Andrey Utkin <andrey.utkin at pb.com>
---
Changes in v2:
 * Taken the wording of example and description Lou proposed
 * Added mention of @var{max_glyph_a} to "Note that..." phrase
   (is the markup used for this correct?)
 * Slightly edited commit message for clarity of meaning
   (dimensions vary -> height varies)

 doc/filters.texi | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/doc/filters.texi b/doc/filters.texi
index 3ae3c46d26..97ff517054 100644
--- a/doc/filters.texi
+++ b/doc/filters.texi
@@ -7135,6 +7135,14 @@ FOD=5 # fade out duration
 ffplay -f lavfi "color,drawtext=text=TEST:fontsize=50:fontfile=FreeSerif.ttf:fontcolor_expr=ff0000%@{eif\\\\: clip(255*(1*between(t\\, $DS + $FID\\, $DE - $FOD) + ((t - $DS)/$FID)*between(t\\, $DS\\, $DS + $FID) + (-(t - $DE)/$FOD)*between(t\\, $DE - $FOD\\, $DE) )\\, 0\\, 255) \\\\: x\\\\: 2 @}"
 @end example

+ at item
+Horizontally align multiple separate texts. Note that @var{max_glyph_a} and the
+ at option{fontsize} value are included in the @option{y} offset.
+ at example
+drawtext=fontfile=FreeSans.ttf:text=DOG:fontsize=24:x=10:y=20+24-max_glyph_a,
+drawtext=fontfile=FreeSans.ttf:text=cow:fontsize=24:x=80:y=20+24-max_glyph_a
+ at end example
+
 @end itemize

 For more information about libfreetype, check:
--
2.11.0.rc2


________________________________