summaryrefslogtreecommitdiff
path: root/src/rototiller.h
diff options
context:
space:
mode:
authorVito Caputo <vcaputo@pengaru.com>2020-01-25 17:26:54 -0800
committerVito Caputo <vcaputo@pengaru.com>2020-01-25 17:38:27 -0800
commit6385931985fa6fa8dd7ed69c20785d6b8d9cf37a (patch)
tree8fd19a7f72e60202367b417827112f7a57c0f24e /src/rototiller.h
parent792d0a60dd05035435574633c4a13a666fe6ce5d (diff)
rototiller: introduce ticks and wire up to modules
Most modules find themselves wanting some kind of "t" value increasing with time or frames rendered. It's common for them to create and maintain this variable locally, incrementing it with every frame rendered. It may be interesting to introduce a global notion of ticks since rototiller started, and have all modules derive their "t" value from this instead of having their own private versions of it. In future modules and general innovations it seems likely that playing with time, like jumping it forwards and backwards to achieve some visual effects, will be desirable. This isn't applicable to all modules, but for many their entire visible state is derived from their "t" value, making them entirely reversible. This commit doesn't change any modules functionally, it only adds the plumbing to pull a ticks value down to the modules from the core. A ticks offset has also been introduced in preparation for supporting dynamic shifting of the ticks value, though no API is added for doing so yet. It also seems likely an API will be needed for disabling the time-based ticks advancement, with functions for explicitly setting its value. If modules are created for incorporating external sequencers and music coordination, they will almost certainly need to manage the ticks value explicitly. When a sequencer jumps forwards/backwards in the creative process, the module glue responsible will need to keep ticks synchronized with the sequencer/editor tool. Before any of this can happen, we need ticks as a first-class core thing shared by all modules. Future commits will have to modify existing modules to use the ticks appropriately, replacing their bespoke variants.
Diffstat (limited to 'src/rototiller.h')
-rw-r--r--src/rototiller.h10
1 files changed, 5 insertions, 5 deletions
diff --git a/src/rototiller.h b/src/rototiller.h
index 70b9ef2..4561ae5 100644
--- a/src/rototiller.h
+++ b/src/rototiller.h
@@ -11,11 +11,11 @@ typedef struct settings_t settings;
typedef struct setting_desc_t setting_desc_t;
typedef struct rototiller_module_t {
- void * (*create_context)(unsigned n_cpus);
+ void * (*create_context)(unsigned ticks, unsigned n_cpus);
void (*destroy_context)(void *context);
- void (*prepare_frame)(void *context, unsigned n_cpus, fb_fragment_t *fragment, rototiller_fragmenter_t *res_fragmenter);
- void (*render_fragment)(void *context, unsigned cpu, fb_fragment_t *fragment);
- void (*finish_frame)(void *context, fb_fragment_t *fragment);
+ void (*prepare_frame)(void *context, unsigned ticks, unsigned n_cpus, fb_fragment_t *fragment, rototiller_fragmenter_t *res_fragmenter);
+ void (*render_fragment)(void *context, unsigned ticks, unsigned cpu, fb_fragment_t *fragment);
+ void (*finish_frame)(void *context, unsigned ticks, fb_fragment_t *fragment);
char *name;
char *description;
char *author;
@@ -25,6 +25,6 @@ typedef struct rototiller_module_t {
const rototiller_module_t * rototiller_lookup_module(const char *name);
void rototiller_get_modules(const rototiller_module_t ***res_modules, size_t *res_n_modules);
-void rototiller_module_render(const rototiller_module_t *module, void *context, fb_fragment_t *fragment);
+void rototiller_module_render(const rototiller_module_t *module, void *context, unsigned ticks, fb_fragment_t *fragment);
#endif
© All Rights Reserved