Struct WgpuRenderSystem 

pub struct WgpuRenderSystem { /* private fields */ }

The concrete, WGPU-based implementation of the [RenderSystem] trait.

This struct encapsulates all the state necessary to drive rendering with WGPU, including the graphics context, the logical device, GPU profiler, and complex state for handling window resizing gracefully.

It acts as the primary rendering backend for the engine when the WGPU feature is enabled.

Implementations

impl WgpuRenderSystem

pub fn new() -> Self

Creates a new, uninitialized WgpuRenderSystem.

The system is not usable until [RenderSystem::init] is called.

pub fn create_viewport_target( &mut self, width: u32, height: u32, overlay: &mut EguiOverlay, ) -> Result<TextureId, RenderError>

Creates an offscreen render target for the editor viewport and registers it as an egui texture.

Returns the egui::TextureId that can be displayed via [UiBuilder::viewport_image].

pub fn render_viewport_clear( &mut self, clear_color: LinearRgba, ) -> Result<(), RenderError>

Renders a clear pass to the offscreen viewport target.

Call this once per frame (after begin_frame(), before render_overlay()). The cleared image will be visible in the egui viewport panel.

pub fn viewport_size(&self) -> (u32, u32)

Returns the current viewport dimensions (width, height) in pixels.

pub fn create_editor_overlay( &self, event_loop: &ActiveEventLoop, shader_source: &str, ) -> Result<EguiOverlay, RenderError>

Creates an [EguiOverlay] backed by the current wgpu graphics context.

Must be called after [RenderSystem::init].

pub fn create_editor_overlay_and_shell( &mut self, event_loop: &ActiveEventLoop, shader_source: &str, theme: UiTheme, viewport_handle: ViewportTextureHandle, ) -> Result<(EguiOverlay, EguiEditorShell), RenderError>

Creates an [EguiOverlay] and an [EguiEditorShell] that share the same egui::Context, plus an offscreen viewport target.

The overlay handles input / rendering while the shell manages the dock layout, menu bar, toolbar, and panel dispatch. The viewport target is an offscreen texture used to display the 3D scene inside an egui panel.

Trait Implementations

impl Debug for WgpuRenderSystem

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

Formats the value using the given formatter.

impl Default for WgpuRenderSystem

fn default() -> Self

Returns the “default value” for a type.

impl RenderSystem for WgpuRenderSystem

fn init( &mut self, window: &dyn KhoraWindow, ) -> Result<Vec<Arc<dyn ResourceMonitor>>, RenderError>

Initializes the rendering system with a given window.

fn resize(&mut self, new_width: u32, new_height: u32)

Notifies the rendering system that the output window has been resized.

fn prepare_frame(&mut self, view_info: &ViewInfo)

Prepares for a new frame.

fn render( &mut self, renderables: &[RenderObject], _view_info: &ViewInfo, settings: &RenderSettings, ) -> Result<RenderStats, RenderError>

Renders a single frame from a flat list of render objects.

fn begin_frame(&mut self) -> Result<FrameTargets, RenderError>

Begins a new visual frame by acquiring the swapchain (or viewport) texture.

fn end_frame(&mut self) -> Result<RenderStats, RenderError>

Ends the current visual frame by presenting the swapchain texture.

fn render_overlay( &mut self, overlay: &mut dyn EditorOverlay, screen: OverlayScreenDescriptor, ) -> Result<(), RenderError>

Renders an editor overlay on top of the current frame.

fn get_last_frame_stats(&self) -> &RenderStats

Returns a reference to the statistics of the last successfully rendered frame.

fn supports_feature(&self, feature_name: &str) -> bool

Checks if a specific, optional rendering feature is supported by the backend.

fn shutdown(&mut self)

Cleans up and releases all graphics resources.

fn as_any(&self) -> &dyn Any

Allows downcasting to a concrete RenderSystem type.

fn as_any_mut(&mut self) -> &mut dyn Any

Allows mutable downcasting to a concrete RenderSystem type.

fn render_to_viewport(&self) -> bool

Whether begin_frame targets an offscreen viewport instead of the swapchain.

fn set_render_to_viewport(&mut self, enabled: bool)

Toggles whether begin_frame targets the offscreen viewport texture instead of the swapchain.

fn get_adapter_info(&self) -> Option<GraphicsAdapterInfo>

Returns information about the active graphics adapter (GPU).

fn graphics_device(&self) -> Arc<dyn GraphicsDevice>

Returns a shared, thread-safe reference to the underlying GraphicsDevice.

impl Send for WgpuRenderSystem

impl Sync for WgpuRenderSystem