furnace/doc/8-advanced/chanosc.md
2026-01-15 13:23:23 -05:00

68 lines
3.2 KiB
Markdown

# oscilloscope (per-channel)
the "Oscilloscope (per-channel)" window displays several oscilloscope views (one per channel).
![oscilloscope per-channel configuration view](chanosc.png)
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
![oscilloscope per-channel gradient configuration view](chanosc-gradient.png)
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