]> git.sesse.net Git - nageru/blobdiff - nageru/scene.h
Fix a comment typo.
[nageru] / nageru / scene.h
index fc36963cc9eebd3ae56943293e9c74ce71886ea5..4e1181bbf4cf9f504625d5eae9708db79a057ba1 100644 (file)
@@ -9,10 +9,11 @@
 // ResizeEffect or IdentityEffect (effectively doing nothing), or many
 // different input types. On finalization, every different combination of
 // block alternatives are tried, and one EffectChain is generated for each.
-// This also goes for whether the chain is destined for preview outputs
+// This also goes for whether the scene is destined for preview outputs
 // (directly to screen, RGBA) or live (Y'CbCr output).
 
 #include <stddef.h>
+#include <bitset>
 #include <functional>
 #include <map>
 #include <memory>
@@ -64,7 +65,7 @@ struct Block {
        // where C_0 = 0 and C_(i+1) = C_i * B_i. In other words, C_i is
        // the product of the cardinalities of each previous effect; if we
        // are e.g. at the third index and there have been C_2 = 3 * 5 = 15
-       // different alternatives for constructing the chain so far
+       // different alternatives for constructing the scene so far
        // (with possible indexes 0..14), it is only logical that if we
        // want three new options (B_2 = 3), we must add 0, 15 or 30 to
        // the index. (Then the local possible indexes become 0..44 and
@@ -76,9 +77,37 @@ struct Block {
        // (B_i is alternatives.size().) Not set before finalize() has run.
        size_t cardinality_base = 0;
 
+       // Find the chosen alternative for this block in a given instance.
+       int chosen_alternative(size_t chain_idx) const {
+               if (chain_idx == size_t(-1)) {
+                       return currently_chosen_alternative;
+               } else {
+                       return (chain_idx / cardinality_base) % alternatives.size();
+               }
+       }
+
        std::vector<EffectBlueprint *> alternatives;  // Must all have the same amount of inputs. Pointers to make things easier for Lua.
        std::vector<Index> inputs;  // One for each input of alternatives[0] (ie., typically 0 or 1, occasionally 2).
+
+       // If any of these effects are disabled (IdentityEffect chosen)
+       // or enabled (not chosen) as determined by <condition>, so should this one.
+       struct Disabler {
+               Index block_idx;
+               enum {
+                       DISABLE_IF_OTHER_DISABLED,
+
+                       // This a promise from the user; ie., we don't disable automatically
+                       // (see comments in find_disabled_blocks()).
+                       DISABLE_IF_OTHER_ENABLED
+               } condition;
+               std::string declaration_point;  // For error messages.
+       };
+       std::vector<Disabler> disablers;
        int currently_chosen_alternative = 0;
+       // What alternative to use if the block is disabled.
+       // Points to an alternative with IDENTITY_EFFECT if it exists
+       // (to disable as much as possible), otherwise 0.
+       int canonical_alternative = 0;
        bool is_input = false;
 
        // For LIVE_INPUT* only. We can't just always populate signal_to_connect,
@@ -100,12 +129,21 @@ struct Block {
        std::map<std::string, float> float_parameters;
        std::map<std::string, std::array<float, 3>> vec3_parameters;
        std::map<std::string, std::array<float, 4>> vec4_parameters;
+
+       std::string declaration_point;  // For error messages.
+
+       // Only for AUTO_WHITE_BALANCE_EFFECT. Points to the parent block with is_input = true,
+       // so that we know which signal to get the white balance from.
+       const Block *white_balance_controller_block = nullptr;
 };
 
 int Block_display(lua_State* L);
 int Block_choose(lua_State* L);
 int Block_enable(lua_State *L);
+int Block_enable_if(lua_State *L);
 int Block_disable(lua_State *L);
+int Block_always_disable_if_disabled(lua_State *L);
+int Block_promise_to_disable_if_enabled(lua_State *L);
 int Block_set_int(lua_State *L);
 int Block_set_float(lua_State *L);
 int Block_set_vec3(lua_State *L);
@@ -127,7 +165,32 @@ private:
        movit::ResourcePool *resource_pool;
 
        movit::Effect *instantiate_effects(const Block *block, size_t chain_idx, Instantiation *instantiation);
-       size_t compute_chain_number_for_block(size_t block_idx) const;
+       size_t compute_chain_number_for_block(size_t block_idx, const std::bitset<256> &disabled) const;
+       static void find_inputs_for_block(lua_State *L, Scene *scene, Block *block, int first_input_idx = 3);
+       static Block *find_block_from_arg(lua_State *L, Scene *scene, int idx);
+
+       // Find out which blocks (indexed by position in the “blocks” array),
+       // if any, are disabled in a given instantiation. A disabled block is
+       // one that will not be instantiated at all, because it is a secondary
+       // (ie., not the first) input of some multi-input effect that was replaced
+       // with IdentityEffect in the given instantiation.
+       //
+       // Set chain_idx to size_t(-1) to use whatever is in each block's
+       // currently_chosen_alternative.
+       std::bitset<256> find_disabled_blocks(size_t chain_idx) const;
+       void find_disabled_blocks(size_t chain_idx, size_t block_idx, bool currently_disabled, std::bitset<256> *disabled) const;
+
+       // If a block is disabled, it should always have canonical_alternative chosen,
+       // so that we don't instantiate a bunch of irrelevant duplicates that
+       // differ only in disabled blocks. You can check this property with
+       // is_noncanonical_chain() and then avoid instantiating the ones where
+       // it returns true.
+       bool is_noncanonical_chain(size_t chain_idx) const;
+
+       // For a given block, find any parents it may have that are inputs.
+       // If there is more than one, throws an error. If there are zero,
+       // returns nullptr (should probably also be an error).
+       const Block *find_root_input_block(lua_State *L, const Block *block);
 
 public:
        Scene(Theme *theme, float aspect_nom, float aspect_denom);
@@ -139,6 +202,7 @@ public:
        static int add_input(lua_State *L);
        static int add_effect(lua_State *L);
        static int add_optional_effect(lua_State *L);
+       static int add_auto_white_balance(lua_State *L);
        static int finalize(lua_State *L);
 };