Home /Modules/impl/sleela_idea_canvas.h

sleela_idea_canvas.h

impl/core/sleela_idea_canvas.h · 64 line(s) · c

/*
 * impl/core/sleela_idea_canvas.h
 * SLeeLa VM <-> Idea System(TM) realtime canvas bridge (idea/realtime).
 *
 * Idea System(TM) / Idea(TM).  From Author; distributive.
 *
 * A thin C bridge the VM core (sleela_core.c) calls to drive the native-CPU
 * rendering + physics canvas.  It forwards to the module's public C ABI
 * (idea/realtime/idea_canvas.h) when the VM is built with
 * SLEELA_WITH_IDEA_CANVAS, and otherwise provides a no-op stub so the opcodes
 * still exist and report "no native canvas" (handle -1 / NO_RENDERER).
 *
 * All functions are safe to call unconditionally from the C core.
 */
#ifndef SLEELA_IDEA_CANVAS_H
#define SLEELA_IDEA_CANVAS_H

#ifdef __cplusplus
extern "C" {
#endif

/* 1 if this VM was built with the native canvas linked in, else 0. */
int sl_idea_canvas_available(void);

/* Lifecycle. create returns an opaque module handle as a pointer-sized int in
 * the host (we expose it to the VM as an int slot index via the VM table, so
 * these take/return the module's own idea_canvas* behind a void*). */
void *sl_idea_canvas_create(int cols, int rows);
void  sl_idea_canvas_destroy(void *c);

int sl_idea_canvas_cols(void *c);
int sl_idea_canvas_rows(void *c);
int sl_idea_canvas_count(void *c);

/* Physics (native CPU). */
int    sl_idea_canvas_set_params(void *c, double decay, double flow_gain,
                                 double hue_base, double coupling);
int    sl_idea_canvas_excite(void *c, int col, int row, double amount);
int    sl_idea_canvas_step(void *c, double dt);
int    sl_idea_canvas_advance(void *c, double frame_dt_seconds);
double sl_idea_canvas_timestep(void);
double sl_idea_canvas_intensity_at(void *c, int col, int row);

/* Backend selection + auto GPU offload. */
int    sl_idea_canvas_set_policy(void *c, int policy);     /* 0 auto,1 cpu,2 gpu */
int    sl_idea_canvas_policy(void *c);
int    sl_idea_canvas_active_backend(void *c);             /* 0 cpu, 1 gpu       */
int    sl_idea_canvas_gpu_available(void);
double sl_idea_canvas_measured_hz(void *c);
int    sl_idea_canvas_migrate(void *c, int target);        /* 0 cpu, 1 gpu       */

/* Render (optional GL). */
int sl_idea_canvas_has_renderer(void);
int sl_idea_canvas_open_window(void *c, int w, int h, const char *title);
int sl_idea_canvas_should_close(void *c);
int sl_idea_canvas_present(void *c);
int sl_idea_canvas_run(void *c, int w, int h, const char *title);

#ifdef __cplusplus
}
#endif

#endif /* SLEELA_IDEA_CANVAS_H */