Shamusworld >> Repos - ardour-manual/blob - include/io-plugins.html

   1 <p>
   2   I/O plugins are a way to process audio outside the normal Ardour session or
   3   connect to sources typically unavailable in a DAW, such as outputs of NDI
   4   devices. Pre-plugins run before Ardour does any processing, post-plugins run
   5   after Ardour has done all processing.
   6 </p>
   7
   8 <p>
   9   A common use case is wet recording where a number of plugins are applied
  10   directly to the physical input. The processed signal then can be routed to any
  11   number of tracks or busses in Ardour. This is a lot like doing some of the
  12   processing with a chain of guitar pedals, then feeding the signal to an Aux In
  13   port on a mixing console or an input port on a multi-effects digital
  14   pedalboard.
  15 </p>
  16
  17 <p>
  18   The rationale for pre-processing with I/O plugins is that it's a more
  19   lightweight way to do it as compared to busses. Much of that is because busses
  20   have automatable parameters such as fader and panner positions, as well as
  21   plugins' parameters. Evaluating parameter automation (even when there's none)
  22   adds additional load to the CPU. However I/O plugins are not automatable, so
  23   there's no evaluation happening. As far as Ardour is concerned, they are
  24   almost like JACK audio server clients running alongside Ardour.
  25 </p>
  26
  27 <p>
  28   Another use case would be loading an instance of the NDI Input plugin as a
  29   pre-processing plugin to be able to capture and mix sources from NDI devices,
  30   or loading an instance of the NDI Output plugin to send audio from Ardour over
  31   IP to a receiver for broadcasting.
  32 </p>
  33
  34 <figure>
  35   <img style="width:50%;" width="50%" src="/images/io-plugins-ndi-input.png" alt="NDI Input plugin loaded as a pre-processing I/O plugin">
  36   <figcaption>NDI Input plugin loaded as a pre-processing I/O plugin</figcaption>
  37 </figure>
  38
  39 <p>
  40   It's also possible to use the post-processing section to load plugins for room
  41   correction or signal analysis (VU meters, spectrum analyzers etc.).
  42 </p>
  43
  44 <h2>Adding I/O plugins</h2>
  45
  46 <p>
  47   New I/O plugins can be added in the <kbd class="title">I/O Plugins</kbd>
  48   dialog (<kbd class="menu">Window &gt; I/O Plugins</kbd>).
  49 </p>
  50
  51 <figure>
  52   <img style="width:50%;" width="50%" src="/images/io-plugins-empty-slots.png" alt="Empty slots in the I/O Plugins dialog">
  53   <figcaption>Empty slots in the I/O Plugins dialog</figcaption>
  54 </figure>
  55
  56 <p>
  57   Right-clicking opens the same menu for plugin selection available for mixer
  58   channel strips:
  59 </p>
  60
  61 <figure>
  62   <img style="width:50%;" width="50%" src="/images/io-plugins-right-click-menu.png" alt="Right-click menu in the I/O Plugins dialog">
  63   <figcaption>Right-click menu in the I/O Plugins dialog</figcaption>
  64 </figure>
  65
  66 <p>
  67   Double-clicking opens the <kbd class="title">Plugin Selector</kbd> dialog.
  68 </p>
  69
  70 <p>
  71   Once a plugin has been selected and added, it shows in either Pre- or
  72   Post-process section depending on your choice.
  73 </p>
  74
  75 <figure>
  76   <img style="width:50%;" width="50%" src="/images/io-plugins-one-plugin-added.png" alt="ACE Compressor added to the pre- section">
  77   <figcaption>ACE Compressor added to the Pre-process section</figcaption>
  78 </figure>
  79
  80 <h2>Routing I/O plugins</h2>
  81
  82 <p>
  83   I/O plugins have the same user interface for setting input and outputs that is
  84   also available in mixer channel strips. The button above the plugin name opens
  85   a drop-down menu for quickly choosing an input port. The button below opens
  86   the drop-down menu for choosing the output port.
  87 </p>
  88
  89 <figure>
  90   <img style="width:50%;" width="50%" src="/images/io-plugins-choose-output.png" alt="Choosing output for an I/O plugin">
  91   <figcaption>Choosing output for an I/O plugin</figcaption>
  92 </figure>
  93
  94 <p>
  95   Additionally, new tracks automatically connected to an I/O plugin can be
  96   easily created in the <kbd class="title">Recorder</kbd> window by clicking the
  97   <kbd class="key">+</kbd> button and then setting a new for that track.
  98 </p>
  99
 100 <figure>
 101   <img style="width:50%;" width="50%" src="/images/io-plugins-new-track-from-io-plugin.png" alt="New track connected to an I/O plugin">
 102   <figcaption>New track connected to an I/O plugin</figcaption>
 103 </figure>
 104
 105 <p>
 106   On the <kbd class="window">Audio Connections</kbd> dialog, the ports of pre-
 107   and post-process plugins are listed on dedicated tabs
 108   (<kbd class="tab">I/O Pre</kbd> and <kbd class="tab">I/O Post</kbd>),
 109   separately from all other ports.
 110 </p>
 111
 112 <figure>
 113   <img style="width:50%;" width="50%" src="/images/io-plugins-in-audio-connections.png" alt="I/O Plugins in the Audio Connections dialog">
 114   <figcaption>I/O Plugins in the Audio Connections dialog</figcaption>
 115 </figure>