Instrument Editor

The instrument editor is where you can create custom presets that define how a sound behaves. You can then reuse this preset as many times as you like in your song.

Wave and Sample Instruments

There are two types of instruments in WaveTracker, wave and sample instruments. Wave instruments play and manipulate waves from the Wave Bank, while sample instruments play back an audio clip.

Wave instruments hold only envelopes, while Sample instruments have both a sample, and envelopes tab. Although, wave instruments have a few more envelope options than sample instruments.

Envelope Editor

Envelopes are sequences that control elements of the instrument's sound over time. There are 3 envelope types instruments can have, and an additional 5 wave-specific envelopes available for wave instruments.

Envelope Type	Description
Wave & Sample instruments
Volume	Controls the channel's volume.
Arpeggio	Allows you to define arpeggios by offsetting the channel's current note.
Pitch	Controls pitch slides, each step in the envelope raises or lowers the pitch of the channel.
Wave instruments only
Wave	Sets the wave of the channel from the wave bank.
Wave Blend	Blends the current channels wave with the next one in the wave bank.
Wave Stretch	Stretches the channel's current wave from the center outwards for a kind of pulse width modulation effect.
Wave FM	Performs frequency modulation using the channel's current wave as the carrier and the next wave in the wave bank as the modulator.
Wave Sync	Repeats the channel's wave multiple times during the wave's cycle.

Editing

Envelopes can be added by selecting them from the 'Add Envelope' button. To delete the envelope, click the 'X' to the right of the envelope's name. Toggle the switch to the left side of the envelope to temporarily enable/bypass the envelope.

To edit an envelope, first set the length of the envelope with the Length control, then draw the envelope's contour in the grid, by clicking and dragging. Hold Shift while drawing to create straight lines. Envelopes can also be typed in manually via the text box below the draw area.

Loop and Release

The two ribbons at the top of the envelope editor are where you can set flags for loop points and release points in the envelope. To add a flag, click any point along the ribbon where the flag should be. Click the point again to remove it.

If the envelope has a release, the envelope will play up until the release point, and wait there until a Note Release (===) is triggered from the pattern editor. If the envelope has a loop point before a release point, it will loop that section until the envelope is released. If the loop point is afterwards, it will loop that portion indefinitely.

Loops and releases are represented in the envelope text box as '|' and '/', respectively.

Sample Editor

The 'Sample' tab is only available on sample instruments. It allows the import of any .wav, .flac or .mp3 file into an instrument. They can then be used in the pattern and will be repitched to whatever note is being played.

Clicking 'Import Sample' will open a file browser dialog, allowing you to navigate to the location of the file you would like to sample. Choosing a file will load it into the sample editor.

Above the sample editor is the length of the audio, in digital audio samples, and in seconds.

Below the sample are some settings specific to the sample.

Setting	Description
Base key	Use this to transpose the sample up or down so that the note played matches the note heard.
Fine tune	Detunes the sample up or down in cents.
Loop mode	Defines how the sample should loop, if at all: One-shot: The sample does not loop, playback stops at the end of the sample. Forward: When playback reaches the end of the sample, it loops back to the loop point. Ping-pong: When playback reaches the end of the sample, it plays in reverse until the loop point, and then plays forwards again.
Loop position	This option is only visible when the loop mode is set to Forward or Ping-pong. Allows you to set the exact position of the loop point in digital audio samples. This can be useful to find the nearest zero-crossing to avoid clicking at the loop point.
Resampling mode	Defines how the sample should be interpolated when played at different pitches Harsh: No interpolation, uses nearest neighbor resampling. This gives a very bright and digital sound. Smooth: Linear interpolation. This gives a smoother, darker sound. This is the default option for any samples unless otherwise changed in preferences. Mix: An average between the harsh and smooth modes. Provides a compromise that retains some brightness on the low end with less aliasing at the high end.

Looping

By default samples are set to the One-shot loop mode. To make a sample loop at the end, the loop mode needs to be either Forward or Ping-pong.

When looping is enabled, the looping portion of the sample will be highlighted yellow. The loop point can be set with the 'Loop position' number box. Below the loop mode dropdown. Alternatively, an easier way to set the loop point is to Shift+Click the point along the sample where the loop point should be. This will automatically create a loop point at that location. The loop point can also be set by right clicking the sample and selecting 'Set loop point'.

Editing

The right-most section of the sample editor contains tools with which to modify the sample:

Regional selections can be made by clicking and dragging over the sample. If a portion of the sample is highlighted, then the tools will affect only the selected region.

Tool	Description
Normalize	Makes the sample have maximum amplitude so there is no wasted headroom. By default all samples are normalized upon import. This can be turned off in Preferences.
Reverse	Reverses the sample so that it plays backwards.
Fade in	Makes the sample gradually get softer until it reaches silence at the very end.
Fade out	Makes the beginning of the sample silent and gradually become louder.
Amplify+	Increases the volume of the sample slightly, will clip any parts of the sample that are already maximum amplitude.
Amplify-	Decreases the volume of the sample slightly.
Invert	Flips the polarity of the sample
Cut	Only available if a region of the sample is selected. Removes the selected portion from the sample.

Saving a sample

Samples can be exported to the disk by right clicking the sample and selecting 'Export...' This will prompt a dialog to choose a location and filename, then save it as a 32-bit .wav file.