dear-imgui-wgpu 0.14.0

WGPU renderer backend for dear-imgui-rs (native + WebAssembly)
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
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126

use super::result::mark_texture_destroyed;
use super::*;
use dear_imgui_rs::texture::{TextureData, TextureFormat as ImFormat, TextureRect};

#[test]
fn texture_update_result_apply_to_sets_status_and_id() {
    let mut tex = TextureData::new();

    // Created -> sets TexID and OK
    TextureUpdateResult::Created {
        texture_id: TextureId::from(42u64),
    }
    .apply_to(&mut tex);
    assert_eq!(tex.status(), TextureStatus::OK);
    assert_eq!(tex.tex_id().id(), 42);

    // Updated -> only status OK
    TextureUpdateResult::Updated.apply_to(&mut tex);
    assert_eq!(tex.status(), TextureStatus::OK);
    assert_eq!(tex.tex_id().id(), 42);

    // Destroyed -> status Destroyed
    // `apply_to` owns the ImTextureData status writeback, including Dear ImGui's
    // WantDestroyNextFrame precondition.
    TextureUpdateResult::Destroyed.apply_to(&mut tex);
    assert_eq!(tex.status(), TextureStatus::Destroyed);
    unsafe {
        assert!((*tex.as_raw()).WantDestroyNextFrame);
    }

    // Failed -> also marks Destroyed
    // In the general case (not a requested destroy), SetStatus(Destroyed) translates to WantCreate.
    unsafe {
        (*tex.as_raw_mut()).WantDestroyNextFrame = false;
    }
    tex.create(ImFormat::RGBA32, 1, 1);
    TextureUpdateResult::Failed.apply_to(&mut tex);
    assert_eq!(tex.status(), TextureStatus::WantCreate);

    // NoAction -> leaves state unchanged
    TextureUpdateResult::NoAction.apply_to(&mut tex);
    assert_eq!(tex.status(), TextureStatus::WantCreate);
}

#[test]
fn mark_texture_destroyed_sets_destroy_next_frame_and_status() {
    let mut tex = TextureData::new();
    tex.create(ImFormat::RGBA32, 1, 1);

    mark_texture_destroyed(&mut tex);
    assert_eq!(tex.status(), TextureStatus::Destroyed);
    unsafe {
        assert!((*tex.as_raw()).WantDestroyNextFrame);
    }
}

#[test]
fn convert_subrect_to_rgba_rgba32_full_rect() {
    let mut tex = TextureData::new();
    let width = 2;
    let height = 2;
    tex.create(ImFormat::RGBA32, width, height);

    // 2x2 RGBA pixels: row-major
    let pixels: [u8; 16] = [
        10, 20, 30, 40, // (0,0)
        50, 60, 70, 80, // (1,0)
        90, 100, 110, 120, // (0,1)
        130, 140, 150, 160, // (1,1)
    ];
    tex.set_data(&pixels);

    let rect = TextureRect {
        x: 0,
        y: 0,
        w: width as u16,
        h: height as u16,
    };

    let out = WgpuTextureManager::convert_subrect_to_rgba(&tex, rect).expect("expected data");
    assert_eq!(out, pixels);
}

#[test]
fn convert_subrect_to_rgba_alpha8_full_rect() {
    let mut tex = TextureData::new();
    let width = 2;
    let height = 2;
    tex.create(ImFormat::Alpha8, width, height);

    // 2x2 alpha-only pixels
    let alphas: [u8; 4] = [0, 64, 128, 255];
    tex.set_data(&alphas);

    let rect = TextureRect {
        x: 0,
        y: 0,
        w: width as u16,
        h: height as u16,
    };

    let out = WgpuTextureManager::convert_subrect_to_rgba(&tex, rect).expect("expected data");
    // Each alpha should expand to [255,255,255,a]
    assert_eq!(
        out,
        vec![
            255, 255, 255, 0, // a=0
            255, 255, 255, 64, // a=64
            255, 255, 255, 128, // a=128
            255, 255, 255, 255, // a=255
        ]
    );
}

#[test]
fn convert_subrect_to_rgba_out_of_bounds_returns_none() {
    let mut tex = TextureData::new();
    tex.create(ImFormat::RGBA32, 2, 2);
    let rect = TextureRect {
        x: 10,
        y: 10,
        w: 1,
        h: 1,
    };
    assert!(WgpuTextureManager::convert_subrect_to_rgba(&tex, rect).is_none());
}