From b9f9ca1fbd67c405084615acc7fff044738417ac Mon Sep 17 00:00:00 2001 From: "Steinar H. Gunderson" Date: Fri, 19 Jul 2019 23:48:56 +0200 Subject: [PATCH] Document number of inputs for alternatives. --- theme.rst | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/theme.rst b/theme.rst index 3fa5873..d43687f 100644 --- a/theme.rst +++ b/theme.rst @@ -184,7 +184,10 @@ directly by the GPU) that instead. The scaling is set up like this:: -- Or by numerical index: input0_scaled:choose(1) -- Chooses ResizeEffect -Note that add_effect returns its input for convenience. +Note that add_effect returns its input for convenience. All alternatives must +have the same amount of inputs, with an exception for IdentityEffect, which can +coexist with an effect requiring any amount of inputs (if selected, the IdentityEffect +just passes its first input unchanged). Actually, add_optional_effect() is just a wrapper around add_effect() with IdentityEffect as the other alternative, and disable() is a convenience version of -- 2.39.2