Changes

===Basic chain manipulation===

===Basic chain manipulation===

TODO!

TODO!

===Layering chains ("''clone''")===

===Layering chains (''"clone"'')===

A very common use-case is layering sounds to play unison. This feature was called "clone" in older versions, but this has changed in “oram-bookworm” and the “clone” option does not exist anymore. Now we have better mechanisms because several chains can use the same MIDI channel, so:

A very common use-case is layering sounds to play unison. This feature was called ''"clone"'' in older versions, but this has changed in ''Oram'' and the ''clone'' option does not exist anymore. Now we have better mechanisms because several chains can use the same MIDI channel, so:

* '''The easy way'''

* '''The easy way'''

** If you are using '''''ACTIVE mode''''' for your input device, you must enable '''''Active MIDI chanel''''' in the admin menu. With this enabled, all chains in the same MIDI channel will receive the MIDI stream from the input when some of them is selected (active).

** If you are using '''''ACTIVE mode''''' for your input device, you must enable '''''Active MIDI chanel''''' in the admin menu. With this enabled, all chains in the same MIDI channel will receive the MIDI stream from the input when some of them is selected (active).

** Setup your "''cloned''" chains in the same MIDI channel.

** Setup your ''"cloned"'' chains in the same MIDI channel.

* '''The cool way'''

* '''The cool way'''

** Disable '''''Active MIDI chanel''''' in the admin menu. With this disabled, only the selected (active) chain will receive MIDI from the input, not matter the MIDI channel.

** Disable '''''Active MIDI chanel''''' in the admin menu. With this disabled, only the selected (active) chain will receive MIDI from the input, not matter the MIDI channel.

** Setup your “''cloned''” chains in the same MIDI channel.

** Setup your ''”cloned”'' chains in the same MIDI channel.

** Create a '''''MIDI+Audio chain''''' in the same MIDI channel. We name this chain the '''''GROUP chain'''''. You don’t need to add any processor, so you can select ''None'' from the list.

** Create a '''''MIDI+Audio chain''''' in the same MIDI channel. We name this chain the '''''GROUP chain'''''. You don’t need to add any processor, so you can select ''None'' from the list.

** From the ''GROUP chain'' options, access “MIDI out” and select your “''cloned''” chains. This will route MIDI from the ''GROIUP chain'' to the cloned chains.

** From the ''GROUP chain'' options, access “MIDI out” and select your “''cloned''” chains. This will route MIDI from the ''GROIUP chain'' to the cloned chains.

** Finally, access ''Audio Out'' submenu on each cloned chain: uncheck the ''Main Bus'' and check the ''GROUP chain''. With this you are routing audio from your cloned chains to the ''GROUP chain'', so you can control de mixed audio with the GROUP’s fader.

** Finally, access ''Audio Out'' submenu on each ''"cloned"'' chain: uncheck the ''Main Bus'' and check the ''GROUP chain''. With this you are routing audio from your cloned chains to the ''GROUP chain'', so you can control de mixed audio with the GROUP’s fader.

Using the cool way you can select each chain individually and audition its sound or select the ''GROUP'' chain to play them all simultaneously / layered. You keep full control of each chain (fader, pan, mono, etc.), being able to insert effects and see each peak meter, and you also have overall control of the ''GROUP'' with the same control and monitoring (fader, pan, mono, etc. DPM, effects).

Using the cool way you can select each chain individually and audition its sound or select the ''GROUP'' chain to play them all simultaneously / layered. You keep full control of each chain (fader, pan, mono, etc.), being able to insert effects and see each peak meter, and you also have overall control of the ''GROUP'' with the same control and monitoring (fader, pan, mono, etc. DPM, effects).

Nice, true? I really love the cool way, but there is a little problem with it: latency. When you route-back audio from chain’s output to the ''GROUP chain'', you add latency. This is a general rule in digital audio processing: If you feed-back the signal, you delay 1-period the processed result. Note that the MIDI stream is not delayed because there is no real feed-back and it’s processed linearly.  

Nice, true? I really love the cool way, but there is a little problem with it: latency. When you route-back audio from chain’s output to the ''GROUP chain'', you add latency. This is a general rule in digital audio processing: If you feed-back the signal, you delay 1-period the processed result. Note that the MIDI stream is not delayed because there is no real feed-back and it’s processed linearly.  

You don’t have to do both audio and MIDI grouping, as each one works individually. By not doing the audio grouping you will avoid adding the extra period of latency and you still keep some of the advantages of the "cool way".

You don’t have to do both audio and MIDI grouping, as each one works individually. By not doing the audio grouping you will avoid adding the extra period of latency and you still keep some of the advantages of the ''cool way''.

===Etc.===

===Etc.===