Struct BuiltinEditor 

pub struct BuiltinEditor<P: Params> { /* private fields */ }

Built-in editor that renders parameter widgets to a pixel buffer.

Uses the CPU backend (tiny-skia) for software rasterization. When open() is called, creates a baseview window and blits pixels via wgpu.

Implementations

impl<P: Params + 'static> BuiltinEditor<P>

pub fn request_repaint(&self)

Request a repaint on the next idle tick. Call this if plugin code mutates display state outside the normal param or state_changed pathways (uncommon). User interaction and host automation already flag themselves dirty automatically.

pub fn new(params: Arc<P>, layout: PluginLayout) -> Self

pub fn new_with_layout(params: Arc<P>, layout: Layout) -> Self

pub fn new_grid(params: Arc<P>, layout: GridLayout) -> Self

pub fn with_theme(self, theme: Theme) -> Self

pub fn render(&mut self)

Render the full UI to the internal CPU pixel buffer.

Only available when the cpu feature is on. In gpu-only mode, render through Self::render_to with a truce_gpu::WgpuBackend instead.

Panics

Panics if the lazy CpuBackend::new allocation fails (out of memory or zero dimensions). The backend is allocated on first render - subsequent calls reuse it.

pub fn dispatch_events(&mut self, events: &[InputEvent])

Feed a batch of input events through interaction::dispatch and apply the resulting param edits. Flags a repaint when hover, dropdown-open state, or any param moved.

Typically callers build the events by running each baseview event through interaction::BaseviewTranslator and batching the non-None results.

pub fn pixel_data(&self) -> Option<&[u8]>

Get the raw pixel data after rendering (RGBA premultiplied). Only available when the cpu feature is on.

pub fn has_context(&self) -> bool

Whether the editor has an active context.

pub fn take_context(&mut self) -> Option<PluginContext>

Take the editor context, leaving None in its place. Used by hot-reload to preserve the context when swapping editors.

pub fn set_context(&mut self, context: PluginContext)

Set the editor context (host callbacks) without opening the CPU view.

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

Editor logical size (width, height in points). Inherent method so it stays callable when the Editor trait impl is cfg’d out in gpu-only builds.

pub fn state_changed(&mut self)

Notify the widget tree that plugin state was restored (preset recall, undo, session load). Inherent for the same reason as Self::size above.

pub fn render_to(&mut self, backend: &mut dyn RenderBackend)

Render all widgets to an external RenderBackend.

Used by truce-gpu to draw through the GPU backend instead of the internal CPU backend.

Trait Implementations

impl<P: Params + 'static> Editor for BuiltinEditor<P>

Available on crate feature cpu only.

fn size(&self) -> (u32, u32)

Initial window size in logical points.

fn state_changed(&mut self)

Plugin state was restored (preset recall, undo, session load).

fn open(&mut self, parent: RawWindowHandle, context: PluginContext)

Create the GUI as a child of the host-provided parent window.

fn set_scale_factor(&mut self, factor: f64)

Host notifies the editor of a new content scale factor.

fn close(&mut self)

Destroy the GUI.

fn idle(&mut self)

Called ~60fps on the host’s UI thread for repaint/animation.

fn screenshot( &mut self, _params: Arc<dyn Params>, ) -> Option<(Vec<u8>, u32, u32)>

Render a headless screenshot of the editor at its natural size.

fn set_size(&mut self, _width: u32, _height: u32) -> bool

Host requests a resize. Return true to accept.

fn can_resize(&self) -> bool

Whether the plugin supports resizing.

impl<P: Params> Send for BuiltinEditor<P>