Struct WgpuRenderState 

pub struct WgpuRenderState<'callback> { /* private fields */ }

Scoped access to the WGPU resources selected for a raw draw callback.

This corresponds to ImGui_ImplWGPU_RenderState in the C++ implementation. The value can only be obtained through Self::with_current while the renderer is invoking a raw callback. It cannot outlive that callback scope.

The state borrows the renderer’s device and render pass; it does not own either resource and does not provide access to the Dear ImGui Context.

use dear_imgui_wgpu::WgpuRenderState;

// Callback-scoped resources cannot be returned from the higher-ranked borrow.
let _escaped = unsafe { WgpuRenderState::with_current(|state| state.device()) };

Implementations

impl WgpuRenderState<'_>

pub unsafe fn with_current<R>( callback: impl for<'callback> FnOnce(WgpuRenderState<'callback>) -> R, ) -> Result<R, WgpuRenderStateAccessError>

Borrows the state published for the current raw draw callback.

Safety

This function may only be called from a raw draw callback currently invoked by dear-imgui-wgpu. The current Dear ImGui Context must be the renderer owner and its Renderer_RenderState slot must still contain the WGPU state installed for this callback. The callback must not replace that slot while callback is running.

The higher-ranked closure prevents references to the render pass from escaping the callback scope. Recursive access is rejected at runtime.

pub fn device(&self) -> &Device

Returns the renderer device for the callback duration.

pub fn render_pass(&mut self) -> &mut RenderPass<'_>

Returns the active render pass for the duration of this borrow.

pub fn resources(&mut self) -> (&Device, &mut RenderPass<'_>)

Returns the device and render pass as disjoint callback-scoped borrows.

Trait Implementations

impl<'callback> Debug for WgpuRenderState<'callback>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.