From c1acca07c3a24f4229e6a3ae3a689cdd5d55a299 Mon Sep 17 00:00:00 2001 From: bol-van Date: Sat, 20 Dec 2025 10:52:04 +0300 Subject: [PATCH] update docs --- docs/manual.md | 10 +++++++--- 1 file changed, 7 insertions(+), 3 deletions(-) diff --git a/docs/manual.md b/docs/manual.md index 5379783..354574b 100644 --- a/docs/manual.md +++ b/docs/manual.md @@ -3298,9 +3298,13 @@ function repeater(ctx, desync) * arg: repeats - количество повторов * arg: stop - не проигрывать однократно последующие инстансы после "instances" * arg: clear - очистить execution plan после повторений +* arg: iff - имя [функции условия](#iff-функции) для продолжения цикла повторов. если не задано - условие всегда true +* arg: neg - инвертировать значение iff. по умолчанию - false Смысл repeater заключен в самом названии - он повторяет последующие инстансы в количестве instances repeats раз. Повторение идет по принципу 1-2-3-1-2-3-1-2-3-4-5-6. 4-5-6 в данном случае - последующие за 1-2-3 инстансы, если instances=3. Если задано stop или clear, 4-5-6 не вызываются. clear дополнительно очищает execution plan - бывает нужно для взаимодействия с вышестоящими оркестраторами. +Функция iff позволяет задать дополнительное динамическое условие продолжения цикла повторов. Если xor(iff, neg) = false, выполнение цикла прерывается. + repeater может сколько угодно раз быть вложенным. В примере последовательность вызова получается : 1 1 1 2 2 2 1 1 1 2 2 2 3. Параметр stop у вложенных инстансов не позволяет выполнить инстансы, не относящиеся к собственному циклу повтора. @@ -3319,7 +3323,7 @@ repeater может сколько угодно раз быть вложенны function condition(ctx, desync) ``` -* arg: iff - имя функции условия, возвращающей boolean +* arg: iff - имя [функции условия](#iff-функции) * arg: neg - инвертировать значение iff. по умолчанию - false condition вызывает iff. если iff xor neg = true, выполняются все инстансы plan, иначе план очищается. @@ -3330,7 +3334,7 @@ condition вызывает iff. если iff xor neg = true, выполняют function condition(ctx, desync) ``` -* arg: iff - имя функции условия, возвращающей boolean +* arg: iff - имя [функции условия](#iff-функции) * arg: neg - инвертировать значение iff. по умолчанию - false stopif вызывает iff. если iff xor neg = true, план очищается, иначе не делается ничего. @@ -3339,7 +3343,7 @@ stopif может быть полезен как вложенный оркест ### iff функции -Они используются в оркестраторах condition и stopif. Берут desync в качестве параметра. +Они используются в нескольких оркестраторах. Берут desync в качестве параметра. Могут содержать любую логику, которую можно запрограммировать на LUA. В базовом комплекте есть несколько iff функций для демонстрации возможностей и тестирования. #### cond_true