Graphical Automation: Difference between revisions

From Renoise User Manual
Jump to: navigation, search
imported>Vvoois
mNo edit summary
No edit summary
 
(42 intermediate revisions by 3 users not shown)
Line 1: Line 1:
= Automation =
= Graphical 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. Every DSP device in Renoise can be automated. Automation can be achieved by two separate methods: graphically or with [[Pattern Effect Commands]]. Automation of plug-in instruments and their parameters is also possible by using an [[Meta Devices#*Automation_Device|*Automation Device]].
Automation is the recording and playback of parameter changes over time. A parameter in this case is a [[Effect Chains|Track Effects]] parameter, such as a [[Audio_Effects#Distortion|Distortion's]] Drive or Tone. Every effect device in Renoise can be automated, which can be achieved by two separate methods: graphically or with [[Effect Commands#Device Commands|Effect Commands]]. Automation of [[Plugin]] instruments and their parameters is also possible by using an [[Meta_Devices#Instrument_Devices_.28Renoise_only.29|*Instr. Automation Device]].


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 [[Effect Chains|Track Effect's]] slider with the right mouse button while playing back the song. Depending on the Automation setting in the [[Pattern_Editor#Pattern_Editor_Control_Panel|Pattern Editor's Control Panel]] [[Image:3.2_patterneditor-automation.png|text-bottom]], your changes will then be recorded as either [[Effect Commands]] 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:
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. When a parameter is automated, an icon is shown in this rectangle. In the image below, the icons next to the parameters represent automation by ''(top to bottom)'': [[Effect Commands]], envelopes, both.


[[Image:vvoois_renoise_automation5.png]]
[[Image:3.2_automation-smallicons.png]]


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


== Automation ==


== Automation Editor ==
To open the Automation Editor, select its icon at the lower left corner of the Renoise interface: [[Image:3.2_lowerstatusbar-automation.png|text-bottom]]


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 Automation Editor consists of two main parts. To the left you will see a list of all available parameters and devices for 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. You can expand the editor's vertical size by click-dragging the bar just above it.


The envelope grid is labelled along the x-axis at the top with numbers that represent time. The values of the current parameter are represented along the y-axis.
The envelope grid is labelled along the x-axis at the top with numbers that represent time as the [[Tracker_Interface#Lines|line-numbers]] of the [[Pattern Editor]]. The value range of the selected parameter is represented along the y-axis.


[[Image:2.7_automation_editor.png|frameless|800px|left]] <br style="clear: both" />
[[Image:3.2_automation.png]]
 
The Automation Editor will follow the progress of a song's playback as it playing. To turn off this behaviour, allowing you to edit any part of the automation while a song is playing, disable Pattern Follow mode in the [[Transport Panel]].


The Automation Editor will follow the progress of a song's playback as it playing. To turn off this behaviour, allowing you to edit the automation of ''any'' pattern while a song is playing, disable Pattern Follow mode in the [[Transport Panel]].


=== Zoom Levels ===
=== Zoom Levels ===


You can zoom in and out of the Automation envelope by placing mouse pointer over the grid and scrolling the mouse wheel. The default zoom level is one pattern and so the numbers along the x-axis show the pattern line numbers. Zooming in you can begin to see fractions of lines all the way down to 1/256th, allowing for incredible resolution should you need it. Zooming out you can see individual patterns and eventually the entire song. The pattern you are currently editing is highlighted, which you can change by clicking on another.
You can zoom in and out of the Automation envelope by placing the mouse pointer over the grid and scrolling the mouse wheel. The default zoom level is a single pattern, with the x-axis showing the full range of the pattern's line-numbers. Zooming in you can begin to see fractions of lines all the way down to 1/256th, allowing for incredible resolution should you need it. Zooming out you can see individual patterns and eventually the entire song. Pattern numbers are shown in an envelope's top left corner. The pattern you are currently editing is highlighted, which you can change by clicking on another.


When '''Lock''' is enabled, the zoom level is shown beneath the grid in the [[#Automation Tools|Automation Toolbar]] and can be changed there too.
When '''Lock''' is enabled, the zoom level is shown beneath the grid in the [[#Automation Tools|Automation Toolbar]] and can be changed there too.


<!-- RENOISE_NO_PDF_START -->
<!-- RENOISE_NO_PDF_START -->
 
[[Image:3.2_automation-zoomlevels.gif‎]]
[[Image:2.7_automation_editor_zoom_animation.gif‎]]
 
<!-- RENOISE_NO_PDF_STOP -->
<!-- RENOISE_NO_PDF_STOP -->


Line 39: Line 36:
To create an Automation point, select a parameter from the [[#Automation List|Automation List]] and then double-left-click somewhere inside the grid. Alternatively, double-click on the parameter, which will create an envelope and insert a point at line 0 with the parameter's current value.
To create an Automation point, select a parameter from the [[#Automation List|Automation List]] and then double-left-click somewhere inside the grid. Alternatively, double-click on the parameter, which will create an envelope and insert a point at line 0 with the parameter's current value.


To create pre-specified line-patterns, rightclick on the automation grid area and expand the "Process" option, there you can select the options"Create random points", "Create linear curve" and "create exponential curve".
To create pre-defined patterns, right-click on the Automation grid area and expand the "Process" option. There you can select the options "Create Random Points", "Create Linear Curve", "Create Exponential Curve" and "Create Sine Curve".
 
See also [[#Editing with the mouse|editing with the mouse]]


When an Automation already exists for the current pattern, that parameter's name will be highlighted in the [[#Automation List|Automation List]].
When an Automation already exists for the current pattern, that parameter's name will be highlighted in the [[#Automation List|Automation List]].
Line 51: Line 46:
==== Editing with the Mouse ====
==== Editing with the Mouse ====


Double-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. You can also use the Draw tool located in the bottom left of the [[#Automation Tools|toolbar]] to manually draw in a waveform. If the Snap mode is off or enabled and set to ''"Grid"'', then the waveform will be drawn at the resolution of the current zoom level.
Double-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. You can also use the Draw tool located at the bottom left of the [[#Automation Tools|toolbar]] to manually draw in a waveform. If the Snap mode is disabled, or is enabled and set to ''"Grid"'', then the waveform will be drawn at the resolution of the current zoom level.
 
* ''"Left Shift"'' + moving a point horizontally will remove all points that the mouse pointer touches.
* ''"Left Control"'' + moving a point vertically will fine-tune its value. ''"Left Control"'' + hovering over a point will display the point's value.
 
Left-click and dragging across the grid will create a highlighted area. Any points within this area will be selected and can be adjusted all at once. You can also use the right-click menu on the grid to use the selected area in following ways:


* ''"Left Shift"'' + Moving points will remove all points that the mouse pointer touches.
==== Right-click Context Menu ====
* ''"Left Control"'' + Dragging a point will fine-tune its value. ''"Left Control"'' + Hovering over a point will display the point's value.


Left-click and dragging across the grid will create a highlighted area. Any points within this area will be selected and can be adjusted all at once. You can also use the right-click menu on the grid to copy, paste, paste continuously to the end of the envelope and insert ''(moves the existing waveform to the right)'' selected areas.
* '''Cut:''' Cut only the points contained within the selection area.
* '''Copy:''' Copy the selection area.
* '''Paste:''' Paste the previously copied points into the envelope from the cursor position (left-clicking in the envelope will set the cursor position for pasting operations).
* '''Paste Continuously:''' Paste the previously copied points into the envelope from the cursor position and repeat until the end of the envelope.
* '''Insert Paste:''' Paste the previously copied points into the envelope from the cursor position and move the rest of the envelope to right. Note that any points shifted outside of the current pattern will be lost.


The right-click menu also contains some additional options in the Process sub-menu:
* '''Cut Selected Time:''' Cut the selected area of time from the envelope.
* '''Delete Envelope:''' Delete the whole envelope.


[[Image:2.7_automation_context_menu_process.png‎]]
* '''Process:''' Applies to the entire envelope or the selected area if there is one.
** '''Create Random Points:''' Creates points of random value.
** '''Create Exponential Curve:''' Creates an exponential curve rising from 0 to 1. Use the flip buttons to achieve other curves.
** '''Create Linear Curve:''' Creates a linear curve rising from 0 to 1.
** '''Create Sine Curve:''' Creates a single cycle sine curve.


==== Editing with the Keyboard ====
==== Editing with the Keyboard ====
Line 70: Line 78:
* To enter an exact value for a point in the numerical edit field, press ''"Left Shift + Enter"'' and type in the value.
* To enter an exact value for a point in the numerical edit field, press ''"Left Shift + Enter"'' and type in the value.
* To select parts of the envelope, hold down the ''"Left Shift"'' key while moving the cursor.
* To select parts of the envelope, hold down the ''"Left Shift"'' key while moving the cursor.
** To cut the selection press ''"Left Control + X"''.
** To copy the selection press ''"Left Control + C"''.
** To copy the selection press ''"Left Control + C"''.
** To paste the copied selection, move the cursor to the desired position and press ''"Left Control + V"'', or ''"Left Control + P"'' to paste it continuously until the end of the envelope.
** To paste the cut/copied selection, move the cursor to the desired position and press ''"Left Control + V"'', or ''"Left Control + P"'' to paste continuously, or ''"Left Control + I"'' to insert.
** ''"Left Control + K"'' will cut the selected area of time from the envelope.


==== Tip For Smooth Pattern Transitions ====
==== Tip For Smooth Pattern Transitions ====
Line 77: Line 87:
To maintain a smooth envelope between two patterns, simply create a point in the second pattern's envelope and move it to the beginning of the pattern. Now, as you move the point up/down, it will automatically snap to the waveform of the previous pattern.
To maintain a smooth envelope between two patterns, simply create a point in the second pattern's envelope and move it to the beginning of the pattern. Now, as you move the point up/down, it will automatically snap to the waveform of the previous pattern.


=== Automation Tools ===
=== Automation Controls And Options ===


[[Image:2.7_automation_toolbar.png]]
[[Image:3.2_automation-options.png]]


The toolbar below the envelope contains a few options and tools. From left to right they are:
* '''Draw:''' Draw mode allows you to draw points on the envelope with the mouse.
* '''Line:''' The Line tool allows you to create a linear ramp. This will be maintained across multiple patterns.
* '''Snap:''' Will snap the horizontal creation and movement of points to:
** The current resolution of the grid.
** Every pattern-line.
** Every beat.
* '''Value:''' The value of the selected point. Left-click to enter a new value.
* '''Snap to Value:''' Lock and choose the zoom factor of the envelope view.
* '''Envelope Type:''' Dictates how the envelope's value will change over time.
** '''Points:''' Only changes value when a point is encountered.
** '''Lines:''' Initially interpolates in a straight line, but the handles between points can be used to create curves and control their easing.
** '''Curves:''' Interpolates with a smooth cubic curve, easing into and out of points.


* [[Image:2.7_automation_toolbar_draw_button.png]] - Activates Draw mode for drawing Automations by hand.
[[Image:3.2_automation-options-extra.png]]


* [[Image:2.7_automation_toolbar_line_button.png]] - Activates the Line tool, allowing you to create a linear ramp across multiple patterns.
* [[Image:3.0_waveform-cut.png|text-bottom]] - Cut the whole envelope.
* [[Image:3.0_modulation-copy.png|text-bottom]] - Copy the whole envelope.
* [[Image:3.0_modulation-paste.png|text-bottom]] - Paste the whole envelope.
* [[Image:3.1_automation-presets.png|text-bottom]] - User-configurable envelope presets. Right-clicking a button will store the current envelope as a preset, left clicking will recall a previously stored envelope.
* [[Image:3.0_modulation-move.png|text-bottom]] - Move the envelope or selected points to the left/right. Will wrap around the edges.
* [[Image:3.0_modulation-flip.png|text-bottom]] - Flip the envelope or selected points horizontally/vertically.
* [[Image:3.0_modulation-humanize.png|text-bottom]] - Humanizes the envelope or selected area by randomly adding or subtracting a small amount to the point values.


* [[Image:2.7_automation_toolbar_snapping_mode.png]] - Will snap the creation and movement of points to the current resolution of the grid, every pattern line or every beat.
=== Automation List ===


* [[Image:2.7_automation_toolbar_lock_mode.png]] - Lock and choose the zoom factor of the envelope view.
[[Image:3.2_automation-list.png]]


* [[Image:vvoois_renoise_automation3.png]] - Select the envelope type:
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.
** '''Points:''' 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_value.png]] - Shows the value of the currently selected point. Left-click to enter a new value.
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 device name, which will delete the Automation for all of the effect's parameters.


* [[Image:vvoois_renoise_automation_cut.png]] - Copies the current envelope into the clipboard, then removes it from the editor.
The search field at the 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.
* [[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_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:2.7_automation_toolbar_flip_vertical.png]] - Flip the curve or points in the current selection across the vertical-axis (flip values).
** [[Image:2.7_automation_toolbar_flip_horizontal.png]] - Flip the curve or points in the current selection across the horizontal-axis (flip times).
** [[Image:2.7_automation_toolbar_rotate_buttons.png]] - Shifts the current selection to the left or right. Will wrap around the edges of the selection, or the pattern if none is selected.
 
 
== Automation List ==


[[Image:2.7_automation_editor_automation_state.png]]


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.
== Master Track Extras ==


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.
In addition to the usual effect parameters, the [[Pattern_Editor#Master_Track|Master Track]] allows you to control three additional native Renoise parameters via Automation: the song's [[Transport_Panel#Song Parameters|Beats Per Minute]], [[Transport_Panel#Song Parameters|Lines Per Beat]] and [[Song_Options#Playback_Options|Ticks Per Line]] settings. Unlike other parameters though, these three will only update once per line and points cannot be placed between the lines.


The search field at the 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.
[[Image:3.2_automation-mastertrack.png]]

Latest revision as of 16:56, 20 July 2022

Graphical Automation

Automation is the recording and playback of parameter changes over time. A parameter in this case is a Track Effects parameter, such as a Distortion's Drive or Tone. Every effect device in Renoise can be automated, which can be achieved by two separate methods: graphically or with Effect Commands. Automation of Plugin instruments and their parameters is also possible by using an *Instr. Automation Device.

The easiest way to create Automation is to record it. This can be done by clicking, holding and moving a Track Effect's slider with the right mouse button while playing back the song. Depending on the Automation setting in the Pattern Editor's Control Panel 3.2 patterneditor-automation.png, your changes will then be recorded as either Effect Commands 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. When a parameter is automated, an icon is shown in this rectangle. In the image below, the icons next to the parameters represent automation by (top to bottom): Effect Commands, envelopes, both.

3.2 automation-smallicons.png


Automation

To open the Automation Editor, select its icon at the lower left corner of the Renoise interface: 3.2 lowerstatusbar-automation.png

The Automation Editor consists of two main parts. To the left you will see a list of all available parameters and devices for 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. You can expand the editor's vertical size by click-dragging the bar just above it.

The envelope grid is labelled along the x-axis at the top with numbers that represent time as the line-numbers of the Pattern Editor. The value range of the selected parameter is represented along the y-axis.

3.2 automation.png

The Automation Editor will follow the progress of a song's playback as it playing. To turn off this behaviour, allowing you to edit the automation of any pattern while a song is playing, disable Pattern Follow mode in the Transport Panel.

Zoom Levels

You can zoom in and out of the Automation envelope by placing the mouse pointer over the grid and scrolling the mouse wheel. The default zoom level is a single pattern, with the x-axis showing the full range of the pattern's line-numbers. Zooming in you can begin to see fractions of lines all the way down to 1/256th, allowing for incredible resolution should you need it. Zooming out you can see individual patterns and eventually the entire song. Pattern numbers are shown in an envelope's top left corner. The pattern you are currently editing is highlighted, which you can change by clicking on another.

When Lock is enabled, the zoom level is shown beneath the grid in the Automation Toolbar and can be changed there too.

3.2 automation-zoomlevels.gif

Creating Automation

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

To create pre-defined patterns, right-click on the Automation grid area and expand the "Process" option. There you can select the options "Create Random Points", "Create Linear Curve", "Create Exponential Curve" and "Create Sine Curve".

When an Automation already exists for the current pattern, that parameter's name will be highlighted in the Automation List.

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

Double-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. You can also use the Draw tool located at the bottom left of the toolbar to manually draw in a waveform. If the Snap mode is disabled, or is enabled and set to "Grid", then the waveform will be drawn at the resolution of the current zoom level.

  • "Left Shift" + moving a point horizontally will remove all points that the mouse pointer touches.
  • "Left Control" + moving a point vertically will fine-tune its value. "Left Control" + hovering over a point will display the point's value.

Left-click and dragging across the grid will create a highlighted area. Any points within this area will be selected and can be adjusted all at once. You can also use the right-click menu on the grid to use the selected area in following ways:

Right-click Context Menu

  • Cut: Cut only the points contained within the selection area.
  • Copy: Copy the selection area.
  • Paste: Paste the previously copied points into the envelope from the cursor position (left-clicking in the envelope will set the cursor position for pasting operations).
  • Paste Continuously: Paste the previously copied points into the envelope from the cursor position and repeat until the end of the envelope.
  • Insert Paste: Paste the previously copied points into the envelope from the cursor position and move the rest of the envelope to right. Note that any points shifted outside of the current pattern will be lost.
  • Cut Selected Time: Cut the selected area of time from the envelope.
  • Delete Envelope: Delete the whole envelope.
  • Process: Applies to the entire envelope or the selected area if there is one.
    • Create Random Points: Creates points of random value.
    • Create Exponential Curve: Creates an exponential curve rising from 0 to 1. Use the flip buttons to achieve other curves.
    • Create Linear Curve: Creates a linear curve rising from 0 to 1.
    • Create Sine Curve: Creates a single cycle sine curve.

Editing with the Keyboard

If you middle-click on the envelope, or right-click 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 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 "Left Shift + Enter" and type in the value.
  • To select parts of the envelope, hold down the "Left Shift" key while moving the cursor.
    • To cut the selection press "Left Control + X".
    • To copy the selection press "Left Control + C".
    • To paste the cut/copied selection, move the cursor to the desired position and press "Left Control + V", or "Left Control + P" to paste continuously, or "Left Control + I" to insert.
    • "Left Control + K" will cut the selected area of time from the envelope.

Tip For Smooth Pattern Transitions

To maintain a smooth envelope between two patterns, simply create a point in the second pattern's envelope and move it to the beginning of the pattern. Now, as you move the point up/down, it will automatically snap to the waveform of the previous pattern.

Automation Controls And Options

3.2 automation-options.png

  • Draw: Draw mode allows you to draw points on the envelope with the mouse.
  • Line: The Line tool allows you to create a linear ramp. This will be maintained across multiple patterns.
  • Snap: Will snap the horizontal creation and movement of points to:
    • The current resolution of the grid.
    • Every pattern-line.
    • Every beat.
  • Value: The value of the selected point. Left-click to enter a new value.
  • Snap to Value: Lock and choose the zoom factor of the envelope view.
  • Envelope Type: Dictates how the envelope's value will change over time.
    • Points: Only changes value when a point is encountered.
    • Lines: Initially interpolates in a straight line, but the handles between points can be used to create curves and control their easing.
    • Curves: Interpolates with a smooth cubic curve, easing into and out of points.

3.2 automation-options-extra.png

  • 3.0 waveform-cut.png - Cut the whole envelope.
  • 3.0 modulation-copy.png - Copy the whole envelope.
  • 3.0 modulation-paste.png - Paste the whole envelope.
  • 3.1 automation-presets.png - User-configurable envelope presets. Right-clicking a button will store the current envelope as a preset, left clicking will recall a previously stored envelope.
  • 3.0 modulation-move.png - Move the envelope or selected points to the left/right. Will wrap around the edges.
  • 3.0 modulation-flip.png - Flip the envelope or selected points horizontally/vertically.
  • 3.0 modulation-humanize.png - Humanizes the envelope or selected area by randomly adding or subtracting a small amount to the point values.

Automation List

3.2 automation-list.png

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 device name, which will delete the Automation for all of the effect's parameters.

The search field at the 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.


Master Track Extras

In addition to the usual effect parameters, the Master Track allows you to control three additional native Renoise parameters via Automation: the song's Beats Per Minute, Lines Per Beat and Ticks Per Line settings. Unlike other parameters though, these three will only update once per line and points cannot be placed between the lines.

3.2 automation-mastertrack.png