Create waveform oscilloscope
create_waveformCreate a real-time oscilloscope trace of audio waveforms from a device input, file, or oscillator. Adjust scale and time window to zoom vertically or horizontally.
Instructions
Build a time-domain audio waveform / oscilloscope — the actual audio signal scrolling left-to-right as a moving trace (the time-domain companion to create_spectrum's frequency bins and detect_onsets' transients). A Trail CHOP keeps a rolling buffer of recent samples (time_window seconds), a CHOP-to-SOP turns those samples into a real scope LINE (x=time, y=amplitude) rendered by a Geometry COMP through an orthographic Camera + Render TOP, and a Constant TOP tints the trace to the chosen colour. Unlike create_audio_reactive (which renders a spectrum), this shows the raw waveform. Source can be the live device (mic/line — may prompt for macOS permission), an audio file, a synthetic oscillator (for testing), or an existing CHOP. Output is a Null TOP. Scale is the vertical amplitude zoom; TimeWindow is the horizontal time span.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| source | No | Audio source. 'device' = live microphone/line in (the real-world default; creating it may pop a one-time macOS microphone-permission dialog — click Allow). 'file' = an audio file. 'oscillator' = a synthetic tone, handy for testing the scope without any device permission. 'existing_chop' = reuse a CHOP you already have. | device |
| audio_file_path | No | Audio file path (source='file'). | |
| existing_chop_path | No | Path of an existing audio CHOP to scope (source='existing_chop'). | |
| color | No | Waveform colour as a hex string ('#00ff88' = classic phosphor green). Tints the rendered scope line via a Constant TOP multiplied over the Render TOP image. | #00ff88 |
| scale | No | Amplitude gain on the signal before it is drawn — the vertical zoom of the trace. Drives a Math CHOP's gain (1 = raw signal). | |
| time_window | No | How much recent history the scrolling trace holds, in seconds — the horizontal time span. Drives the Trail CHOP's Window Length (wlength, units = seconds). | |
| expose_controls | No | Expose live Color / Scale / TimeWindow controls bound to the right node parameters. | |
| parent_path | No | Parent COMP path the self-contained 'waveform' container is created inside. | /project1 |