noesis_runtime 0.12.0

Rust bindings for the Noesis GUI Native SDK: load XAML UI, drive the view and renderer, and write custom controls in Rust. Renderer-agnostic; Bevy integration lives in noesis_bevy.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99

#include "noesis_shim.h"

#include <NsCore/Noesis.h>
#include <NsCore/Init.h>
#include <NsCore/Log.h>
#include <NsCore/Version.h>
#include <NsGui/IntegrationAPI.h>

namespace {

noesis_log_fn g_log_cb       = nullptr;
void*            g_log_userdata = nullptr;

void log_trampoline(const char* file, uint32_t line, uint32_t level,
                    const char* channel, const char* message)
{
    if (g_log_cb) {
        g_log_cb(g_log_userdata, file, line,
                 static_cast<noesis_log_level>(level),
                 channel ? channel : "",
                 message ? message : "");
    }
}

}  // namespace

extern "C" void noesis_set_license(const char* name, const char* key)
{
    Noesis::SetLicense(name ? name : "", key ? key : "");
}

extern "C" void noesis_set_log_handler(noesis_log_fn cb, void* userdata)
{
    g_log_cb       = cb;
    g_log_userdata = userdata;
    Noesis::SetLogHandler(cb ? log_trampoline : nullptr);
}

// ── Inspector / hot-reload toggles + queries ────────────────────────────────
//
// All GUI:: free calls. The Disable* trio MUST run before GUI::Init (i.e.
// before noesis_init); the query + pump are runtime calls. On a Release
// dylib the Inspector is compiled out, so these degrade to no-ops /
// always-false. See the header for the full reality check.

extern "C" void noesis_disable_hot_reload(void)
{
    Noesis::GUI::DisableHotReload();
}

extern "C" void noesis_disable_socket_init(void)
{
    Noesis::GUI::DisableSocketInit();
}

extern "C" void noesis_disable_inspector(void)
{
    Noesis::GUI::DisableInspector();
}

extern "C" bool noesis_is_inspector_connected(void)
{
    return Noesis::GUI::IsInspectorConnected();
}

extern "C" void noesis_update_inspector(void)
{
    Noesis::GUI::UpdateInspector();
}

extern "C" void noesis_init(void)
{
    Noesis::Init();
}

// Forward declarations for the per-subsystem shutdown sweeps. Defined in
// noesis_classes.cpp / noesis_markup.cpp respectively.
extern "C" void noesis_classes_force_free_at_shutdown(void);
extern "C" void noesis_markup_extensions_force_free_at_shutdown(void);
extern "C" void noesis_plain_vm_force_free_at_shutdown(void);

extern "C" void noesis_shutdown(void)
{
    // Order matters: Noesis::Shutdown must run first to destroy every
    // live DependencyObject (which fires their refcount-driven Release
    // calls into our trampolines, naturally freeing most handler boxes).
    // The sweeps then defensively free any handler boxes whose owning
    // instances bypassed normal teardown, a belt-and-suspenders for
    // orphaned-View paths that never `drop`-ed before shutdown.
    Noesis::Shutdown();
    noesis_classes_force_free_at_shutdown();
    noesis_markup_extensions_force_free_at_shutdown();
    noesis_plain_vm_force_free_at_shutdown();
}

extern "C" const char* noesis_version(void)
{
    return Noesis::GetBuildVersion();
}