PolyphasePluginAPI.h

Go to the documentation of this file.

#pragma once
 
#include <stdint.h>
 
// Platform-specific export/import macros.
// Legacy scaffolds ship with OCTAVE_PLUGIN_EXPORT defined (the pre-rename alias);
// accept either name here so those projects select dllexport correctly. Without this,
// the plugin entry point is treated as dllimport and its definition hits C2491.
#if defined(OCTAVE_PLUGIN_EXPORT) && !defined(POLYPHASE_PLUGIN_EXPORT)
    #define POLYPHASE_PLUGIN_EXPORT
#endif
 
#ifdef _WIN32
    #ifdef POLYPHASE_PLUGIN_EXPORT
        #define POLYPHASE_PLUGIN_API __declspec(dllexport)
    #else
        #define POLYPHASE_PLUGIN_API __declspec(dllimport)
    #endif
#else
    #define POLYPHASE_PLUGIN_API __attribute__((visibility("default")))
#endif
 
// Plugin API version - increment when breaking changes are made
#define POLYPHASE_PLUGIN_API_VERSION 3
 
// Forward declarations
struct PolyphaseEngineAPI;
struct EditorUIHooks;
struct lua_State;
 
struct PolyphasePluginDesc
{
    // Plugin metadata
    uint32_t apiVersion;        // Must match POLYPHASE_PLUGIN_API_VERSION
    const char* pluginName;     // Human-readable plugin name
    const char* pluginVersion;  // Plugin version string (e.g., "1.0.0")
 
    // Lifecycle callbacks
    int (*OnLoad)(PolyphaseEngineAPI* api);    // Called when plugin is loaded, return 0 on success
    void (*OnUnload)();                         // Called before plugin is unloaded
 
    // Tick callbacks (set to nullptr if not needed)
    void (*Tick)(float deltaTime);           // Called during gameplay (PIE or built game)
    void (*TickEditor)(float deltaTime);     // Called in editor regardless of play state (editor builds only)
 
    // Registration callbacks (called after OnLoad)
    void (*RegisterTypes)(void* nodeFactory);           // Register custom node types
    void (*RegisterScriptFuncs)(struct lua_State* L);   // Register Lua bindings
 
    // Editor UI extension (editor builds only, set to nullptr for game-only plugins)
    void (*RegisterEditorUI)(EditorUIHooks* hooks, uint64_t hookId);
 
    void (*OnEditorPreInit)();
 
    void (*OnEditorReady)();
};
 
typedef int (*PolyphasePlugin_GetDescFunc)(PolyphasePluginDesc* outDesc);
 
// Macro for declaring the plugin entry point
#define POLYPHASE_PLUGIN_ENTRY() \
    extern "C" POLYPHASE_PLUGIN_API int PolyphasePlugin_GetDesc(PolyphasePluginDesc* outDesc)
 
// Backwards-compatibility aliases (deprecated, will be removed in a future version)
#ifndef POLYPHASE_NO_LEGACY_MACROS
    #define OCTAVE_PLUGIN_API          POLYPHASE_PLUGIN_API
    #ifndef OCTAVE_PLUGIN_EXPORT
        #define OCTAVE_PLUGIN_EXPORT   POLYPHASE_PLUGIN_EXPORT
    #endif
    #define OCTAVE_PLUGIN_API_VERSION  POLYPHASE_PLUGIN_API_VERSION
    #define OCTAVE_PLUGIN_ENTRY        POLYPHASE_PLUGIN_ENTRY
    #define OctavePluginDesc           PolyphasePluginDesc
    #define OctavePlugin_GetDescFunc   PolyphasePlugin_GetDescFunc
    #define OctavePlugin_GetDesc       PolyphasePlugin_GetDesc
    #define OctaveEngineAPI            PolyphaseEngineAPI
#endif