theallelectricsmartgrid

Visualization Pipeline

This page documents how runtime DSP/control data is captured and rendered in JUCE visualizer components.

Capture layer: ScopeWriter

Defined in private/src/ScopeWriter.hpp.

ScopeWriter is a shared multi-scope, multi-voice circular buffer:

• m_buffer: interleaved sample storage.
• logical indexing via (scope, voice, index) -> physical index.
• AdvanceIndex() advances write position each sample/frame boundary.
• Publish() atomically exposes latest stable index (m_publishedIndex) and commits marker updates.

It also stores cycle markers:

• RecordStart(scope, voice[, uBlockIndex])
• RecordEnd(scope, voice[, uBlockIndex])

These markers are used for cycle-aware waveform views.

Write helpers: ScopeWriterHolder

ScopeWriterHolder carries:

• ScopeWriter*
• bound voiceIx
• bound scopeIx

Modules write with minimal overhead:

• Write(value) / Write(uBlockIndex, value)
• RecordStart() / RecordEnd()

This is how voice VCO/filter/amp/LFO and quad buses push data into visualization buffers.

Capture layer: effect UI snapshots

Not every visualizer is backed by ScopeWriter. Some effect views publish derived UI data directly into nested UI-state structs during PopulateUIState(...).

Current example:

• QuadDelayEnvelopeVisualizerComponent reads m_delayUIState
• QuadDelay::PopulateUIState(...) copies per-channel envelope snapshots and relative read/write head positions into rotating UI slots
• the delay envelope data is derived from DelayLineMovableWriter min/max buckets, remapped through PositionalBufferRecorder so the UI can sample the delay buffer against the current master-loop position

This path is useful for views that need aggregated state rather than raw time-series buffers.

Read layer: ScopeReader and factories

ScopeReader builds a display-ready sampling view from published data:

• supports transfer-aware sampling between cycle segments,
• interpolates sample values for screen-space X positions,
• uses marker history to stabilize wave drawing.

ScopeReaderFactory provides lightweight creation with current voice/scope context.

FFT/analyzer layer

WindowedFFT

• pulls latest published window from ScopeWriter,
• applies Hann window,
• computes DFT,
• smooths magnitudes with per-bin low-pass filters.

QuadWindowedFFT

• computes per-channel complex spectra for quad streams,
• supports per-channel magnitude display.

JUCE visual components

Defined primarily in JUCE/SmartGridOne/Source/ScopeComponent.hpp.

Main views:

• ScopeComponent (audio/control traces)
• AnalyserComponent (per-voice spectrum + filter response overlays)
• QuadAnalyserComponent (delay/reverb/master quad spectra)
• QuadDelayEnvelopeVisualizerComponent
• TheoryOfTimeScopeComponent
• SoundStageComponent (quad position + meter-weighted bubbles)
• MelodyRollComponent (note events via NonagonNoteWriter)

Additional mastering/meter views are in MasteringComponents.hpp and MeterComponent.hpp.

Wiring into UI state

SquiggleBoyWithEncoderBank::UIState owns multiple ScopeWriter instances:

• audio scopes
• control scopes
• quad scopes
• source-mixer scopes
• mono scopes

DSP/nonagon modules write into these through SetupScopeWriters(...); UI reads from published state on the JUCE thread.

Related

• Smart Grid Visualizers — Visualizer architecture, layout, bank mapping, and how to add new visualizers
• UI Components and Layout
• DSP Overview
• The Nonagon (Sequencer)

This site is open source. Improve this page.