# Engines

You can add engines by activating the appropriate menu item within the "add" submenu of the "edit" menu item. You may change the properties of an engine by opening the properties dialog from the context menu at the top of each machine within vertical order. From the context menu you may perform some other tasks, as well.

The edit submenu is only available by sequencers like AgsDrum and AgsMatrix.

- To move up or down an engine open context menu and activate "up" respectively "down" entry.

- To show or hide an engine open context menu and activate "show" respectively "hide" entry. Note the engines won't be hidden entirely they are just collapsed.

- To remove an engine open context menu and activate "destroy" entry.

- To rename an engine open context menu and activate "rename" entry.

- To remove an audio object open context menu and activate "rename audio" entry. This name can be used by the OSC Server to address the audio object.

- To reposition an audio object open context menu and activate "reposition audio" entry. This position can be used by the OSC Server to address the audio object.

- To open properties dialog open context menu and activate "properties" entry. There you might link, resize or asign LADSPA effects to channels. NOTE for LADSPA sink or generators aren't supported, yet.

- To change multiple grouped controls at once check sticky controls.

- Edit gives you editing options.

  - Copy pattern does convert your pattern bitmap into a pattern based notation suitable to paste in notation editor.
  - Envelope opens a dialog with envelope editor, info and pattern editor tab. Allowing you to edit envelope presets and apply to selected notes.

- Connection gives you audio/MIDI options.

  - Audio connection allows you assign output or input soundcards.
  - Midi dialog allows you to assign MIDI sequencers to an instrument.

- Export gives you audio exporting options.

  - Audio export does export your wave data into an audio file without any effect processing.

- To adjust many input controls at once open context menu and activate "sticky controls" entry.

## Machine properties

Within properties dialog you can link lines either in single channel or in bulk mode, add effects and adjust audio-channels/pads.

### Output tab

The machine properties dialog screenshot - output tab

The output tab lets you mainly perform linking lines and adding effects to them. For each line there's a combo box listing available linking engines, on the right of it there is a spin button let you choose the input line to be linked. As you have added a plugin by clicking add and selected appropriate effect by using plugin browser dialog. You may remove it by clicking checkbox of the listed plugin and finally click remove. Note you can have a effect only once per channel.

### Input tab

The machine properties dialog screenshot - input tab

The input tab does the mainly same as output tab in view of input lines. If supported you might assign files, too. In general you connect output to input.

### Link input tab

The machine properties dialog screenshot - link input tab

Do linking in batch mode. This means you're able to assign multiple lines at once. Thus you have to decide what start channel on each side to use and the count of lines to be linked.

### Resize channels tab

The machine properties dialog screenshot - resize tab

Adjust audio channels or input/output pads. If supported the GUI may provide more lines and pads as increasing the amount.

### Plugin browser dialog

The LADSPA browser dialog screenshot

The plugin browser gives you choice of available LADSPA or Lv2 plugins. It lets you modify the controls to be used. The added plugin can be removed by activating checkbox in output/input tab and clicking remove.

## Audio connection dialog

The audio connection dialog allows you to specify to what soundcard to write output to or read input from. This can be modified either by assigning single channels or in bulk mode.

### Audio connection output line

The audio connection output line screenshot

Select the desired soundcard and don't forget to click enable. In order apply your modifications. After click OK.

### Audio connection output bulk

The audio connection output bulk screenshot

The output connection tab allows you to link a bunch of channel at once.

### Audio connection input line

The audio connection input line screenshot

Select the desired soundcard and don't forget to click enable. In order apply your modifications. After click OK.

### Audio connection input bulk

The audio connection input bulk screenshot

The input connection tab allows you to link a bunch of channel at once.

## Envelope dialog

The envelope dialog allows you to edit envelope information as presets. These presets can be assigned to a specific note. Selection is done with select tool of notation editor and selecting notes of active audio channel.

The enelope's width matches with x length 1.0 the audio signal's length. The magnitude has normal volume with value 1.0.

### Envelope editor

The envelope dialog's editor tab screenshot

Modify or create presets and apply it to selected notes. Selection is performed within notation editor.

Add new or remove unwanted presets.

Attack is the initial x length and y magnitude.

Decay is the second x length and y magnitude.

Sustain is the third x length and y magnitude.

Release is the last x length and y magnitude.

Ratio increase/decrease the entire envelope's magnitude.

### Envelope info

The envelope dialog's info tab screenshot

Show envelope information of selected notes. There are 5 columns with information of the specific selection. The selection itself is presented by the list view.

Plot enables plotting of the matching note's envelope information.

Audio channel is the selected note's audio channel.

Note x0 is the selected note's x0 offset.

Note x1 is the selected note's x1 offset.

Note y is the selected note's y key.

### Envelope pattern

The envelope dialog's pattern tab screenshot

Modify and create pattern related envelope presets. There are 9 columns with information of the pattern's region to apply the envelope preset.

Edit means modify the matchin preset.

Plot enables plotting of the matching envelope preset information.

Preset is the preset's name.

Audio channel start the preset's start audio channel.

Audio channel end the preset's end audio channel.

Pad start the preset's start pad.

Pad end the preset's end pad.

X start the preset's x start offset.

X end the preset's x end offset.

There are the usual envelope editor controls.

Organize your presets with move up and move down. Or add new or remove unwanted presets.

## MIDI dialog

The MIDI dialog screenshot

The MIDI dialog allows you to select the MIDI sequencer to assign of the current machine. The MIDI channel is the MIDI channel assigned to the MIDI device, useful with multiple devices. Upto 16 devices are allowed. You might want to perform start and end key. Further you can adjust the start and end channel.

## Panel

The panel screenshot

The panel is used for outputting to your soundcard and should be at topmost of your audio processing tree. It contains per audio channel a mute check box.

Due the synchroneous nature of the output engine you're just able to adjust the audio channels. The output pads aren't visible and the ones available for input are packed vertically.

## Mixer

The mixer screenshot

Bundle audio lines with the mixer and perform toplevel stream manipulation. It contains per audio channel a volume indicator and may contain LADSPA or Lv2 plugins.

Due the limitation of recycling it is just able to handle multiple input lines and only one output pad. Whereas the output is hidden. They are locate just below the machine's menu tool button.

## Spectrometer

The spectrometer screenshot

Visualize input by plotting it using FFTW3 library.

## Equalizer10

The equalizer10 screenshot

Adjust a 10 band equalizer with additional pressure control.

## Drum

The drum screenshot

Produce an audio stream by defining a pattern. The drum supports opening audio files and associate to its input. You might doing it by open button located preceeding to pattern box. Thus multi-selection of files is supported and assigning can be controlled by the controls just above the action widgets. The drum input pad contains an open button, too. It assigns available audio channels of the file to the grouped lines. One more way to assign audio files is doing it so by link editor of machine's property dialog. The drum may contain LADSPA plugins, too.

The drum may contain multiple input as well output pads. They are packed on top of the composite widget, just below the machine's menu tool button. The input is packed horizontally followed by vertically packed output. The edit button within every input pad enables it as current input for editing pattern data. Further you may de-/activate the group toggle button to control audio channel assignment.

Next to the multi-selection enable open button there's a loop check-box followed by the run button what starts the drum sequencer. It follows the into a two dimensional matrix packed pattern banks. Labeled from 1 to 12 and an the combined index labeled a throughout d. The length spin-button controls the number of pattern pads to be played in sequence which may be looped.

### The pattern box

As entering to pattern box with focus the only way to get out of it is by tabulator key. With arrow keys you may navigate within pattern or toggle with space.

- Left, Left-Arrow

  - Move within pattern box left, as the pattern pad control is activate you get an audible feedback.

- Right, Right-Arrow

  - Move within pattern box right, audible feedback as above.

- Up, Up-Arrow

  - Decrease pattern box offset about available number of pattern pads, audible feedback as above.

- Down, Down-Arrow

  - Increase pattern box offset about available number of pattern pads, audible feedback as above.

- Space

  - Toggle audio pattern and give audible feedback.

- Ctrl+c

  - Copy the current pattern to clipboard

- Tab

  - Leave pattern box focus.

## Matrix

The matrix screenshot

Produce an audio stream by defining a pattern. The matrix itselves doesn't have any audio signals on its own input you may rather link it to a synth engine. The matrix is a rectangular area you may navigate within by arrow keys or toggle pattern by hiting space. The matrix is a true mono device but you may emulate multiple channels by doing multi-output. This is fulfilled by adjusting output pads within machine's properties dialog.

Run button comes first and is followed by a one dimensional vector bank index labeled from 1 to 9. Then follows the matrix you have to leave it by hiting tab then you might modify sequence length or do loop control of the sequence.

- Left, Left-Arrow

  - Move within matrix left, as the pattern pad control is activate you get an audible feedback.

- Right, Right-Arrow

  - Move within matrix right, audible feedback as above.

- Up, Up-Arrow

  - Decrease matrix offset about available number of pattern pads, audible feedback as above.

- Down, Down-Arrow

  - Increase matrix offset about available number of pattern pads, audible feedback as above.

- Space

  - Toggle audio pattern and give audible feedback.

- Ctrl+c

  - Copy the current pattern to clipboard

- Tab

  - Leave matrix focus.

## Synth

The synth screenshot

Produce audio data using its oscillators. The count of oscillators depends on number of input lines. They are adjusted vertically.

Wave is the actual oscillator either sine, sawtooth, square, triangle or impulse.

Attack is the first frame after key on to start output.

Length is the length of the output in frames.

Phase is the initial phase as x offset within oscillator's algorithm.

Frequency is the lower range key's frequency.

Volume is the output volume of the oscillator.

Sync allows you reset the phase with 3 times a tuple of x offset and new x offset of phase.

You have on the right the option to auto-update changes you do with the controls or do it manually by the update button. Lower is the very first y key.

## FM Synth

The frequency modulation synth screenshot

Produce audio data using its oscillators. The count of oscillators depends on number of input lines. They are adjusted vertically. You have on the right the option to auto-update changes you do with the controls or do it manually by the update button.

FM Synth has additional controls than Synth for its oscillators to control. The controls are related to the Low Frequency Oscillator that does the actual Frequency Modulation.

LFO wave use specific function to modulate frequency.

LFO frequency use specific frequency to modulate frequency.

LFO depth is the depth of the frequency modulation.

LFO tuning tunes by cents.

## Syncsynth

The synced synth screenshot

Produce audio data using its oscillators. The count of oscillators can be adjusted by clicking add/remove. You have on the right the option to auto-update changes you do with the controls or do it manually by the update button. Loop start and loop end allows you to specify what region of the audio data shall be looped in order to get the desired note length.

The Syncsynth has the very same oscillators as Synth.

## FM Syncsynth

The frequency modulator synced synth screenshot

Produce audio data using its oscillators. The count of oscillators can be adjusted by clicking add/remove. You have on the right the option to auto-update changes you do with the controls or do it manually by the update button. Loop start and loop end allows you to specify what region of the audio data shall be looped in order to get the desired note length.

The FM Syncsynth has the very same oscillators as FM Synth.

## Hybrid Synth

The hybrid synth screenshot

Produce audio data using 2 oscillators, those can be phase modulated with attack and phase tuples.

In order to enable phase modulation for the first oscillator, you need to check "OSC 1 - sync enabled". The "OSC 1 - sync factor" applies to every tuples attack. The tuples maximum value is 2 times Pi for attack and phase. The LFO applies to the phase reset.

The pitch tuning does additional frequency shift.

There is a white noise source, which can adjust its gain.

The low-pass filter is disabled by default.

The high-pass filter is disabled by default.

There is a chorus, which provides additional controls.

The synth is compute just-in-time.

## Hybrid FM Synth

The hybrid frequency modulation synth screenshot

Produce audio data using 3 FM oscillators. The synth is compute just-in-time.

The Hybrid FM Synth has got the same additional effect processors like Hybrid Synth.

The synth is compute just-in-time.

## FFPlayer

The ffplayer screenshot

Produce audio data by opening Soundfont2 audio file container format. There three available controls, preset and instrument to navigate within container format and a open button to read Soundfont2 files and assign the selected instrument to the input.

Synth generator can be enabled to pitch missing keys from lower upto specific key count.

The ffplayer contains recently the bridge widget. You can add plugins in bulk mode by click Add or Remove within AgsFFPlayer's bridge, what you can collapse/expand. To add an effect to a line, you have open as usual input/output of machine properties.

## SF2 Synth

The SF2 synth screenshot

Produce audio data using Soundfont2 files.

There is a chorus, which provides additional controls.

The synth is compute just-in-time.

## Sampler

The pitch sampler screenshot

Produce audio data by opening SFZ audio file container format. There is a open button to read SFZ files and assign it to the input.

Synth generator can be enabled to pitch missing keys from lower upto specific key count.

There is a LFO enable control allowing you make adjustments to LFO amplification (currently defunctional):

- LFO freq

- LFO phase

- LFO depth

- LFO tuning

## SFZ Synth

The SFZ synth screenshot

Produce audio data using SFZ files.

There is a chorus, which provides additional controls.

The synth is compute just-in-time.

## Stargazer Synth

The stargazer synth screenshot

Produce audio data using 2 oscillators, those can be phase modulated with attack and phase tuples. It has additional controls to modify pitch, chorus, tremolo and vibrato effect processors.

In order to enable phase modulation for the first oscillator, you need to check "OSC 1 - sync enabled". The "OSC 1 - sync factor" applies to every tuples attack. The tuples maximum value is 2 times Pi for attack and phase. The LFO applies to the phase reset.

The pitch tuning does additional frequency shift.

There is a chorus, which provides additional controls.

The tremolo modifies volume by a LFO.

The vibrato modifies frequency by a LFO.

The synth is compute just-in-time.

## Quantum Synth

The quantum synth screenshot

Produce audio data using 2 oscillators, providing frequency and volume sequencers with 8 steps. If a control is 0.0 following controls are ignored. those can be phase modulated with attack and phase tuples. It has additional controls to modify pitch, chorus, tremolo and vibrato effect processors.

In order to enable phase modulation for the first oscillator, you need to check "OSC 1 - sync enabled". The "OSC 1 - sync factor" applies to every tuples attack. The tuples maximum value is 2 times Pi for attack and phase. The LFO applies to the phase reset.

The pitch tuning does additional frequency shift.

There is a chorus, which provides additional controls.

The tremolo modifies volume by a LFO.

The vibrato modifies frequency by a LFO.

The synth is compute just-in-time.

## Raven Synth

The raven synth screenshot

Produce audio data using 2 oscillators, those can be phase modulated with attack and phase tuples. Per oscillator a low-pass filter and amplifier. It has additional controls to modify pitch, chorus, tremolo and vibrato effect processors.

In order to enable phase modulation for the first oscillator, you need to check "OSC 1 - sync enabled". The "OSC 1 - sync factor" applies to every tuples attack. The tuples maximum value is 2 times Pi for attack and phase. The LFO applies to the phase reset.

The low-pass filter cut-off frequency is given in Hertz.

The amplifier gives you control over 4 bands and filter gain.

The pitch tuning does additional frequency shift.

There is a chorus, which provides additional controls.

The tremolo modifies volume by a LFO.

The vibrato modifies frequency by a LFO.

The synth is compute just-in-time.

## Modular Synth

The modular synth screenshot

Produce audio data using 2 oscillators, those controls and pitch tuning and volume control can be varied by 2 envelope, 2 LFOs and one pink noise. The sends are assigned by a boolean matrix to receivers. Pitch tuning and main volume. A low-pass filter and amplifier. It has additional controls to modify chorus effect processor.

The low-pass filter cut-off frequency is given in Hertz.

The amplifier gives you control over 4 bands and filter gain.

There is a chorus, which provides additional controls.

## Audiorec

The audiorec screenshot

Open large audio files and manipulate the wave form using wave window. You might want to capture sound using it. By either replacing or mixing existing audio data.