otomatalabs/furnace
7
0
Fork 0
Code Issues Pull requests Actions Packages Projects Releases Wiki Activity
furnace/doc/2-interface/settings.md
Electric Keet dfa663a500 Teensy fix. 
I cannot believe I did this.
2023-07-07 05:21:59 -05:00

12 KiB
Raw Blame History

settings

settings are saved when clicking the OK button at the bottom of the dialog.

General

  • Workspace layout

    • Import: reads a .ini layout file.
    • Export: writes current layout to a .ini file.
    • Reset: resets layout to default.

  • Initial system: the system of chips loaded on starting Furnace.

    • Current system: sets current chips as default.
    • Randomize: set default to a random system.
      • this will not choose a random system at each start.
    • Reset to defaults: sets default to "Sega Genesis/Mega Drive".
    • Name: name for the default system. may be set to any text.
    • system configuration: same as in the chip manager and mixer.

  • Play intro on start-up:

    • No: skips intro entirely.
    • Short: shows silent title screen briefly.
    • Full (short when loading song): shows animated musical intro unless started with a song (command line, double-clicking a .fur file, etc.)
    • Full (always): always shows animated musical intro.

  • When creating new song:

    • Display system preset selector
    • Start with initial system

  • Double-click time (seconds): maximum time between mouse clicks to recognize them as a double-click.

  • Toggle channel solo on: select which interactions with a channel header will toggle solo for that channel.

  • Push value when overwriting instead of clearing it: in the order list and pattern editors, typing into an already-filled value will shift digits instead of starting fresh.

    • if off: moving the cursor onto the value A5 and typing a "B" results in 0B.
    • if on: with the cursor on the value A5 and typing a "B" results in 5B.

  • Move cursor up on backspace-delete

  • Move cursor by edit step on delete

  • Change current instrument when changing instrument column (absorb)

  • Delete effect value when deleting effect

  • Change order when scrolling outside of pattern bounds:

    • if off, the pattern edit cursor will stay locked within the current order.
    • if on, moving the cursor past the edge of the previous or next order will move to that order.

  • Move cursor by edit step on insert (push)

  • Move cursor to end of clipboard content when pasting

  • Don't scroll when moving cursor

  • Double click selects entire column

  • Allow docking editors

  • Don't raise pattern editor on click

  • Focus pattern editor when selecting instrument

  • Restart song when changing chip properties

  • Use system file picker: use native OS file dialog instead of Furnace's.

  • Only allow window movement when clicking on title bar

  • Enable event delay

    • may cause issues with high-polling-rate mice when previewing notes.

  • Power-saving mode

    • saves power by lowering the frame rate to 2fps when idle.
    • may cause issues under Mesa drivers!

  • Disable threaded input (restart after changing!)

    • threaded input processes key presses for note preview on a separate thread (on supported platforms), which reduces latency.
    • however, crashes have been reported when threaded input is on. enable this option if that is the case.

  • Remember window position

    • remembers the window's last position on start-up.

  • New instruments are blank

  • Save unused patterns

  • Compress when saving

    • use zlib to compress saved songs.

  • Cursor follows current order when moving it

    • applies when playback is stopped.

  • Audio export loop/fade out time:

    • Set to these values on start-up:
      • Loops: number of additional times to play through 0Bxx song loop.
      • Fade out (seconds): length of fade out after final loop.
    • Remember last values

  • Note preview behavior:

    • Never
    • When cursor is in Note column
    • When cursor is in Note column or not in edit mode
    • Always

  • Wrap pattern cursor horizontally:

    • No
    • Yes
    • Yes, and move to next/prev row

  • Wrap pattern cursor vertically:

    • No
    • Yes
    • Yes, and move to next/prev pattern

  • Cursor movement keys behavior:

    • Move by one
    • Move by Edit Step

  • Effect input cursor behavior:

    • Move down
    • Move to effect value (otherwise move down)
    • Move to effect value/next effect and wrap around

  • Allow dragging selection:

    • No
    • Yes
    • Yes (while holding Ctrl only)

Audio/MIDI

  • Backend: select SDL or JACK for audio output.

    • only appears on Linux, or MacOS compiled with JACK support

  • Device: audio device for playback.

  • Sample rate

  • Outputs: select number of audio outputs created, up to 16.

    • only appears when Backend is JACK.

  • Channels: number of output channels to use.

  • Buffer size: size of buffer in both samples and milliseconds.

  • Quality: selects quality of resampling. low quality reduces CPU load.

  • Metronome volume

  • Low-latency mode (experimental!): reduces latency by running the engine faster than the tick rate. useful for live playback/jam mode.

    • warning: experimental! may produce glitches. only enable if your buffer size is small (10ms or less).

  • Force mono audio

  • Software clipping: clips output to nominal range (-1.0 to 1.0) before passing it to the audio device.

    • this avoids activating Windows' built-in limiter.

  • want: displays requested audio configuration.

  • got: displays actual audio configuration returned by audio backend.

  • MIDI input

  • MIDI output

  • MIDI input settings

    • Note input
    • Velocity input
    • Map MIDI channels to direct channels
    • Map Yamaha FM voice data to instruments
    • Program change is instrument selection
    • Value input style:
      • Disabled/custom
      • Two octaves (0 is C-4, F is D#5)
      • Raw (note number is value)
      • Two octaves alternate (lower keys are 0-9, upper keys are A-F)
      • Use dual control change (one for each nibble)
        • CC of upper nibble
        • CC of lower nibble
      • Use 14-bit control change
        • MSB CC
        • LSB CC
      • Use single control change
        • Control
    • Per-column control change
      • Instrument
        Volume
        Effect x type
        Effect x value
        • Disabled/custom
        • Use dual control change (one for each nibble)
          • CC of upper nibble
          • CC of lower nibble
        • Use 14-bit control change
          • MSB CC
          • LSB CC
        • Use single control change (imprecise)
          • Control
    • Volume curve
    • Actions:
      • + button: adds a new action.
      • window-with-arrow button: new action with learning! press a button or move a slider/knob/something on your device.
      • each action has the following:
        • Type
        • Channel
        • Note/Control
        • Velocity/Value
        • Action
        • Learn
        • Remove

  • MIDI output settings

    • Output mode:
      • Off (use for TX81Z)
      • Melodic
    • Send Program Change
    • Send MIDI clock
    • Send MIDI timecode
      • Timecode frame rate:
        • Closest to Tick Rate
        • Film (24fps)
        • PAL (25fps)
        • NTSC drop (29.97fps)
        • NTSC non-drop (30fps)

Emulation

  • Arcade/YM2151 core

    • ymfm
    • Nuked-OPM

  • Genesis/YM2612 core

    • Nuked-OPN2
    • ymfm

  • SN76489 core

    • MAME
    • Nuked-PSG Mod

  • NES core

    • puNES
    • NSFplay

  • FDS core

    • puNES
    • NSFplay

  • SID core

    • reSID
    • reSIDfp

  • POKEY core

    • Atari800 (mzpokeysnd)
    • ASAP (C++ port)

  • OPN/OPNA/OPNB cores

    • ymfm only
    • Nuked-OPN2 (FM) + ymfm (SSG/ADPCM)

  • PC Speaker strategy:

    • evdev SND_TONE
    • KIOCSOUND on /dev/tty1
    • /dev/port
    • KIOCSOUND on standard output
    • outb()

  • Sample ROMs:

    • OPL4 YRW801 path
    • MultiPCM TG100 path
    • MultiPCM MU5 path

Appearance

  • Render driver

  • Automatic UI scaling factor: automatically match the OS's UI scaling.

  • UI scaling factor: only if "Automatic UI scaling factor" is off.

  • Main font: if "Custom...", a file path selector will appear beneath.

  • Size

  • Pattern font: if "Custom...", a file path selector will appear beneath.

  • Size

  • Icon size

  • Display Japanese characters
    Display Chinese (Simplified) characters
    Display Chinese (Traditional) characters
    Display Korean characters

    • only toggle these options if you have enough graphics memory.
    • these are a temporary solution until dynamic font atlas is implemented in Dear ImGui.

  • Number of recent files

  • Pattern view labels:

  • Note off (3-char): default is OFF

  • Note release (3-char): default is ===.

  • Macro release (3-char): default is REL.

  • Empty field (3-char): default is ....

  • Empty field (2-char): default is ...

  • Orders row number format:

    • Decimal
    • Hexadecimal

  • Pattern row number format:

    • Decimal
    • Hexadecimal

  • FM parameter names:

    • Friendly
    • Technical
    • Technical (alternate)

  • Title bar:

    • Furnace
    • Song Name - Furnace
    • file_name.fur - Furnace
    • /path/to/file.fur - Furnace

  • Display system name on title bar

  • Display chip names instead of "multi-system" in title bar

  • Status bar:

    • Cursor details
    • File path
    • Cursor details or file path
    • Nothing

  • Play/edit controls layout:

    • Classic
    • Compact
    • Compact (vertical)
    • Split

  • Position of buttons in Orders:

    • Top
    • Left
    • Right

  • FM parameter editor layout:

    • Modern
    • Compact (2x2, classic)
    • Compact (1x4)
    • Compact (4x1)
    • Alternate (2x2)
    • Alternate (1x4)
    • Alternate (4x1)

  • Position of Sustain in FM editor:

    • Between Decay and Sustain Rate
    • After Release Rate

  • Macro editor layout:

    • Unified
    • Mobile
    • Grid
    • Single (with list)
    • Single (combo box)

  • Namco 163 chip name

  • Channel colors:

    • Single
    • Channel type
    • Instrument type

  • Channel name colors:

    • Single
    • Channel type
    • Instrument type

  • Channel style:

    • Classic
    • Line
    • Round
    • Split button
    • Square border
    • Round border

  • Channel volume bar:

    • None
    • Simple
    • Stereo
    • Real
    • Real (stereo)

  • Channel feedback style:

    • Off
    • Note
    • Volume
    • Active

  • Channel font:

    • Regular
    • Monospace

  • Center channel name

  • Colorize instrument editor using instrument type

  • Use separate colors for carriers/modulators in FM editor

  • Unified instrument/wavetable/sample list

  • Horizontal instrument list

  • Use standard OPL waveform names

  • Overflow pattern highlights

  • Display previous/next pattern

  • Use German notation: display B notes as H, and A# notes as B.

  • Single-digit effects for 00-0F

  • Center pattern view: centers pattern horizontally in view.

  • Unsigned FM detune values

  • Highlight channel at cursor in Orders

  • About screen party time

    • warning: may cause epileptic seizures.

  • Use compact wave editor

  • Use classic macro editor vertical slider

  • Rounded window corners

  • Rounded buttons

  • Rounded menu corners

  • Borders around widgets

  • Disable fade-in during start-up

  • Oscilloscope settings:

    • Rounded corners
    • Fill entire window
    • Waveform goes out of bounds
    • Border

  • Pattern view spacing after:

    • Note
    • Instrument
    • Volume
    • Effect
    • Effect value

  • Color scheme

    • Import
    • Export
    • Reset defaults
    • General
      • Color scheme type:
        • Dark
        • Light
      • Frame shading
    • several more categories...

Keyboard

  • Import
  • Export
  • Reset defaults
  • several categories of keybinds...
    • click on a keybind then enter a key or key combination to change it
    • right-click to clear the keybind