etc/furnace
0
0
Fork 0
mirror of https://github.com/tildearrow/furnace.git synced 2024-11-23 21:15:11 +00:00
Code Issues Projects Releases Packages Wiki Activity
furnace/doc/8-advanced/chanosc.md
tildearrow 5a37604217 eliminate use of backslash in doc
2023-09-10 19:12:56 -05:00

3.1 KiB
Raw Blame History

oscilloscope (per-channel)

the "Oscilloscope (per-channel)" dialog shows an individual oscilloscope for each channel during playback.

oscilloscope per-channel configuration view

right-clicking within the view will change it to the configuration view shown above:

  • Columns: arranges oscilloscopes into this many columns.
  • Size (ms): sets what length of audio is visible in each oscilloscope.
  • Center waveform: does its best to latch the waveform to the channel's note frequency and centers the display.
  • Automatic columns: sets the number of columns based on the number of channels.
    • Off: use the Columns setting.
    • Mode 1: always fewer columns than rows.
    • Mode 2: bias slightly toward more columns.
    • Mode 3: always more columns than rows.
  • Amplitude: scales amplitude for all oscilloscopes.
  • Gradient: see below.
  • the color selector sets the color for all waveforms. right-clicking on it pops up an option dialog:
    • select between the square selector and the color wheel selector.
    • Alpha bar: adds a transparency selector.
  • the boxes below that are for selecting colors numerically by red-green-blue-alpha, hue-saturation-value-alpha, and HTML-style RGBA in hex.
  • Text format: this string determins what text is shown in the top-left of each oscilloscope. it can be any text, and the following shortcodes will be replaced with information about the channel:
    • %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)
    • %%: percent sign
  • the OK button returns from options view to the oscilloscopes.

gradient

oscilloscope per-channel gradient configuration view

in this mode, the color selector is replaced by a square field onto which circular "stops" can be placed. each stop adds a soft circle of color. the resulting image is used to look up the oscilloscope color as determined by each axis.

  • right-click to place a stop.

  • left-click on a stop to change its color. the color selector is the same as above, with two additions:

    • 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 target color.

  • Background: sets background color for entire field.

  • X Axis: determines what the horizontal maps to, from left to right.

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

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