Revision as of 20:00, 25 February 2010

Automation

Automation is the recording and playback of parameter changes over time. A parameter in this case is a DSP effect parameter, such as a Filter's Cutoff or Resonance. Automation in Renoise can be done in two ways: Graphically or with Pattern Effect Commands. Every DSP device in Renoise can be automated. Automation of plug-in instruments is also done via Track FX, by using an *Automation Device.

Creating Automation

The easiest way to create Automation is to record it. This can be done by clicking, holding and moving a DSP effect's slider with the right mouse button while playing back the song. Depending on the Automation setting in the Pattern Editor's Control Bar (File:Vvoois renoise pc dsp automation.png / File:Vvoois renoise pc dsp automation active.png), your changes will then be recorded as either pattern effects or as graphical envelopes.

To quickly create an empty Automation and switch over to the Automation Editor, you can also click on the small rectangle to the right of each parameter:

File:Vvoois renoise automation5.png

(automation rectangles next to the parameter are blue for the first three parameters here)

Automation Editor

The Automation Editor consists of two main parts. To the left you will see a list of all available parameters and devices for the the currently active track. To the right of this is the envelope editor, where you will draw and edit the Automation. Beneath the envelope editor are a series of options and buttons used to edit and modify the envelope. The envelope grid is labelled across the top with numbers that correspond to the line numbers in the Pattern Editor, so the x-axis displays time. The values of the current parameter are shown up and down on the y-axis.

File:Vvoois renoise automation.png

To create an Automation, select the parameter on the left then click somewhere inside the grid, creating an automation point. Alternatively, double-click the name of the parameter on the left. This will create an envelope and insert a point at line 0 with the parameter's current value.

Automation State Icons

When an Automation exists for the current pattern, the parameter in the list to the left has a small blue icon next to it (colour can vary with different Themes). The same blue icon appears next to the parameter in the Track DSPs tab. If a parameter has Automation but it is not active in the current pattern, then the icon will be grey (again, this colour can vary according to the Theme).

Editing Automation Envelopes

Once you've created an Automation, it can be edited with the mouse or keyboard in various ways:

Editing with the Mouse

Clicking in the envelope where no point is set will create a new point. Double-clicking on an existing point will remove it. If you click and hold on an existing point then you can drag it around and set a new value. Clicking, holding and moving with the right mouse button will draw a series of points, allowing you to quickly draw a shape.

"Shift" + Moving points will remove all points that the mouse pointer touches.
"Control" + Dragging a point will fine-tune its value. "Control" + Hovering over a point will display the point's value.
"Alt" + Drag will move a selection of points up, down, left or right. Dragging with the right mouse button will rescale the points instead of moving them.
"Alt + Shift" + Dragging will move the points to new values but lock their pattern line positions.

Clicking and dragging on the rulers above and below the envelope will select an area. Right clicking opens a context menu with various options to affect the selection.

Editing with the Keyboard

If you middle-click on the envelope, or right-click on the small rulers above and below the envelope and select "(Set Keyboard Focus Here)", you can control the envelope with keyboard shortcuts:

To move the selection cursor in the envelope, use the left/right arrow keys or the "Home" and "End" keys.
To select parts of the envelope, hold down the "Shift" key while moving the cursor.
To create a new point or remove an existing one, hit the "Enter" key.
To enter an exact value for a point in the numerical edit field, press "Shift + Enter" and type in the value.

For other operations like copy/paste, right-click on the small rulers above and below the envelope to open the context menu.

Automation Tools

File:Vvoois renoise automation4.png

The toolbar below the envelope contains a few options and tools. From left to right they are:

File:Vvoois renoise automation cut.png - Copies the current envelope into the clipboard, then removes it from the editor.
File:Vvoois renoise automation copy.png - Copies the current envelope into the clipboard.
File:Vvoois renoise automation paste.png - Pastes a previously copied envelope from the clipboard.

File:Vvoois renoise automation value.png - Shows the value of the currently selected point. Double-click to enter a new value.

File:Vvoois renoise automation zoom.png - Choose the zoom factor of the envelope view.

File:Vvoois renoise automation3.png - Select the envelope type:
- Point: Only changes value when a point is encountered.
- Linear: Values are changed along the Automation line, which is interpolated linearly between points.
- Cubic: Values are changed along the Automation line, which eases into and out of points.

File:Vvoois renoise automation presets.png - These are slots used to store presets (right-mouse button = store, left-mouse button = recall). The presets are saved in the preferences, so they are retained when loading or starting new songs.

Processing tools:
- File:Vvoois renoise automation yflip.png - Flip the curve or points in the current selection across the vertical-axis (flip values).
- File:Vvoois renoise automation xflip.png - Flip the curve or points in the current selection across the horizontal-axis (flip times).
- File:Vvoois renoise automation humanise.png - Add a small amount of randomisation to each value for a more "human" feel.

Generate tools:
- File:Vvoois renoise automation gencurve.png - Generate a smoothly rising logarithmic curve. Use the flip buttons after generating to create other curves.
- File:Vvoois renoise automation genrandom.png - Generate a random envelope.

Automation List

The list indicates which parameters are automated with a small icon next to their name. Left clicking on a parameter will select it, while double-clicking on a parameter which has no Automation will create a new blank envelope.

Right-clicking on a name allows you to delete the Automation for the current pattern or the whole song. This also applies when right-clicking on a DSP device name, which will delete the Automation for all of the effect's parameters.

The search field at top of the list allows you to quickly find a parameter or effect. Enabling the "Automated Only" button will only show effects in the list which are already automated.

Tips

To create Automations which cover more than one pattern, you can use a small trick to set up the correct start and end points. Let's say we want to create a volume ramp from -INF dB to 0 dB over multiple patterns:

Go to the first pattern and set the volume to -INF.
Go to the Automation Editor and double-click the volume parameter in the parameter list. This will create one point at -INF at the beginning of the envelope.
Add another point at -24 dB at the end of the envelope.
Switch over to the next pattern.
Again, double-click the volume parameter in the parameter list. This will now create one point at -24 dB, the parameter's last Automation value.
Repeat the same procedure for the next patterns until you reached 0 dB.

@@ Line 6: / Line 6: @@
 == Creating Automation ==
-The easiest way to create Automation is to record it. This can be done by clicking, holding and moving a DSP effect's slider with the right mouse button while playing back the song. Depending on the Automation setting in the [[Pattern Editor]]'s Control Bar ([[Image:Vvoois_renoise_pc_dsp_automation.png]] / [[Image:Vvoois_renoise_pc_dsp_automation_active.png]]) your changes will then be recorded as either pattern effects or as graphical envelopes.
+The easiest way to create Automation is to record it. This can be done by clicking, holding and moving a DSP effect's slider with the right mouse button while playing back the song. Depending on the Automation setting in the [[Pattern Editor]]'s Control Bar ([[Image:Vvoois_renoise_pc_dsp_automation.png]] / [[Image:Vvoois_renoise_pc_dsp_automation_active.png]]), your changes will then be recorded as either pattern effects or as graphical envelopes.
 To quickly create an empty Automation and switch over to the Automation Editor, you can also click on the small rectangle to the right of each parameter:
@@ Line 17: / Line 17: @@
 == Automation Editor ==
-The Automation Editor consists of two main parts. To the left you will see a list of all available parameters and devices for the the currently active track. To the right of this is the envelope editor, where you will draw and edit the Automation. Beneath the envelope editor are a series of options and buttons used to edit and modify the envelope. The envelope grid is labelled across the top with numbers that correspond to the line numbers in the [[Pattern Editor]], so the x-axis display time. The values of the current parameter are shown up and down on the y-axis.
+The Automation Editor consists of two main parts. To the left you will see a list of all available parameters and devices for the the currently active track. To the right of this is the envelope editor, where you will draw and edit the Automation. Beneath the envelope editor are a series of options and buttons used to edit and modify the envelope. The envelope grid is labelled across the top with numbers that correspond to the line numbers in the [[Pattern Editor]], so the x-axis displays time. The values of the current parameter are shown up and down on the y-axis.
 [[Image:vvoois_renoise_automation.png]]
-To create an Automation, select the parameter on the left then click somewhere inside the grid, creating an automation point. Alternatively, double-click the name of the parameter on the left. This will create an envelope with one point at the parameter's current value.
+To create an Automation, select the parameter on the left then click somewhere inside the grid, creating an automation point. Alternatively, double-click the name of the parameter on the left. This will create an envelope and insert a point at line 0 with the parameter's current value.
 == Automation State Icons ==
-When an Automation exists for the current pattern, the parameter in the list to the left has a small blue icon next to it (colour can vary with different Themes). The same blue icon appears next to the effects in the [[Track DSPs]] tab. If a parameter has Automation, but it is not active in the current pattern, then the icon will be grey (again, this colour can vary according to the Theme).
+When an Automation exists for the current pattern, the parameter in the list to the left has a small blue icon next to it (colour can vary with different Themes). The same blue icon appears next to the parameter in the [[Track DSPs]] tab. If a parameter has Automation but it is not active in the current pattern, then the icon will be grey (again, this colour can vary according to the Theme).
 === Editing Automation Envelopes ===
@@ Line 34: / Line 34: @@
 ==== Editing with the Mouse ====
-Clicking in the envelope where no point is set will create a new point. Double-clicking on an existing point will remove it. Clicking near to an existing point, you can drag it around and set a new value. Clicking, holding and moving with the right mouse button will draw a series of points, so you can quickly draw a shape.
+Clicking in the envelope where no point is set will create a new point. Double-clicking on an existing point will remove it. If you click and hold on an existing point then you can drag it around and set a new value. Clicking, holding and moving with the right mouse button will draw a series of points, allowing you to quickly draw a shape.
 * ''"Shift"'' + Moving points will remove all points that the mouse pointer touches.
 * ''"Control"'' + Dragging a point will fine-tune its value. ''"Control"'' + Hovering over a point will display the point's value.
 * ''"Alt"'' + Drag will move a selection of points up, down, left or right. Dragging with the right mouse button will rescale the points instead of moving them.
-* ''"Alt + Shift"'' + Right-click dragging only, will move the points to new values but lock their pattern line positions.
+* ''"Alt + Shift"'' + Dragging will move the points to new values but lock their pattern line positions.
-Clicking and dragging on the rulers above and below the envelope lets you select a part of the envelope. Right clicking opens a context menu with various options to affect the selection.
+Clicking and dragging on the rulers above and below the envelope will select an area. Right clicking opens a context menu with various options to affect the selection.
 ==== Editing with the Keyboard ====
@@ Line 50: / Line 50: @@
 * To select parts of the envelope, hold down the ''"Shift"'' key while moving the cursor.
 * To create a new point or remove an existing one, hit the ''"Enter"'' key.
-* To enter an exact value for a point in the numerical edit field press '"Shift + Enter"'' and type in the value.
+* To enter an exact value for a point in the numerical edit field, press ''"Shift + Enter"'' and type in the value.
 For other operations like copy/paste, right-click on the small rulers above and below the envelope to open the context menu.
@@ Line 60: / Line 60: @@
 The toolbar below the envelope contains a few options and tools. From left to right they are:
-* [[Image:vvoois_renoise_automation_cut.png]]: Copies the current envelope into the clipboard, then removes it.
+* [[Image:vvoois_renoise_automation_cut.png]] - Copies the current envelope into the clipboard, then removes it from the editor.
-* [[Image:vvoois_renoise_automation_copy.png]]: Copies the current envelope into the clipboard.
+* [[Image:vvoois_renoise_automation_copy.png]] - Copies the current envelope into the clipboard.
-* [[Image:vvoois_renoise_automation_paste.png]]: Pastes a previously copied envelope from the clipboard.
+* [[Image:vvoois_renoise_automation_paste.png]] - Pastes a previously copied envelope from the clipboard.
-* [[Image:vvoois_renoise_automation_value.png]]: Shows the value of the currently selected point. Double-click to enter a new value.
+* [[Image:vvoois_renoise_automation_value.png]] - Shows the value of the currently selected point. Double-click to enter a new value.
-* [[Image:vvoois_renoise_automation_zoom.png]]: Choose the zoom factor of the envelope view.
+* [[Image:vvoois_renoise_automation_zoom.png]] - Choose the zoom factor of the envelope view.
-* [[Image:vvoois_renoise_automation3.png]]: Select the envelope type:
+* [[Image:vvoois_renoise_automation3.png]] - Select the envelope type:
 ** '''Point:''' Only changes value when a point is encountered.
 ** '''Linear:''' Values are changed along the Automation line, which is interpolated linearly between points.
 ** '''Cubic:''' Values are changed along the Automation line, which eases into and out of points.
-* [[Image:vvoois_renoise_automation_presets.png]]: These are slots used to store presets (right-mouse button = store, left-mouse button = recall). The presets are saved in the preferences, so they are retained when loading or starting new songs.
+* [[Image:vvoois_renoise_automation_presets.png]] - These are slots used to store presets (right-mouse button = store, left-mouse button = recall). The presets are saved in the preferences, so they are retained when loading or starting new songs.
 * Processing tools:
-** [[Image:vvoois_renoise_automation_yflip.png]]: Flip the curve or points in the current selection across the vertical-axis (flip values).
+** [[Image:vvoois_renoise_automation_yflip.png]] - Flip the curve or points in the current selection across the vertical-axis (flip values).
-** [[Image:vvoois_renoise_automation_xflip.png]]: Flip the curve or points in the current selection across the horizontal-axis (flip times).
+** [[Image:vvoois_renoise_automation_xflip.png]] - Flip the curve or points in the current selection across the horizontal-axis (flip times).
-** [[Image:vvoois_renoise_automation_humanise.png]]: Add randomly errors to each value for a more "real" feeling.
+** [[Image:vvoois_renoise_automation_humanise.png]] - Add a small amount of randomisation to each value for a more "human" feel.
 * Generate tools:
-** [[Image:vvoois_renoise_automation_gencurve.png]]: generate a smooth logarithmic. Use the flip buttons to create other directions.
+** [[Image:vvoois_renoise_automation_gencurve.png]] - Generate a smoothly rising logarithmic curve. Use the flip buttons after generating to create other curves.
-** [[Image:vvoois_renoise_automation_genrandom.png]]: Generate a random curve.
+** [[Image:vvoois_renoise_automation_genrandom.png]] - Generate a random envelope.
 == Automation List ==
-The list displays which parameters are automated with a small icon next to their name. Left clicking on a name will select that parameter, while double-clicking on a name without an Automation will create a new blank envelope
+The list indicates which parameters are automated with a small icon next to their name. Left clicking on a parameter will select it, while double-clicking on a parameter which has no Automation will create a new blank envelope.
-Right-clicking on a name allows you to delete the Automation for the current pattern or the whole song. This also applies when right-clicking a DSP device name, which will delete the Automations for all of the effect's parameters.
+Right-clicking on a name allows you to delete the Automation for the current pattern or the whole song. This also applies when right-clicking on a DSP device name, which will delete the Automation for all of the effect's parameters.
-The search field at top of the list allows you to quickly find a parameter or effect. Enabling the ''"Automated Only"'' button will only show effects in the list which already are automated.
+The search field at top of the list allows you to quickly find a parameter or effect. Enabling the ''"Automated Only"'' button will only show effects in the list which are already automated.
@@ Line 100: / Line 100: @@
 # Go to the first pattern and set the volume to -INF.
 # Go to the Automation Editor and double-click the volume parameter in the parameter list. This will create one point at -INF at the beginning of the envelope.
-# Add another point at -24 dB at the end of the envelope as last point.
+# Add another point at -24 dB at the end of the envelope.
 # Switch over to the next pattern.
-# Again, double-click the volume parameter in the parameter list. This will now create one point at -24 dB, the parameter's last automation value.
+# Again, double-click the volume parameter in the parameter list. This will now create one point at -24 dB, the parameter's last Automation value.
-# Repeat the same procedure with the next patterns until you reached 0 dB.
+# Repeat the same procedure for the next patterns until you reached 0 dB.

Graphical Automation: Difference between revisions