Home /Modules/gui/sleela_gui_bridge.h

sleela_gui_bridge.h

gui/native/sleela_gui_bridge.h · 55 line(s) · c

#ifndef SLEELA_GUI_BRIDGE_H
#define SLEELA_GUI_BRIDGE_H

#ifdef __cplusplus
extern "C" {
#endif

typedef struct SLGuiBridge SLGuiBridge;

typedef const char *(*SLGuiCallFn)(void *context,
                                   const char *operation,
                                   const char *arguments);

/*
 * Document-change refresh callback (Path 3, native ABI).
 *
 * The native/C++ side invokes this when a watched document changes on an OS
 * call, so the hosted GUI can refresh the running window. document_id is the
 * SLeeLa-facing document name and revision is the OS-derived change
 * fingerprint (last-modified:size); both are NUL-terminated UTF-8. This is the
 * native counterpart of DocumentListener -> SleelaGui.refresh() on the Java
 * side. The document count a host attaches through this bridge is bounded to
 * 1..14 (SLGUI_MIN_DOCUMENTS..SLGUI_MAX_DOCUMENTS) to match the Java listener.
 */
#define SLGUI_MIN_DOCUMENTS 1
#define SLGUI_MAX_DOCUMENTS 14

typedef void (*SLGuiRefreshFn)(void *context,
                               const char *document_id,
                               const char *revision);

SLGuiBridge *slgui_bridge_create(void *context, SLGuiCallFn call);
const char *slgui_bridge_call(SLGuiBridge *bridge,
                              const char *operation,
                              const char *arguments);

/*
 * Register the document-change refresh callback and deliver a change to it.
 * slgui_bridge_on_document_change installs refresh (may be NULL to clear).
 * slgui_bridge_document_changed forwards one change to the installed callback;
 * it is a no-op when no callback is installed. Returns 1 when delivered, else 0.
 */
void slgui_bridge_on_document_change(SLGuiBridge *bridge, SLGuiRefreshFn refresh);
int slgui_bridge_document_changed(SLGuiBridge *bridge,
                                  const char *document_id,
                                  const char *revision);

void slgui_bridge_destroy(SLGuiBridge *bridge);

#ifdef __cplusplus
}
#endif

#endif