<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE chapter [
<!ENTITY images "images">
]>

<!-- Copyright (C) 2005-2018 Jo\u00EBl Kr\u00E4hemann -->
<!-- Permission is granted to copy, distribute and/or modify this document -->
<!-- under the terms of the GNU Free Documentation License, Version 1.3 -->
<!-- or any later version published by the Free Software Foundation; -->
<!-- with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. -->
<!-- A copy of the license is included in the section entitled "GNU -->
<!-- Free Documentation License". -->

<chapter xmlns="http://docbook.org/ns/docbook" version="5.0">
  <title>Engines</title>
  <para>
    You can add engines by activating the appropriate menu item within
    the &quot;add&quot; submenu of the &quot;edit&quot; 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.
  </para>
  
  <para>
    The edit submenu is only available by sequencers like AgsDrum and AgsMatrix.
  </para>
  
  <itemizedlist mark="bullet">
    <listitem>
      <para>
	To move up or down an engine open context menu and activate &quot;up&quot;
	respectively &quot;down&quot; entry.
      </para>
    </listitem>
    <listitem>
      <para>
	To show or hide an engine open context menu and activate &quot;show&quot;
	respectively &quot;hide&quot; entry. Note the engines won&apos;t be hidden entirely
	they are just collapsed.
      </para>
    </listitem>
    <listitem>
      <para>
	To remove an engine open context menu and activate &quot;destroy&quot; entry.
      </para>
    </listitem>
    <listitem>
      <para>
	To rename an engine open context menu and activate &quot;rename&quot; entry.
      </para>
    </listitem>
    <listitem>
      <para>
	To remove an audio object open context menu and activate &quot;rename audio&quot; entry.
	This name can be used by the OSC Server to address the audio object.
      </para>
    </listitem>
    <listitem>
      <para>
	To reposition an audio object open context menu and activate &quot;reposition audio&quot; entry.
	This position can be used by the OSC Server to address the audio object.
      </para>
    </listitem>    
    <listitem>
      <para>
	To open properties dialog open context menu and activate &quot;properties&quot;
	entry. There you might link, resize or asign LADSPA effects to channels.
	NOTE for LADSPA sink or generators aren&apos;t supported, yet.
      </para>
    </listitem>
    <listitem>
      <para>
	To change multiple grouped controls at once check sticky controls.
      </para>
    </listitem>
    <listitem>
      <para>
	Edit gives you editing options.
      </para>
      
      <itemizedlist>
	<listitem>
	  Copy pattern does convert your pattern bitmap into a pattern based notation suitable
	  to paste in notation editor.
	</listitem>
      </itemizedlist>	  
      <itemizedlist>
	<listitem>
	  Envelope opens a dialog with envelope editor, info and pattern editor tab. Allowing you to edit
	  envelope presets and apply to selected notes.
	</listitem>
      </itemizedlist>
	  
    </listitem>
    <listitem>
      <para>
	Connection gives you audio/MIDI options.
      </para>
      
      <itemizedlist>
	<listitem>
	  Audio connection allows you assign output or input soundcards.
	</listitem>
      </itemizedlist>	  
      <itemizedlist>
	<listitem>
	  Midi dialog allows you to assign MIDI sequencers to an instrument.
	</listitem>
      </itemizedlist>
	  
    </listitem>
    <listitem>
      <para>
	Export gives you audio exporting options.
      </para>
      
      <itemizedlist>
	<listitem>
	  Audio export does export your wave data into an audio file without any effect processing.
	</listitem>
      </itemizedlist>	  
	  
    </listitem>    
    <listitem>
      <para>
	To adjust many input controls at once open context menu and activate &quot;sticky controls&quot; entry.
      </para>
    </listitem>
  </itemizedlist>

  <sect1>
    <title>Machine properties</title>
    <para>
      Within properties dialog you can link lines either in single channel or in bulk mode, add effects
      and adjust audio-channels/pads.
    </para>
    
    <sect2>
      <title>Output tab</title>
      <mediaobject>
	<imageobject>
	  <imagedata width="100%" scalefit="1" fileref="../&images;/ags_machine_properties-output.png" format="PNG" />
	</imageobject>
	<caption>
	  <para>
	    The machine properties dialog screenshot - output tab
	  </para>
	</caption>
      </mediaobject>
      <para>
	The output tab lets you mainly perform linking lines and adding effects to them. For each
	line there&apos;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.
      </para>
    </sect2>

    <sect2>
      <title>Input tab</title>
      <mediaobject>
	<imageobject>
	  <imagedata width="100%" scalefit="1" fileref="../&images;/ags_machine_properties-input.png" format="PNG" />
	</imageobject>
	<caption>
	  <para>
	    The machine properties dialog screenshot - input tab
	  </para>
	</caption>
      </mediaobject>
      <para>
	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.
      </para>
    </sect2>

    <sect2>
      <title>Link input tab</title>
      <mediaobject>
	<imageobject>
	  <imagedata width="100%" scalefit="1" fileref="../&images;/ags_machine_properties-link_input.png" format="PNG" />
	</imageobject>
	<caption>
	  <para>
	    The machine properties dialog screenshot - link input tab
	  </para>
	</caption>
      </mediaobject>
      <para>
	Do linking in batch mode. This means you&apos;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.
      </para>
    </sect2>

    <sect2>
      <title>Resize channels tab</title>
      <mediaobject>
	<imageobject>
	  <imagedata width="100%" scalefit="1" fileref="../&images;/ags_machine_properties-resize_channels.png" format="PNG" />
	</imageobject>
	<caption>
	  <para>
	    The machine properties dialog screenshot - resize tab
	  </para>
	</caption>
      </mediaobject>
      <para>
	Adjust audio channels or input/output pads. If supported the GUI may provide more
	lines and pads as increasing the amount.
      </para>
    </sect2>

    <sect2>
      <title>Plugin browser dialog</title>
      <mediaobject>
	<imageobject>
	  <imagedata width="100%" scalefit="1" fileref="../&images;/ags_ladspa_browser.png" format="PNG" />
	</imageobject>
	<caption>
	  <para>
	    The LADSPA browser dialog screenshot
	  </para>
	</caption>
      </mediaobject>
      <para>
	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.
      </para>
    </sect2>
    
  </sect1>

  <sect1>
    <title>Audio connection dialog</title>
    <para>
      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.
    </para>

    <sect2>
      <title>Audio connection output line</title>
      <mediaobject>
	<imageobject>
	  <imagedata width="100%" scalefit="1" fileref="../&images;/ags_audio_connection_output_line.png" format="PNG" />
	</imageobject>
	<caption>
	  <para>
	    The audio connection output line screenshot
	  </para>
	</caption>
      </mediaobject>
      
      <para>
	Select the desired soundcard and don&apos;t forget to click enable. In order apply your modifications.
	After click OK.
      </para>    
    </sect2>

    <sect2>
      <title>Audio connection output bulk</title>
      <mediaobject>
	<imageobject>
	  <imagedata width="100%" scalefit="1" fileref="../&images;/ags_audio_connection_output_bulk.png" format="PNG" />
	</imageobject>
	<caption>
	  <para>
	    The audio connection output bulk screenshot
	  </para>
	</caption>
      </mediaobject>
      
      <para>
	The output connection tab allows you to link a bunch of channel at once.
      </para>    
    </sect2>
    
    <sect2>
      <title>Audio connection input line</title>
      <mediaobject>
	<imageobject>
	  <imagedata width="100%" scalefit="1" fileref="../&images;/ags_audio_connection_input_line.png" format="PNG" />
	</imageobject>
	<caption>
	  <para>
	    The audio connection input line screenshot
	  </para>
	</caption>
      </mediaobject>
      
      <para>
	Select the desired soundcard and don&apos;t forget to click enable. In order apply your modifications.
	After click OK.
      </para>    
    </sect2>

    <sect2>
      <title>Audio connection input bulk</title>
      <mediaobject>
	<imageobject>
	  <imagedata width="100%" scalefit="1" fileref="../&images;/ags_audio_connection_input_bulk.png" format="PNG" />
	</imageobject>
	<caption>
	  <para>
	    The audio connection input bulk screenshot
	  </para>
	</caption>
      </mediaobject>
      
      <para>
	The input connection tab allows you to link a bunch of channel at once.
      </para>    
    </sect2>

  </sect1>

  <sect1>
    <title>Envelope dialog</title>
    <para>
      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.
    </para>

    <para>
      The enelope's width matches with x length 1.0 the audio signal's length. The magnitude has normal
      volume with value 1.0.
    </para>
    
    <sect2>
      <title>Envelope editor</title>
      <mediaobject>
	<imageobject>
	  <imagedata width="100%" scalefit="1" fileref="../&images;/ags_machine_envelope_editor.png" format="PNG" />
	</imageobject>
	<caption>
	  <para>
	    The envelope dialog&apos;s editor tab screenshot
	  </para>
	</caption>
      </mediaobject>
      
      <para>
	Modify or create presets and apply it to selected notes. Selection is performed within notation
	editor.
      </para>

      <para>
	Add new or remove unwanted presets.
      </para>

      <para>
	Attack is the initial x length and y magnitude.
      </para>

      <para>
	Decay is the second x length and y magnitude.
      </para>

      <para>
	Sustain is the third x length and y magnitude.
      </para>

      <para>
	Release is the last x length and y magnitude.
      </para>      

      <para>
	Ratio increase/decrease the entire envelope's magnitude.
      </para>

    </sect2>

    <sect2>
      <title>Envelope info</title>
      <mediaobject>
	<imageobject>
	  <imagedata width="100%" scalefit="1" fileref="../&images;/ags_machine_envelope_info.png" format="PNG" />
	</imageobject>
	<caption>
	  <para>
	    The envelope dialog&apos;s info tab screenshot
	  </para>
	</caption>
      </mediaobject>
      
      <para>
	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.
      </para>    

      <para>
	Plot enables plotting of the matching note's envelope information.
      </para>

      <para>
	Audio channel is the selected note's audio channel.
      </para>

      <para>
	Note x0 is the selected note's x0 offset.
      </para>

      <para>
	Note x1 is the selected note's x1 offset.
      </para>

      <para>
	Note y is the selected note's y key.
      </para>
    </sect2>

    <sect2>
      <title>Envelope pattern</title>
      <mediaobject>
	<imageobject>
	  <imagedata width="100%" scalefit="1" fileref="../&images;/ags_machine_envelope_pattern.png" format="PNG" />
	</imageobject>
	<caption>
	  <para>
	    The envelope dialog&apos;s pattern tab screenshot
	  </para>
	</caption>
      </mediaobject>
      
      <para>
	Modify and create pattern related envelope presets. There are 9 columns with information of
	the pattern's region to apply the envelope preset.
      </para>    

      <para>
	Edit means modify the matchin preset.
      </para>      

      <para>
	Plot enables plotting of the matching envelope preset information.
      </para>

      <para>
	Preset is the preset's name.
      </para>

      <para>
	Audio channel start the preset's start audio channel.
      </para>

      <para>
	Audio channel end the preset's end audio channel.	
      </para>

      <para>
	Pad start the preset's start pad.
      </para>

      <para>
	Pad end the preset's end pad.
      </para>
      
      <para>
	X start the preset's x start offset.
      </para>

      <para>
	X end the preset's x end offset.
      </para>

      <para>
	There are the usual envelope editor controls.
      </para>

      <para>
	Organize your presets with move up and move down. Or add new or remove unwanted presets.
      </para>
    </sect2>

  </sect1>

  
  <sect1>
    <title>MIDI dialog</title>
      <mediaobject>
	<imageobject>
	  <imagedata width="100%" scalefit="1" fileref="../&images;/ags_midi_dialog.png" format="PNG" />
	</imageobject>
	<caption>
	  <para>
	    The MIDI dialog screenshot
	  </para>
	</caption>
      </mediaobject>
      <para>
	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.
      </para>    
  </sect1>
  
  <sect1>
    <title>Panel</title>
    <mediaobject>
      <imageobject>
	<imagedata width="100%" scalefit="1" fileref="../&images;/ags_panel.png" format="PNG" />
      </imageobject>
      <caption>
	<para>
	  The panel screenshot
	</para>
      </caption>
    </mediaobject>
    <para>
      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.
    </para>
    <para>
      Due the synchroneous nature of the output engine you&apos;re just able to adjust the audio
      channels. The output pads aren&apos;t visible and the ones available for input are packed
      vertically.
    </para>
  </sect1>

  <sect1>
    <title>Mixer</title>
    <mediaobject>
      <imageobject>
	<imagedata width="100%" scalefit="1" fileref="../&images;/ags_mixer.png" format="PNG" />
      </imageobject>
      <caption>
	<para>
	  The mixer screenshot
	</para>
      </caption>
    </mediaobject>
    <para>
      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.
    </para>
    <para>
      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&apos;s menu tool
      button. 
    </para>
  </sect1>

  <sect1>
    <title>Spectrometer</title>
    <mediaobject>
      <imageobject>
	<imagedata width="100%" scalefit="1" fileref="../&images;/ags_spectrometer.png" format="PNG" />
      </imageobject>
      <caption>
	<para>
	  The spectrometer screenshot
	</para>
      </caption>
    </mediaobject>
    <para>
      Visualize input by plotting it using FFTW3 library.
    </para>
  </sect1>

  <sect1>
    <title>Equalizer10</title>
    <mediaobject>
      <imageobject>
	<imagedata width="100%" scalefit="1" fileref="../&images;/ags_equalizer10.png" format="PNG" />
      </imageobject>
      <caption>
	<para>
	  The equalizer10 screenshot
	</para>
      </caption>
    </mediaobject>
    <para>
      Adjust a 10 band equalizer with additional pressure control.
    </para>
  </sect1>

  <sect1>
    <title>Drum</title>
    <mediaobject>
      <imageobject>
	<imagedata width="100%" scalefit="1" fileref="../&images;/ags_drum.png" format="PNG" />
      </imageobject>
      <caption>
	<para>
	  The drum screenshot
	</para>
      </caption>
    </mediaobject>
    <para>
      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&apos;s property dialog.
      The drum may contain LADSPA plugins, too.
    </para>
    <para>
      The drum may contain multiple input as well output pads. They are packed on top of the
      composite widget, just below the machine&apos;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.
    </para>
    <para>
      Next to the multi-selection enable open button there&apos;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.
    </para>
    
    <sect2>
      <title>The pattern box</title>
      <para>
	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.
      </para>

      <itemizedlist mark="bullet">
	<listitem>
	  <para>
	    Left, Left-Arrow
	  </para>
	  
	  <itemizedlist mark="bullet">
	    <listitem>
	      <para>
		Move within pattern box left, as the pattern pad control is activate you get
		an audible feedback.
	      </para>
	    </listitem>
	  </itemizedlist>

	</listitem>
	<listitem>
	  <para>
	    Right, Right-Arrow 
	  </para>
	  
	  <itemizedlist mark="bullet">
	    <listitem>
	      <para>
		Move within pattern box right, audible feedback as above.
	      </para>
	    </listitem>
	  </itemizedlist>

	</listitem>
	<listitem>
	  <para>
	    Up, Up-Arrow
	  </para>
	  
	  <itemizedlist mark="bullet">
	    <listitem>
	      <para>
		Decrease pattern box offset about available number of pattern pads, audible feedback as above.
	      </para>
	    </listitem>
	  </itemizedlist>

	</listitem>
	<listitem>
	  <para>
	    Down, Down-Arrow 
	  </para>
	  
	  <itemizedlist mark="bullet">
	    <listitem>
	      <para>
		Increase pattern box offset about available number of pattern pads, audible feedback as above.
	      </para>
	    </listitem>
	  </itemizedlist>

	</listitem>
	<listitem>
	  <para>
	    Space
	  </para>
	  
	  <itemizedlist mark="bullet">
	    <listitem>
	      <para>
		Toggle audio pattern and give audible feedback.
	      </para>
	    </listitem>
	  </itemizedlist>

	</listitem>
	<listitem>
	  <para>
	    Ctrl+c
	  </para>
	  
	  <itemizedlist mark="bullet">
	    <listitem>
	      <para>
		Copy the current pattern to clipboard
	      </para>
	    </listitem>
	  </itemizedlist>

	</listitem>
	<listitem>
	  <para>
	    Tab
	  </para>
	  
	  <itemizedlist mark="bullet">
	    <listitem>
	      <para>
		Leave pattern box focus.
	      </para>
	    </listitem>
	  </itemizedlist>

	</listitem>
      </itemizedlist>

    </sect2>
    
  </sect1>

  <sect1>
    <title>Matrix</title>
    <mediaobject>
      <imageobject>
	<imagedata width="100%" scalefit="1" fileref="../&images;/ags_matrix.png" format="PNG" />
      </imageobject>
      <caption>
	<para>
	  The matrix screenshot
	</para>
      </caption>
    </mediaobject>
    <para>
      Produce an audio stream by defining a pattern. The matrix itselves doesn&apos;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&apos;s properties
      dialog.
    </para>
    <para>
      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.
    </para>
    
    <itemizedlist mark="bullet">
      <listitem>
	<para>
	  Left, Left-Arrow
	</para>
	
	<itemizedlist mark="bullet">
	  <listitem>
	    <para>
	      Move within matrix left, as the pattern pad control is activate you get
	      an audible feedback.
	    </para>
	  </listitem>
	</itemizedlist>

      </listitem>
      <listitem>
	<para>
	  Right, Right-Arrow 
	</para>
	
	<itemizedlist mark="bullet">
	  <listitem>
	    <para>
	      Move within matrix right, audible feedback as above.
	    </para>
	  </listitem>
	</itemizedlist>

      </listitem>
      <listitem>
	<para>
	  Up, Up-Arrow
	</para>
	
	<itemizedlist mark="bullet">
	  <listitem>
	    <para>
	      Decrease matrix offset about available number of pattern pads, audible feedback as above.
	    </para>
	  </listitem>
	</itemizedlist>

      </listitem>
      <listitem>
	<para>
	  Down, Down-Arrow 
	</para>
	
	<itemizedlist mark="bullet">
	  <listitem>
	    <para>
	      Increase matrix offset about available number of pattern pads, audible feedback as above.
	    </para>
	  </listitem>
	</itemizedlist>

      </listitem>
      <listitem>
	<para>
	  Space
	</para>
	
	<itemizedlist mark="bullet">
	  <listitem>
	    <para>
	      Toggle audio pattern and give audible feedback.
	    </para>
	  </listitem>
	</itemizedlist>

      </listitem>
      <listitem>
	<para>
	  Ctrl+c
	</para>
	
	<itemizedlist mark="bullet">
	  <listitem>
	    <para>
	      Copy the current pattern to clipboard
	    </para>
	  </listitem>
	</itemizedlist>

      </listitem>
      <listitem>
	<para>
	  Tab
	</para>
	
	<itemizedlist mark="bullet">
	  <listitem>
	    <para>
	      Leave matrix focus.
	    </para>
	  </listitem>
	</itemizedlist>

      </listitem>
    </itemizedlist>

  </sect1>

  <sect1>
    <title>Synth</title>
    <mediaobject>
      <imageobject>
	<imagedata width="100%" scalefit="1" fileref="../&images;/ags_synth.png" format="PNG" />
      </imageobject>
      <caption>
	<para>
	  The synth screenshot
	</para>
      </caption>
    </mediaobject>
    <para>
      Produce audio data using its oscillators. The count of oscillators depends on number of
      input lines. They are adjusted vertically.
    </para>

    <para>
      Wave is the actual oscillator either sine, sawtooth, square, triangle or impulse.
    </para>

    <para>
     Attack is the first frame after key on to start output.
    </para>

    <para>
      Length is the length of the output in frames.
    </para>

    <para>
      Phase is the initial phase as x offset within oscillator's algorithm.
    </para>

    <para>
      Frequency is the lower range key's frequency.
    </para>

    <para>
      Volume is the output volume of the oscillator.
    </para>

    <para>
      Sync allows you reset the phase with 3 times a tuple of x offset and new x offset of phase.
    </para>
    
    <para>
      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.
    </para>
    
  </sect1>

  <sect1>
    <title>FM Synth</title>
    <mediaobject>
      <imageobject>
	<imagedata width="100%" scalefit="1" fileref="../&images;/ags_fm_synth.png" format="PNG" />
      </imageobject>
      <caption>
	<para>
	  The frequency modulation synth screenshot
	</para>
      </caption>
    </mediaobject>
    <para>
      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.
    </para>

    <para>
      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.
    </para>

    <para>
      LFO wave use specific function to modulate frequency.
    </para>

    <para>
      LFO frequency use specific frequency to modulate frequency.
    </para>

    <para>
      LFO depth is the depth of the frequency modulation.
    </para>

    <para>
      LFO tuning tunes by cents.
    </para>
  </sect1>

  <sect1>
    <title>Syncsynth</title>
    <mediaobject>
      <imageobject>
	<imagedata width="100%" scalefit="1" fileref="../&images;/ags_syncsynth.png" format="PNG" />
      </imageobject>
      <caption>
	<para>
	  The synced synth screenshot
	</para>
      </caption>
    </mediaobject>
    <para>
      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.
    </para>

    <para>
      The Syncsynth has the very same oscillators as Synth.
    </para>
  </sect1>

  <sect1>
    <title>FM Syncsynth</title>
    <mediaobject>
      <imageobject>
	<imagedata width="100%" scalefit="1" fileref="../&images;/ags_fm_syncsynth.png" format="PNG" />
      </imageobject>
      <caption>
	<para>
	  The frequency modulator synced synth screenshot
	</para>
      </caption>
    </mediaobject>
    <para>
      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.
    </para>

    <para>
      The FM Syncsynth has the very same oscillators as FM Synth.
    </para>
  </sect1>

  <sect1>
    <title>Hybrid Synth</title>
    <mediaobject>
      <imageobject>
	<imagedata width="100%" scalefit="1" fileref="../&images;/ags_hybrid_synth.png" format="PNG" />
      </imageobject>
      <caption>
	<para>
	  The hybrid synth screenshot
	</para>
      </caption>
    </mediaobject>

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

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

    <para>
      The pitch tuning does additional frequency shift.
    </para>
    
    <para>
      There is a white noise source, which can adjust its gain.
    </para>

    <para>
      The low-pass filter is disabled by default.
    </para>

    <para>
      The high-pass filter is disabled by default.
    </para>
        
    <para>
      There is a chorus, which provides additional controls.
    </para>
    
    <para>
      The synth is compute just-in-time.
    </para>
  </sect1>

  <sect1>
    <title>Hybrid FM Synth</title>
    <mediaobject>
      <imageobject>
	<imagedata width="100%" scalefit="1" fileref="../&images;/ags_hybrid_fm_synth.png" format="PNG" />
      </imageobject>
      <caption>
	<para>
	  The hybrid frequency modulation synth screenshot
	</para>
      </caption>
    </mediaobject>
    
    <para>
      Produce audio data using 3 FM oscillators. The synth is compute just-in-time.
    </para>

    <para>
      The Hybrid FM Synth has got the same additional effect processors like Hybrid Synth.
    </para>
    
    <para>
      The synth is compute just-in-time.
    </para>
  </sect1>

  <sect1>
    <title>FFPlayer</title>
    <mediaobject>
      <imageobject>
	<imagedata width="100%" scalefit="1" fileref="../&images;/ags_ffplayer.png" format="PNG" />
      </imageobject>
      <caption>
	<para>
	  The ffplayer screenshot
	</para>
      </caption>
    </mediaobject>
    <para>
      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.
    </para>

    <para>
      Synth generator can be enabled to pitch missing keys from lower upto specific key count.
    </para>
    
    <para>
      The ffplayer contains recently the bridge widget. You can add plugins in bulk mode by
      click Add or Remove within AgsFFPlayer&apos;s bridge, what you can collapse/expand. To add an effect
      to a line, you have open as usual input/output of machine properties.
    </para>
  </sect1>

  <sect1>
    <title>SF2 Synth</title>
    <mediaobject>
      <imageobject>
	<imagedata width="100%" scalefit="1" fileref="../&images;/ags_sf2_synth.png" format="PNG" />
      </imageobject>
      <caption>
	<para>
	  The SF2 synth screenshot
	</para>
      </caption>
    </mediaobject>
    
    <para>
      Produce audio data using Soundfont2 files.
    </para>

    <para>
      There is a chorus, which provides additional controls.
    </para>
    
    <para>
      The synth is compute just-in-time.
    </para>
  </sect1>

  <sect1>
    <title>Sampler</title>
    <mediaobject>
      <imageobject>
	<imagedata width="100%" scalefit="1" fileref="../&images;/ags_pitch_sampler.png" format="PNG" />
      </imageobject>
      <caption>
	<para>
	  The pitch sampler screenshot
	</para>
      </caption>
    </mediaobject>
    <para>
      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.
    </para>

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

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

    <itemizedlist mark="bullet">
      <listitem>
	<para>
	  LFO freq
	</para>
      </listitem>

      <listitem>
	<para>
	  LFO phase
	</para>
      </listitem>

      <listitem>
	<para>
	  LFO depth
	</para>
      </listitem>

      <listitem>
	<para>
	  LFO tuning
	</para>
      </listitem>
      
    </itemizedlist>
    
  </sect1>

  <sect1>
    <title>SFZ Synth</title>
    <mediaobject>
      <imageobject>
	<imagedata width="100%" scalefit="1" fileref="../&images;/ags_sfz_synth.png" format="PNG" />
      </imageobject>
      <caption>
	<para>
	  The SFZ synth screenshot
	</para>
      </caption>
    </mediaobject>
    
    <para>
      Produce audio data using SFZ files.
    </para>

    <para>
      There is a chorus, which provides additional controls.
    </para>
    
    <para>
      The synth is compute just-in-time.
    </para>
  </sect1>
  
  <sect1>
    <title>Audiorec</title>
    <mediaobject>
      <imageobject>
	<imagedata width="100%" scalefit="1" fileref="../&images;/ags_audiorec.png" format="PNG" />
      </imageobject>
      <caption>
	<para>
	  The audiorec screenshot
	</para>
      </caption>
    </mediaobject>
    <para>
      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.
    </para>
  </sect1>

</chapter>