You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Plugins process, reset and flush parameters with subnormal numbers flushed to zero, as inputs
and as results (MXCSR FTZ and DAZ on x86-64, FPCR.FZ on AArch64), in the helper and through the
direct formats API. Denormal arithmetic no longer slows plugins that do not protect themselves,
and output changes only for samples at subnormal level (about −758 dBFS). The calling thread's
mode is restored after each call; out-of-process AUv3 extensions keep their own.
VST3 state saves, tail reads and bus, port and capability queries, and Audio Unit state saves,
bypass, factory preset, bus and capability queries no longer hold the lock the processing thread
takes for each block, as both formats let the owning thread make them while the plugin
processes. A slow state save no longer holds up processing on another thread.
Added
Isolated realtime processing. Chain::realtime_endpoint creates a RealtimeEndpoint for the
prepared chain, which the application's audio callback owns: each callback of the configured
quantum hands its input to the helper through shared memory and plays the chain's output for
the quantum it submitted one to three callbacks before, without waiting, locking or allocating.
When that output is missing the callback plays silence or, for effects, the input delayed by the
whole latency (Fallback::Dry), ramping into and out of it over one quantum. Without misses the
output is the offline output, latency * quantum frames later. Chain::start_realtime and stop_realtime run the helper's worker, and realtime_status reports misses, overflows,
callbacks of another size, failed quanta and late completions; last_completion says how long
the helper took for the output a callback just played. After a resync, stop the endpoint, reset the chain and start it again. While the endpoint runs, restore_state, presets, select_factory_preset, reset, prepare_audio, reprepare and processing through the chain
fail with Error::RealtimeRunning; parameter edits, state saves and editors go on.
A VST3 or CLAP restart request while the endpoint runs is reported through take_changes and
the stream goes on with the plugin's current activation; prepare the chain again after stopping.
The helper's worker runs with the time-constraint policy in a workgroup interval of its own and
keeps App Nap away on macOS, and in the MMCSS "Pro Audio" task on Windows.
The realtime example plays a chain through the default output device with a realtime
endpoint and recovers it after a resynchronization. It asks the device for callbacks of one
quantum, or of the device's nearest callback size, such as WASAPI's shared-mode period. The realtime benchmark calls an endpoint at the audio rate from a realtime thread and fails when
the helper completes a quantum late, the endpoint resynchronizes, callbacks at p99.9 take
longer than their limit, or a callback takes longer than its quantum.
The realtime-audit feature of plughost marks the realtime endpoint's callback for the
real-time audit, and plughost_core::audit::processing_allocations returns the allocations and
frees it counted.
plughost_formats::BlockProcessor::defer_restart lets blocks go on while a VST3 or CLAP
restart request waits, instead of failing with FailureKind::RestartRequired.
plughost_formats::clap::classes_once_loaded lists a CLAP module's classes and reports when
its entry has initialized, before the classes are read and the entry is deinitialized.
Fixed
VST3 parameter_details and parameter_choices no longer fail with a parameter group error
for plugins that leave the root unit out of their unit list, as the VST3 SDK examples do. The
group path ends below the implicit root.
VST3 set_bypass works before prepare_audio, like bypass, set_parameter on the bypass
parameter and the CLAP and Audio Unit bypass, instead of failing with NotPrepared.
audio_configurations returns an empty list for CLAP plugins without the audio-ports-config
extension, as for VST3 and Audio Units, instead of failing with an unsupported-audio error.
reset succeeds for CLAP plugins that are not prepared yet, as for VST3 and Audio Units, so Chain::reset before prepare_audio no longer fails for chains with a CLAP slot.
A Timeouts field too long to end at a representable instant, such as Duration::MAX, waits
without a deadline instead of panicking in the application.
Preparing a prepared chain again, including reprepare() after a CLAP restart request, no
longer fails for plugins that cannot save their state, such as CLAP plugins without the state
extension. Such a slot is prepared again in place after the others are staged; a failure from
then on leaves the chain unprepared instead of preserving it.
A failed reconfiguration keeps the diagnostics of every staged instance it discards, not
only of the instance that failed, and a crash or hang while a reconfiguration releases replaced
or discarded instances names their slot.
Restoring state, importing or loading a preset and selecting a factory preset keep the slot's
native bypass unless the state or preset sets it. Audio Unit bypass, which unit state does not
hold, was lost on restore, and factory preset selection reset bypass in every format.
A TailPolicy::UntilSilence hold close to the largest representable length no longer
overflows and panics while the tail is scanned in large blocks.
RenderError::SessionClosed is classified as FailureKind::Closed instead of NotPrepared:
the session finished, was cancelled or failed, and preparing the processor again does not
reopen it.
Failures of preset_providers and discover_presets name no slot; they reported slot 0 of a
chain that does not exist.
A bundle that changed since it failed reports no failures and is not shown as excluded when its
scan is interrupted or its helper cannot start; the stale cache entry still counted.
The VST3 host reports INoteExpressionController as supported through IPlugInterfaceSupport, since it reads note expressions from it; plugins that check first no
longer conclude that the host ignores them.
Audio Unit class IDs load whatever the case of their hexadecimal digits, as ScanPolicy already
matches them; a lowercase ID failed to instantiate.
Audio Unit parameter_to_plain and parameter_text round discrete parameters to the whole
value that set_parameter and automation select, instead of converting a fraction that units
truncate to a different choice.
A VST3 module whose entry succeeded but that provides no factory is exited with bundleExit
or ExitDll before it is released, as the VST3 SDK hosts do.
The RenderError::Events message no longer calls render events MIDI messages on existing ports;
ports a processor lacks fail Process::validate_events instead.
Scan helpers report ScanStage::ModuleLoaded as soon as a module has loaded, as documented,
instead of after its classes were read and it was unloaded, so loading and the work after it
each get the stall timeout instead of sharing one.
Direct CLAP use: HostedPlugin::prepare after a prepare_audio that left ports out no longer
fails with an unsupported-audio error for plugins without audio port activation, whose ports
stayed active.
Direct VST3 use: preparing a prepared plugin again holds the values block automation left,
instead of the controller's older values, until the next block's first point.
On macOS, a window size that a resizable editor refuses returns the window to the size the editor
last accepted, as on Windows, instead of keeping the refused size and offering it again on every
tick.
On Windows, an editor smaller or larger than the system lets a window be keeps the window at the
size the system gave it. The window used to be resized on every tick, and a resizable editor
was offered that size each time.
CLAP audio and note ports are scanned only while the plugin is inactive, as CLAP requires. An
active plugin answers bus, event port and capability queries, including the helper's own after
each preparation, with the ports it was activated with.