rusteal-core 0.5.0

Safe Rust runtime for rusteal (object refs, lifecycle, dynamic calls)
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

// Widget creation and WidgetTree management (raw handle versions).
// Type-safe wrappers live in rusteal-bindings/src/manual/widget_ext.rs.

use rusteal_ffi::{UClassHandle, UObjectHandle};

use crate::error::{check_ffi, RustealError, RustealResult};
use crate::ffi_dispatch;

/// Create a UMG widget using the C++ `CreateWidget<T>()` template.
///
/// - `owning_object`: a PlayerController, World, or GameInstance handle
/// - `widget_class`: the UClass of the UUserWidget subclass to create
pub fn create_widget_raw(
    owning_object: UObjectHandle,
    widget_class: UClassHandle,
) -> RustealResult<UObjectHandle> {
    let result = unsafe {
        ffi_dispatch::widget_create_widget(owning_object, widget_class)
    };
    if result.is_null() {
        Err(RustealError::InvalidOperation("create_widget returned null".into()))
    } else {
        Ok(result)
    }
}

/// Set the root widget of a UUserWidget's WidgetTree.
pub fn set_root_widget_raw(
    user_widget: UObjectHandle,
    root_widget: UObjectHandle,
) -> RustealResult<()> {
    check_ffi(unsafe {
        ffi_dispatch::widget_set_root_widget(user_widget, root_widget)
    })
}

/// Get the WidgetTree UObject from a UUserWidget.
pub fn get_widget_tree_raw(
    user_widget: UObjectHandle,
) -> RustealResult<UObjectHandle> {
    let result = unsafe {
        ffi_dispatch::widget_get_widget_tree(user_widget)
    };
    if result.is_null() {
        Err(RustealError::InvalidOperation("get_widget_tree returned null".into()))
    } else {
        Ok(result)
    }
}