furnace/doc/4-instrument/nes.md
2024-01-13 17:11:21 -05:00

2.3 KiB

NES instrument editor

the NES instrument editor consists of two tabs.

DPCM

this tab is somewhat similar to the Sample instrument editor, but it has been tailored for use with NES' DPCM channel.

  • Sample: specifies which sample should be assigned to the instrument.
  • Use sample map: enables mapping different samples to notes. see next section for more information.
    • when this option is disabled, 16 notes (from C-0 to D#1 and repeating) will map to the DPCM channel's 16 possible pitches.

sample map

the sample map allows you to set a sample for each note.

after enabling this option, a table appears with the contents of the sample map.

  • the first column represents the input note.
  • the second column allows you to type in a sample number for each note.
    • you may press Delete to clear it.
  • the third one is used to set the DPCM pitch at which the specified sample will play.
    • for possible values, refer to the table below.
    • you may press Delete to clear it. if no value is specified, the last pitch is used.
  • the fourth column allows you to set the initial delta counter value when playing the sample.
    • this is an hexadecimal number.
    • the range is 00 to 7F.
    • you may press Delete to clear it. if no value is specified, the delta counter isn't altered.
  • the fifth and last column provides a combo box for selecting a sample.

you may right-click anywhere in the number, pitch and delta columns for additional options:

  • set entire map to this pitch: sets the DPCM pitch of all notes to the selected cell's.
  • set entire map to this delta counter value: sets the initial delta counter value of all notes to the selected cell's.
  • set entire map to this sample: sets the sample number of all notes to the selected cell's.
  • reset pitches: resets the sample map's DPCM pitches to defaults (15).
  • clear delta counter values: removes all delta counter values from the map.
  • clear map samples: removes all samples from the map.

Macros

  • Volume: volume sequence.
  • Arpeggio: pitch sequence.
  • Duty/Noise: duty cycle and noise mode.
    • pulse duty cycles:
      • 0: 12.5%
      • 1: 25%
      • 2: 50%
      • 3: 75%
    • noise modes:
      • 0: long noise
      • 1: short noise
  • Pitch: fine pitch.
  • Phase Reset: trigger restart of waveform.