summaryrefslogtreecommitdiff
path: root/src/til.h
diff options
context:
space:
mode:
authorVito Caputo <vcaputo@pengaru.com>2021-10-01 16:35:08 -0700
committerVito Caputo <vcaputo@pengaru.com>2021-10-01 16:35:08 -0700
commitb686b405c6a22b26e9b8082c92ed91513608bea3 (patch)
tree0000f671501863a8ee9b536ba869221d0f6710f9 /src/til.h
parentd1da5500261e96efe0ede06fbebb32f0e191f3c1 (diff)
*: librototiller->libtil
Largely mechanical rename of librototiller -> libtil, but introducing a til_ prefix to all librototiller (now libtil) functions and types where a rototiller prefix was absent. This is just a step towards a more libized librototiller, and til is just a nicer to type/read prefix than rototiller_.
Diffstat (limited to 'src/til.h')
-rw-r--r--src/til.h37
1 files changed, 37 insertions, 0 deletions
diff --git a/src/til.h b/src/til.h
new file mode 100644
index 0000000..6719693
--- /dev/null
+++ b/src/til.h
@@ -0,0 +1,37 @@
+#ifndef _TIL_H
+#define _TIL_H
+
+#include "til_fb.h"
+
+/* til_fragmenter produces fragments from an input fragment, num being the desired fragment for the current call.
+ * return value of 1 means a fragment has been produced, 0 means num is beyond the end of fragments. */
+typedef int (*til_fragmenter_t)(void *context, const til_fb_fragment_t *fragment, unsigned number, til_fb_fragment_t *res_fragment);
+
+typedef struct til_settings_t settings;
+typedef struct til_setting_desc_t til_setting_desc_t;
+typedef struct til_knob_t til_knob_t;
+
+typedef struct til_module_t {
+ void * (*create_context)(unsigned ticks, unsigned n_cpus);
+ void (*destroy_context)(void *context);
+ void (*prepare_frame)(void *context, unsigned ticks, unsigned n_cpus, til_fb_fragment_t *fragment, til_fragmenter_t *res_fragmenter);
+ void (*render_fragment)(void *context, unsigned ticks, unsigned cpu, til_fb_fragment_t *fragment);
+ void (*finish_frame)(void *context, unsigned ticks, til_fb_fragment_t *fragment);
+ int (*setup)(const til_settings_t *settings, til_setting_desc_t **next_setting);
+ size_t (*knobs)(void *context, til_knob_t **res_knobs);
+ char *name;
+ char *description;
+ char *author;
+ char *license;
+} til_module_t;
+
+int til_init(void);
+void til_quiesce(void);
+void til_shutdown(void);
+const til_module_t * til_lookup_module(const char *name);
+void til_get_modules(const til_module_t ***res_modules, size_t *res_n_modules);
+void til_module_render(const til_module_t *module, void *context, unsigned ticks, til_fb_fragment_t *fragment);
+int til_module_create_context(const til_module_t *module, unsigned ticks, void **res_context);
+int til_module_setup(til_settings_t *settings, til_setting_desc_t **next_setting);
+
+#endif
© All Rights Reserved