dear-imgui-wgpu 0.17.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

//! Main WGPU renderer implementation
//!
//! This module contains the main WgpuRenderer struct and its implementation,
//! following the pattern from imgui_impl_wgpu.cpp
//!
//! Managed texture flow (Dear ImGui 1.92+):
//! - `Context::render(renderer.renderer_consumer()?)` returns a Context-borrowed `PendingFrame`.
//! - WGPU consumes every managed-texture request before producing a drawable `ReconciledFrame`.
//! - WGPU stores managed GPU resources by pointer-free `SnapshotTextureId`.
//! - Legacy application textures continue to use `TextureId` without entering this protocol.

mod callbacks;
mod core;
mod init;
mod lifecycle;
mod render;

mod draw;
mod external_textures;
#[cfg(feature = "multi-viewport-winit")]
pub mod multi_viewport;
#[cfg(any(feature = "multi-viewport-winit", feature = "multi-viewport-sdl3"))]
mod multi_viewport_runtime;
#[cfg(feature = "multi-viewport-sdl3")]
pub mod multi_viewport_sdl3;
#[cfg(feature = "multi-viewport-sdl3")]
mod multi_viewport_sdl3_adapter;
#[cfg(feature = "multi-viewport-winit")]
mod multi_viewport_winit_adapter;
mod pipeline;
#[cfg(feature = "multi-viewport-sdl3")]
mod sdl3_raw_window_handle;

use crate::{RendererError, RendererResult, Uniforms, WgpuBackendData, WgpuTextureManager};
pub use core::WgpuRenderer;
use dear_imgui_rs::render::{RendererRenderStateGuard, RendererRenderStateGuardError};
pub use draw::FramebufferExtent;

pub(super) fn map_renderer_render_state_error(
    error: RendererRenderStateGuardError,
) -> RendererError {
    match error {
        RendererRenderStateGuardError::MissingPlatformIo => RendererError::InvalidRenderState(
            "PlatformIO not available for renderer render state".to_owned(),
        ),
        RendererRenderStateGuardError::AlreadyOccupied => RendererError::InvalidRenderState(
            "PlatformIO Renderer_RenderState is already occupied".to_owned(),
        ),
        RendererRenderStateGuardError::Drift => RendererError::RendererStateDrift {
            field: "Renderer_RenderState",
        },
    }
}