Skip to content

modal

Modal — Physical modelling base. exciter (strike/bow/pluck/blow) × resonator (beam/string/tube/membrane/plate) × material (metal/glass/wood/nylon/felt/skin).

Quick Start

modal({ exciter: 'strike', body: 'marimba', material: 'wood', gain: 0.45 })

Parameters

Name Type Default Range/Options Description
exciter enum strike strike bow pluck blow Excitation method: strike=打撃, bow=弓弾き, pluck=指弾き, blow=吹奏
resonator enum beam beam string tube membrane plate Geometry shortcut used only when body is omitted. Picks the default body of that family.
body enum marimba xylophone vibraphone tubular-bells flute-pipe reed-pipe brass-pipe violin viola cello double-bass guitar harp kick tom hand-drum cymbal gong steel-drum Body preset. If omitted, falls back to the default body of 'resonator' (beam→marimba, string→violin, tube→tubular-bells, membrane→tom, plate→cymbal).
material enum wood metal glass wood nylon felt skin Physical material (controls brightness, LP cutoff, attack, damping)
brightness number 0–1 0–1 Upper harmonic emphasis override (0=dark, 0.5=neutral, 1=bright). Unset = material profile
hardness number 0–1 0–1 Exciter hardness override (LP cutoff and attack scale)
damping number 0.5 0–1 0–1 Decay multiplier (0=very damped, 0.5=neutral, 1=ringing)
pressure number 0.2 0–1 0–1 Bow pressure (bow only): 0=legato, 1=martelé attack
vibratoRate number 4.5 1–10 Hz Vibrato rate
vibratoDepth number 0 0–1 0–1 Vibrato depth
decay number 0.05–30 s Explicit T60 decay time override
gain number 0.45 0–1 0–1 Output gain