Struct StaticShell 

pub struct StaticShell<P: Params, L: PluginLogicCore<S, Params = P>, 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, Params = P> + 'static, S: Sample> StaticShell<P, L, S>

pub fn from_parts(params: Arc<P>, tasks: Option<AnyTaskSpawner>) -> Self

Build the shell from shared params, constructing the initial DSP state via L::init(&params, &cx). The descriptor L is a type-only marker; the shell owns the state it produces. tasks is the plugin’s background-task spawner (Some only when the plugin wired tasks: on plugin!); it reaches init through the InitContext and each block through the ProcessContext.

pub fn meter_store(&self) -> Arc<MeterStore>

Shared meter storage handle - the GUI-thread-safe channel for meter reads (see PluginExport::meter_store).

pub fn snapshot_slot(&self) -> Arc<SnapshotSlot>

Shared snapshot slot for lock-free state save (see PluginExport::snapshot_slot).

pub fn task_spawner(&self) -> Option<AnyTaskSpawner>

The plugin’s background-task spawner (see PluginExport::task_spawner). None unless the plugin wired tasks: on plugin!.

pub fn state_ref(&self) -> &L::DspState

Access the plugin’s DSP state (for testing).

pub fn state_ref_mut(&mut self) -> &mut L::DspState

Mutable access to the plugin’s DSP state (for testing).

Trait Implementations

impl<P: Params + Default + 'static, L: PluginLogicCore<S, Params = P> + 'static, S: Sample> PluginRuntime 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. Default: the standard audio effect - stereo and mono.

fn init(&mut self)

Called once after construction. Not real-time safe.

fn reset(&mut self, config: &AudioConfig)

Called when sample rate, max block size, or processing mode changes. Reset filters, delay lines, etc., and size any mode-dependent buffers off config.process_mode. 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 snapshot_into(&self, buf: &mut Vec<u8>) -> bool

Serialize the plugin’s custom state into buf (cleared on entry) - the real-time path CLAP / VST3 / AU publish to the lock-free slot. Returns whether the plugin publishes snapshots at all (see truce_plugin::PluginLogic::snapshot_into), whose default delegates to save_state, so this covers legacy save_state-only plugins too. Exposed so non-realtime save paths (LV2, the standalone host) can compute live state here instead of reading the version-gated slot. Default: no snapshot.

fn republish_snapshot(&mut self)

Refresh the lock-free snapshot slot from the current state.

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 migrate_state(foreign: &ForeignState<'_>) -> Option<MigratedState>

where Self: Sized,

Translate foreign state - a previous framework’s blob, or a truce envelope saved under a different plugin id - into truce params + extra. Format wrappers call this when the host hands them state that isn’t this plugin’s envelope, so a plugin ported to truce can keep its users’ old sessions and presets.

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).

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, Params = P>, S: Sample> Send for StaticShell<P, L, S>