@libraz/libsonare 1.5.4 → 1.6.0

package/src/index.ts

@@ -19,7 +19,12 @@
  */
 
 import { setSonareModule } from './module_state';
-import type { RealtimeVoiceChangerPodConfig, VoicePresetId } from './public_types';
+import type {
+  CapabilityCatalog,
+  RealtimeVoiceChangerPodConfig,
+  SonareCapabilities,
+  VoicePresetId,
+} from './public_types';
 import type {
   SonareModule,
   WasmDecomposeResult,
@@ -32,9 +37,11 @@ export { Audio } from './audio';
 export type {
   ClipPageStreamerEngine,
   ClipPageStreamerOptions,
+  ClipPageStreamerRequest,
   ClipPageStreamSource,
   OpfsClipStream,
   OpfsClipStreamOptions,
+  WorkletOpfsClipStreamHost,
 } from './clip_page_streamer';
 export { attachOpfsClipStream, ClipPageStreamer } from './clip_page_streamer';
 export type {
@@ -61,6 +68,7 @@ export type {
   MasteringProcessorCatalogEntry,
   MasteringProcessRequest,
   MasteringProcessStereoRequest,
+  MasteringRealtimeCost,
   MasteringRepairDeclickRequest,
   MasteringRepairDeclipRequest,
   MasteringRepairDecrackleRequest,
@@ -151,18 +159,22 @@ export type {
 } from './effects_transform';
 export { ErrorCode, isSonareError, SonareError } from './errors';
 export type {
+  ChirpRequest,
+  ClicksRequest,
   CyclicTempogramRequest,
   DbConversionRequest,
   EmphasisRequest,
   FixFramesRequest,
   FixLengthRequest,
   FrameSignalRequest,
+  OnsetBacktrackRequest,
   PadCenterRequest,
   PcenRequest,
   PeakPickRequest,
   PlpRequest,
   SilenceRequest,
   TempogramRequest,
+  ToneRequest,
   TonnetzRequest,
   VectorNormalizeRequest,
 } from './feature_core';
@@ -181,7 +193,12 @@ export type {
   VqtRequest,
   VqtToAudioRequest,
 } from './feature_music';
-export type { PitchPyinRequest, PitchYinRequest } from './feature_pitch';
+export type {
+  NoteSegmentsRequest,
+  PiptrackRequest,
+  PitchPyinRequest,
+  PitchYinRequest,
+} from './feature_pitch';
 export type { ResampleRequest } from './feature_resample';
 export type {
   DecomposeRequest,
@@ -195,6 +212,13 @@ export type {
   PitchTuningRequest,
   PolyFeaturesRequest,
   RemixRequest,
+  SegmentAgglomerativeRequest,
+  SegmentCrossSimilarityRequest,
+  SegmentLagToRecurrenceRequest,
+  SegmentPathEnhanceRequest,
+  SegmentRecurrenceMatrixRequest,
+  SegmentRecurrenceToLagRequest,
+  SegmentSubsegmentRequest,
   SpectralContrastRequest,
   SpectralFrameRequest,
   SpectralRolloffRequest,
@@ -203,12 +227,15 @@ export type {
 } from './feature_spectral';
 export type {
   ChromaSpectrogramRequest,
+  GriffinLimRequest,
+  MelDeltaRequest,
   MelSpectrogramRequest,
   MelToAudioRequest,
   MelToStftRequest,
   MfccRequest,
   MfccToAudioRequest,
   MfccToMelRequest,
+  ReassignedSpectrogramRequest,
   SpectrogramRequest,
   TrimRequest,
 } from './feature_spectrogram';
@@ -217,9 +244,11 @@ export {
   analyzeMelody,
   analyzeSections,
   bassChroma,
+  chirp,
   chroma,
   chromaCens,
   chromaCqt,
+  clicks,
   cqt,
   cqtToAudio,
   cyclicTempogram,
@@ -236,6 +265,7 @@ export {
   frameSignal,
   framesToSamples,
   framesToTime,
+  griffinLim,
   hpssWithResidual,
   hybridCqt,
   hzToMel,
@@ -243,6 +273,7 @@ export {
   hzToNote,
   lufs,
   lufsInterleaved,
+  melDelta,
   melSpectrogram,
   melToAudio,
   melToHz,
@@ -254,13 +285,16 @@ export {
   momentaryLufs,
   nnFilter,
   nnlsChroma,
+  noteSegments,
   noteToHz,
+  onsetBacktrack,
   onsetEnvelope,
   onsetStrengthMulti,
   padCenter,
   pcen,
   peakPick,
   phaseVocoder,
+  piptrack,
   pitchPyin,
   pitchTuning,
   pitchYin,
@@ -269,15 +303,24 @@ export {
   powerToDb,
   preemphasis,
   pseudoCqt,
+  reassignedSpectrogram,
   remix,
   resample,
   rmsEnergy,
   samplesToFrames,
+  segmentAgglomerative,
+  segmentCrossSimilarity,
+  segmentLagToRecurrence,
+  segmentPathEnhance,
+  segmentRecurrenceMatrix,
+  segmentRecurrenceToLag,
+  segmentSubsegment,
   shortTermLufs,
   spectralBandwidth,
   spectralCentroid,
   spectralContrast,
   spectralFlatness,
+  spectralFlux,
   spectralRolloff,
   splitSilence,
   stft,
@@ -285,6 +328,7 @@ export {
   tempogram,
   tempogramRatio,
   timeToFrames,
+  tone,
   tonnetz,
   trim,
   trimSilence,
@@ -312,6 +356,7 @@ export type {
   MeteringDynamicRangeOptions,
   MeteringDynamicRangeRequest,
   MeteringSamplesRequest,
+  MeteringSilenceRatioRequest,
   MeteringSpectrumFrameRequest,
   MeteringSpectrumRequest,
   MeteringStereoDecimatedRequest,
@@ -336,6 +381,7 @@ export {
   meteringPhaseScope,
   meteringPhaseScopeDecimated,
   meteringRmsDb,
+  meteringSilenceRatio,
   meteringSpectrum,
   meteringSpectrumFrame,
   meteringStereoCorrelation,
@@ -359,6 +405,9 @@ export type {
   BuiltinSynthBinding,
   BuiltinSynthConfig,
   BuiltinSynthWaveform,
+  ExternalSeparatedStem,
+  ExternalSeparatedStemImportRequest,
+  ExternalSeparatedStemImportResult,
   MidiCcLearnOptions,
   ProjectAssistSidecar,
   ProjectAutomationCurve,
@@ -366,6 +415,7 @@ export type {
   ProjectAutomationPoint,
   ProjectBounceOptions,
   ProjectChordSymbol,
+  ProjectClip,
   ProjectClipCompSegment,
   ProjectClipDesc,
   ProjectClipFade,
@@ -380,6 +430,8 @@ export type {
   ProjectMidiClipResult,
   ProjectMidiEvent,
   ProjectNotePairValidation,
+  ProjectSource,
+  ProjectTrack,
   ProjectTrackDesc,
   ProjectTrackKind,
   ProjectWarpAnchor,
@@ -399,6 +451,7 @@ export type {
   SynthPatch,
 } from './project';
 export {
+  BUILTIN_SYNTH_WAVEFORMS,
   EXPECTED_PROJECT_ABI_VERSION,
   MarkerKind,
   Project,
@@ -425,6 +478,7 @@ export type {
   AnalyzeTimbreOptions,
   AutomationCurve,
   Beat,
+  BpmHypothesis,
   Chord,
   ChordAnalysisResult,
   ChordDetectionOptions,
@@ -448,9 +502,11 @@ export type {
   MasteringChainConfig,
   MasteringChainResult,
   MasteringChainStereoResult,
+  MasteringLoudnessSummary,
   MasteringOptions,
   MasteringPreset,
   MasteringProcessorParams,
+  MasteringReport,
   MasteringResult,
   MasteringStereoChainResult,
   MasteringStereoResult,
@@ -464,6 +520,7 @@ export type {
   MixMeterSnapshot,
   MixOptions,
   MixResult,
+  NoteSegment,
   NoteStretchOptions,
   PairAnalysis,
   PairProcessor,
@@ -481,8 +538,10 @@ export type {
   RoomGeometryOptions,
   RoomMorphOptions,
   Section,
+  SegmentMatrix,
   SendTiming,
   SoloProcessor,
+  SonareCapabilities,
   SpectralEditMode,
   SpectralEditOptions,
   SpectralEditWindow,
@@ -520,8 +579,10 @@ export type {
   DetectAcousticRequest,
   DetectChordsRequest,
   DetectKeyRequest,
+  DetectOnsetsRequest,
   DynamicsAnalysisResult,
   EstimateRoomRequest,
+  MusicAnalyzeRequest,
   RhythmAnalysisResult,
   RoomMorphRequest,
   SamplesRequest,
@@ -557,6 +618,7 @@ export type {
   EngineBounceResult,
   EngineBus,
   EngineCapabilities,
+  EngineCaptureSource,
   EngineCaptureStatus,
   EngineClip,
   EngineFreezeOptions,
@@ -579,7 +641,12 @@ export type {
   ExternalMidiEvent,
   MidiCcBindOptions,
 } from './realtime_engine';
-export { EXPECTED_ENGINE_ABI_VERSION, engineCapabilities, RealtimeEngine } from './realtime_engine';
+export {
+  ClipPageProvider,
+  EXPECTED_ENGINE_ABI_VERSION,
+  engineCapabilities,
+  RealtimeEngine,
+} from './realtime_engine';
 export { scaleCorrectionSemitones, scalePitchClassEnabled, scaleQuantizeMidi } from './scale';
 export type { ProgressCallback } from './sonare.js';
 export { StreamAnalyzer, streamAnalyzerConfigDefaults } from './stream_analyzer';
@@ -620,6 +687,13 @@ export type {
   WebMidiInputInfo,
 } from './web_midi';
 export { bindWebMidi, isWebMidiAvailable } from './web_midi';
+export type {
+  OfflineWorker,
+  OfflineWorkerCallOptions,
+  OfflineWorkerClientOptions,
+  OfflineWorkerProgress,
+} from './worker_client';
+export { OfflineWorkerClient, OfflineWorkerTask } from './worker_client';
 
 /** Row-major 2-D matrix as a flat buffer plus its dimensions. */
 export type Matrix2dResult = WasmMatrix2dResult;
@@ -693,6 +767,26 @@ export function version(): string {
   return module.version();
 }
 
+/**
+ * Return the capabilities of the loaded WASM build.
+ *
+ * This is synchronous and only describes the already-initialized module.
+ */
+export function capabilities(): SonareCapabilities {
+  if (!module) {
+    throw new Error('Module not initialized. Call init() first.');
+  }
+  return module.capabilities();
+}
+
+/** Return the initialized module's processors, parameters, and presets. */
+export function capabilityCatalog(): CapabilityCatalog {
+  if (!module) {
+    throw new Error('Module not initialized. Call init() first.');
+  }
+  return JSON.parse(module.capabilityCatalog()) as CapabilityCatalog;
+}
+
 /**
  * Aggregate native ABI version: the per-subsystem ABI macros folded into one
  * 32-bit value. It bumps whenever any flat C POD layout changes, so callers can
@@ -732,6 +826,9 @@ const VOICE_PRESET_ORDINALS: readonly VoicePresetId[] = [
 
 function resolveVoicePresetOrdinal(preset: VoicePresetId | number): number {
   if (typeof preset === 'number') {
+    if (!Number.isSafeInteger(preset) || preset < 0 || preset >= VOICE_PRESET_ORDINALS.length) {
+      throw new RangeError(`Unknown voice-character preset ordinal: ${String(preset)}`);
+    }
     return preset;
   }
   const ordinal = VOICE_PRESET_ORDINALS.indexOf(preset);
@@ -743,9 +840,9 @@ function resolveVoicePresetOrdinal(preset: VoicePresetId | number): number {
 
 /**
  * Map a voice-character preset ordinal (or canonical id) to its canonical id
- * string (e.g. `'bright-idol'`). Returns `null` for an out-of-range ordinal.
+ * string (e.g. `'bright-idol'`). Invalid ordinals throw.
  */
-export function voiceCharacterPresetId(preset: VoicePresetId | number): string | null {
+export function voiceCharacterPresetId(preset: VoicePresetId | number): string {
   if (!module) {
     throw new Error('Module not initialized. Call init() first.');
   }
@@ -755,11 +852,11 @@ export function voiceCharacterPresetId(preset: VoicePresetId | number): string |
 /**
  * Return the canonical (normalized) flat POD config for a built-in voice
  * preset, skipping the JSON round-trip. Accepts a canonical preset id or its
- * integer ordinal. Returns `null` for an out-of-range ordinal.
+ * integer ordinal. Invalid ordinals throw.
  */
 export function realtimeVoiceChangerPresetConfig(
   preset: VoicePresetId | number,
-): RealtimeVoiceChangerPodConfig | null {
+): RealtimeVoiceChangerPodConfig {
   if (!module) {
     throw new Error('Module not initialized. Call init() first.');
   }

package/src/mastering_chain.ts

@@ -22,6 +22,7 @@ export interface MasteringChainRequest {
   sampleRate?: number;
   config?: MasteringChainConfig;
   onProgress?: ProgressCallback;
+  cancel?: () => boolean;
 }
 
 export interface MasteringChainStereoRequest {
@@ -30,6 +31,7 @@ export interface MasteringChainStereoRequest {
   sampleRate?: number;
   config?: MasteringChainConfig;
   onProgress?: ProgressCallback;
+  cancel?: () => boolean;
 }
 
 /** Canonical request form for one-shot preset mastering. */
@@ -39,6 +41,7 @@ export interface MasterAudioRequest {
   preset?: MasteringPreset;
   overrides?: MasteringChainConfig;
   onProgress?: ProgressCallback;
+  cancel?: () => boolean;
 }
 
 /** Canonical request form for one-shot stereo preset mastering. */
@@ -49,6 +52,7 @@ export interface MasterAudioStereoRequest {
   preset?: MasteringPreset;
   overrides?: MasteringChainConfig;
   onProgress?: ProgressCallback;
+  cancel?: () => boolean;
 }
 
 function masterAudioRequest(
@@ -114,12 +118,13 @@ export function masteringChain(
 ): MasteringChainResult {
   const request =
     samples instanceof Float32Array ? { samples, sampleRate, config, onProgress } : samples;
-  if (request.onProgress) {
+  if (request.onProgress || request.cancel) {
     return requireModule().masteringChainWithProgress(
       request.samples,
       request.sampleRate ?? 22050,
       canonicalChainConfig(request.config ?? {}),
-      request.onProgress,
+      request.onProgress ?? (() => {}),
+      request.cancel ?? (() => false),
     );
   }
   return requireModule().masteringChain(
@@ -162,13 +167,14 @@ export function masteringChainStereo(
   if (request.left.length !== request.right.length) {
     throw new Error('Stereo channel lengths must match.');
   }
-  if (request.onProgress) {
+  if (request.onProgress || request.cancel) {
     return requireModule().masteringChainStereoWithProgress(
       request.left,
       request.right,
       request.sampleRate ?? 22050,
       canonicalChainConfig(request.config ?? {}),
-      request.onProgress,
+      request.onProgress ?? (() => {}),
+      request.cancel ?? (() => false),
     );
   }
   return requireModule().masteringChainStereo(
@@ -213,6 +219,7 @@ export function masteringChainWithProgress(
     request.sampleRate ?? 22050,
     canonicalChainConfig(request.config ?? {}),
     request.onProgress,
+    request.cancel ?? (() => false),
   );
 }
 
@@ -259,6 +266,7 @@ export function masteringChainStereoWithProgress(
     request.sampleRate ?? 22050,
     canonicalChainConfig(request.config ?? {}),
     request.onProgress,
+    request.cancel ?? (() => false),
   );
 }
 
@@ -298,13 +306,14 @@ export function masterAudio(
 ): MasteringChainResult {
   const request = masterAudioRequest(samples, sampleRate, presetName, overrides, onProgress);
   const flat = flattenChainConfig(request.overrides ?? {});
-  if (request.onProgress) {
+  if (request.onProgress || request.cancel) {
     return requireModule().masterAudioWithProgress(
       request.preset ?? 'pop',
       request.samples,
       request.sampleRate ?? 22050,
       flat,
-      request.onProgress,
+      request.onProgress ?? (() => {}),
+      request.cancel ?? (() => false),
     );
   }
   return requireModule().masterAudio(
@@ -355,14 +364,15 @@ export function masterAudioStereo(
   if (request.left.length !== request.right.length) {
     throw new Error('Stereo channel lengths must match.');
   }
-  if (request.onProgress) {
+  if (request.onProgress || request.cancel) {
     return requireModule().masterAudioStereoWithProgress(
       request.preset ?? 'pop',
       request.left,
       request.right,
       request.sampleRate ?? 22050,
       flat,
-      request.onProgress,
+      request.onProgress ?? (() => {}),
+      request.cancel ?? (() => false),
     );
   }
   return requireModule().masterAudioStereo(
@@ -405,6 +415,7 @@ export function masterAudioWithProgress(
     request.sampleRate ?? 22050,
     flattenChainConfig(request.overrides ?? {}),
     request.onProgress,
+    request.cancel ?? (() => false),
   );
 }
 
@@ -451,5 +462,6 @@ export function masterAudioStereoWithProgress(
     request.sampleRate ?? 22050,
     flattenChainConfig(request.overrides ?? {}),
     request.onProgress,
+    request.cancel ?? (() => false),
   );
 }

package/src/mastering_core.ts

@@ -152,6 +152,8 @@ export interface MasteringInsertParamInfo {
   id: number;
   /** Whether the param can be changed live from the audio thread. */
   rtSafe: boolean;
+  /** Physical unit when the parameter is not unitless. */
+  unit?: string;
 }
 
 /**
@@ -184,6 +186,9 @@ export type MasteringChannelPolicy =
   | 'perChannel'
   | 'passthrough';
 
+/** Coarse algorithmic work estimate for a realtime insert; not a benchmark. */
+export type MasteringRealtimeCost = 'low' | 'moderate' | 'high';
+
 /** One processor's realtime/offline/pair classification in the catalog. */
 export interface MasteringProcessorCatalogEntry {
   /** Processor id (the name used for scene inserts / named processors). */
@@ -208,6 +213,8 @@ export interface MasteringProcessorCatalogEntry {
    * offline, dry-only, and no-tail processors.
    */
   tailSamples: number;
+  /** Coarse realtime work estimate, or null when the processor is not an insert. */
+  realtimeCost: MasteringRealtimeCost | null;
   /**
    * How the mixer wraps the processor on a >2-channel (surround) bus insert:
    * "multichannel" (one full-buffer call) or "stereoPairOnly" (front L/R pair,

package/src/mastering_dynamics.ts

@@ -107,7 +107,13 @@ export function masteringDynamicsCompressor(
     typeof request.detector === 'string'
       ? COMPRESSOR_DETECTOR_MAP[request.detector]
       : request.detector;
-  const opts: Record<string, unknown> = { ...request };
+  // Preserve inherited option values as well as own properties. The embind
+  // boundary's hasProperty() intentionally follows the prototype chain, so a
+  // spread copy here would otherwise erase values before C++ can read them.
+  const opts: Record<string, unknown> = Object.assign(
+    Object.create(Object.getPrototypeOf(request)) as Record<string, unknown>,
+    request,
+  );
   if (detector !== undefined) {
     opts.detector = detector;
   }

package/src/metering.ts

@@ -1,3 +1,4 @@
+import { ErrorCode, SonareError } from './errors';
 import { getSonareModule } from './module_state';
 import type { ValidateOptions } from './validation';
 import { assertSamples } from './validation';
@@ -17,7 +18,11 @@ function assertOversampleFactor(fnName: string, factor: number): void {
     normalized > 16 ||
     (normalized & (normalized - 1)) !== 0
   ) {
-    throw new RangeError(`${fnName}: oversampleFactor must be 0 or a power of two from 1 to 16`);
+    throw new SonareError(
+      ErrorCode.InvalidParameter,
+      'InvalidParameter',
+      `${fnName}: oversampleFactor must be 0 or a power of two from 1 to 16`,
+    );
   }
 }
 
@@ -128,6 +133,43 @@ export function meteringRmsDb(
   return requireModule().meteringRmsDb(request.samples, request.sampleRate ?? 22050);
 }
 
+export interface MeteringSilenceRatioRequest extends MeteringSamplesRequest {
+  thresholdDb?: number;
+  frameLength?: number;
+  hopLength?: number;
+}
+
+export function meteringSilenceRatio(request: MeteringSilenceRatioRequest): number;
+export function meteringSilenceRatio(
+  samples: Float32Array,
+  sampleRate?: number,
+  thresholdDb?: number,
+  frameLength?: number,
+  hopLength?: number,
+  options?: ValidateOptions,
+): number;
+export function meteringSilenceRatio(
+  samples: Float32Array | MeteringSilenceRatioRequest,
+  sampleRate = 22050,
+  thresholdDb = -45,
+  frameLength = 1024,
+  hopLength = 256,
+  options: ValidateOptions = {},
+): number {
+  const request =
+    samples instanceof Float32Array
+      ? { samples, sampleRate, thresholdDb, frameLength, hopLength, ...options }
+      : samples;
+  assertSamples('meteringSilenceRatio', request.samples, request.validate !== false);
+  return requireModule().meteringSilenceRatio(
+    request.samples,
+    request.sampleRate ?? 22050,
+    request.thresholdDb ?? -45,
+    request.frameLength ?? 1024,
+    request.hopLength ?? 256,
+  );
+}
+
 export function meteringCrestFactorDb(request: MeteringSamplesRequest): number;
 export function meteringCrestFactorDb(
   samples: Float32Array,
@@ -206,16 +248,20 @@ export function meteringDetectClipping(
 ): ClippingReport {
   const request = samples instanceof Float32Array ? { samples, sampleRate, ...options } : samples;
   assertSamples('meteringDetectClipping', request.samples, request.validate !== false);
+  const minRegionSamples = request.minRegionSamples ?? 1;
+  if (!Number.isInteger(minRegionSamples) || minRegionSamples < 0) {
+    throw new RangeError('meteringDetectClipping: minRegionSamples must be a non-negative integer');
+  }
   return requireModule().meteringDetectClipping(
     request.samples,
     request.sampleRate ?? 22050,
     request.threshold ?? 0.999,
-    request.minRegionSamples ?? 1,
+    minRegionSamples,
   );
 }
 
 /**
- * Sliding-window dynamic range. Pass 0 for window/hop to use the library
+ * Sliding-window dynamic range for mono audio. Pass 0 for window/hop to use the library
  * default (window=3 s, hop=1 s). The percentiles use a NEGATIVE sentinel for
  * "use the library default" (low=0.10, high=0.95) because 0 is a literal 0th
  * percentile; omitted percentiles therefore default to -1.
@@ -354,7 +400,7 @@ export interface WaveformPeaksReport {
   samplesPerBucket: number;
 }
 
-/** Pearson correlation in [-1, 1] between two equal-length channels. */
+/** Uncentered correlation (cosine similarity) in [-1, 1] between equal-length channels. */
 export function meteringStereoCorrelation(request: MeteringStereoRequest): number;
 export function meteringStereoCorrelation(
   left: Float32Array,
@@ -561,7 +607,7 @@ export function meteringPhaseScopeDecimated(
 }
 
 /**
- * Welch-averaged magnitude / power / dB spectrum over the WHOLE signal (split
+ * Welch-averaged magnitude / power / dB spectrum over the WHOLE mono signal (split
  * into Hann-windowed, 50%-overlapping `nFft`-length frames whose power spectra
  * are averaged). For a true single-frame snapshot, use
  * {@link meteringSpectrumFrame}.

package/src/mixer.ts

@@ -74,7 +74,10 @@ export class Mixer {
     return new Mixer(module.createMixerFromSceneJson(json, sampleRate, blockSize), blockSize);
   }
 
-  /** Rebuild and compile the routing graph from the current scene topology. */
+  /**
+   * Rebuild and compile the routing graph without resetting its absolute
+   * automation sample position or queued strip automation.
+   */
   compile(): void {
     this.mixer.compile();
   }
@@ -261,6 +264,11 @@ export class Mixer {
     this.mixer.setVcaGroupGainDb(id, gainDb);
   }
 
+  /** Replace an existing VCA group's strip membership. */
+  setVcaGroupMembers(id: string, members: string[]): void {
+    this.mixer.setVcaGroupMembers(id, members);
+  }
+
   /** Remove a VCA group by id. */
   removeVcaGroup(id: string): void {
     this.mixer.removeVcaGroup(id);
@@ -427,6 +435,11 @@ export class Mixer {
     return this.mixer.meterTap(stripIndex, meterTapCode(tap));
   }
 
+  /** Read the post-insert meter for a compiled bus, including master. */
+  busMeter(busId: string): MixMeterSnapshot {
+    return this.mixer.busMeter(busId);
+  }
+
   /**
    * Schedule sample-accurate fader automation on a strip.
    *