furnace/doc/8-advanced/chanosc.md

oscilloscope (per-channel)

the "Oscilloscope (per-channel)" window displays several oscilloscope views (one per channel).

right-clicking the view will display the configuration view shown above:

• Columns: sets the amount of columns for the oscilloscope views.
• Size (ms): sets how much of a channel's output is captured for the oscilloscope view.
• Automatic columns: sets the number of columns based on the number of channels.
• Center waveform: when enabled, the displayed waveforms will be centered horizontally using an auto-correlation algorithm.
• Randomize phase on note
• DC offset correction: controls the algorithm that centers the waveform vertically.
  • Off
  • Normal: default.
  • High
• Amplitude: scales amplitude for all oscilloscope views.
• Line size: controls line thickness.
• Gradient: this allows you to use a gradient for determining the waveforms' colors instead of a single color. see the gradient section for more information.
  • if this option is off, a single color selector will be displayed.
  • if this option is on, see the "gradient" section below.
• Set to channel color: uses the channel's color for the waveform.
• Text format: this allows you to display some text on each oscilloscope view. the following codes may be used:
  • %c: channel name
  • %C: channel short name
  • %d: channel number (starting from 0)
  • %D: channel number (starting from 1)
  • %n: channel note
  • %i: instrument name
  • %I: instrument number (decimal)
  • %x: instrument number (hex)
  • %s: chip name
  • %p: chip part number
  • %S: chip ID
  • %v: volume (decimal)
  • %V: volume (percentage)
  • %b: volume (hex)
  • %l: new line
  • %%: percent sign

click on OK to return to the main view.

gradient

when enabling the Gradient setting, a gradient view is displayed in which circular "points" can be placed. each point adds a color spot. the resulting image is used to look up the waveform's color as determined by each axis.

• right-click to place a point.

• left-click on a point to change its color:

  • a color picker is displayed, alongside two settings.
  • Distance: the size of the circle.
  • Spread: the size of the solid center of the circle. increasing it fills more of the circle with the color.

• middle-click on a point to delete it.

• Background: sets the gradient's background color.

  • Solid color: chooses a color to apply to all oscilloscopes.
  • Channel color: automatically uses the color of the channel the oscilloscope belongs to.

• X Axis: determines what the horizontal axis maps to.

• Y Axis: determines what the vertical axis maps to. these can be set to the following:

  • None (0%): always left or bottom
  • None (50%): always center
  • None (100%): always right or top
  • Frequency: changes color with frequency
  • Volume: changes color with volume
  • Channel: changes color based on channel number (first channel is 0% and last is 100%)
  • Brightness: currently does nothing
  • Note Trigger: changes color when a new note is played