From: Steinar H. Gunderson <sgunderson@bigfoot.com>
Date: Sat, 20 Jul 2019 09:00:38 +0000 (+0200)
Subject: Document the return value of choose() and how it is useful.
X-Git-Url: https://git.sesse.net/?p=nageru-docs;a=commitdiff_plain;h=6aefe431c763ff5814b3f82c6c3229cb8704c6c5

Document the return value of choose() and how it is useful.
---

diff --git a/theme.rst b/theme.rst
index 2e70ca9..7fbe735 100644
--- a/theme.rst
+++ b/theme.rst
@@ -203,6 +203,9 @@ you must set it directly on the effect::
   input0_scaled:set_int("width", 1280)  -- Set on both alternatives.
   input0_scaled:set_int("height", 720)
 
+  -- This is also possible, as choose() returns the chosen effect:
+  input0_scaled:choose(ResampleEffect):set_float("zoom_y", 1.0001)
+
 Actually, more versions are created than you'd immediately expect.
 In particular, the output format for the live output and all previews are
 different (Y'CbCr versus RGBA), which is also handled transparently for you.