Struct StaticShell 

pub struct StaticShell<P: Params, L: PluginLogicCore<S>, S: Sample = f32> {
    pub params: Arc<P>,
    /* private fields */
}

A static plugin shell that embeds the user’s PluginLogic impl directly into the format-wrapper binary.

Same bridging as HotShell but without NativeLoader, Mutex, file watching, or any dynamic loading overhead. Use via export_static!.

Fields

params: Arc<P>

Implementations

impl<P: Params + Default + 'static, L: PluginLogicCore<S> + 'static, S: Sample> StaticShell<P, L, S>

pub fn from_parts(params: Arc<P>, logic: L) -> Self

Create from pre-constructed parts. The plugin logic should hold an Arc::clone of the same params.

pub fn logic_ref(&self) -> &L

Access the plugin logic (for testing).

pub fn logic_ref_mut(&mut self) -> &mut L

Mutable access to the plugin logic (for testing).

pub fn try_custom_editor(&self) -> Option<Box<dyn Editor>>

Try to get a custom editor from the plugin logic.

pub fn try_builtin_editor(&self) -> Option<BuiltinEditor<P>>

Try to create a BuiltinEditor from the plugin’s layout. Returns None if the layout has zero size.

Trait Implementations

impl<P: Params + Default + 'static, L: PluginLogicCore<S> + 'static, S: Sample> Plugin for StaticShell<P, L, S>

type Sample = S

The plugin’s chosen audio sample precision. Either f32 (the default - matches host wire format for nearly all formats) or f64 (for plugins whose DSP path runs in f64 end-to-end: high-order biquads, oscillator phase accumulators, long-running cumulative state).

fn info() -> PluginInfo

where Self: Sized,

Static metadata about the plugin.

fn bus_layouts() -> Vec<BusLayout>

where Self: Sized,

Supported bus layouts. The host picks one.

fn init(&mut self)

Called once after construction. Not real-time safe.

fn reset(&mut self, sample_rate: f64, max_block_size: usize)

Called when sample rate or max block size changes. Reset filters, delay lines, etc. Not real-time safe.

fn process( &mut self, buffer: &mut AudioBuffer<'_, S>, events: &EventList, context: &mut ProcessContext<'_>, ) -> ProcessStatus

Real-time audio processing.

fn save_state(&self) -> Vec<u8>

Save extra state beyond parameter values. Empty Vec means “no extra state”: matches the user-facing truce_plugin::PluginLogic::save_state shape so the wrapper bridge is a passthrough rather than an Option<Vec<u8>> to Vec<u8> translation.

fn load_state(&mut self, data: &[u8]) -> Result<(), StateLoadError>

Restore extra state. Matches the user-facing truce_plugin::PluginLogic::load_state Result shape so the wrapper bridge is a passthrough.

fn editor(&mut self) -> Option<Box<dyn Editor>>

GUI editor. Return None for headless plugins.

fn latency(&self) -> u32

Processing latency in samples. Host uses this for delay compensation. Return 0 if the plugin adds no latency (default).

fn tail(&self) -> u32

Tail time in samples. Return u32::MAX for infinite tail. Return 0 for no tail (default).

fn get_meter(&self, meter_id: u32) -> f32

Read a meter value by ID (0.0–1.0). Called by the GUI at ~60fps. Override to expose level meters, gain reduction, etc.

fn supports_in_place() -> bool

where Self: Sized,

Opt into zero-copy in-place I/O. When this returns true, the format wrapper skips its safety memcpy on host-aliased buffers and hands the plugin the raw shared memory through AudioBuffer::in_out_mut(ch). The plugin must check AudioBuffer::is_in_place(ch) per channel before reading input(ch) - for in-place channels input(ch) returns an empty slice, and the data lives only in the shared buffer.

impl<P: Params, L: PluginLogicCore<S>, S: Sample> Send for StaticShell<P, L, S>