--- layout: default title: The Editing Toolbar ---

Mouse Modes

Object Tool
Used for selecting, moving, deleting and copying objects. See below for a full description.
Range Mode
When in range mode, the mouse pointer appears as a vertical line whenever it is over the track canvas or the rulers. The mouse will now be able to select a point or range of time. Time ranges can be selected over one or several tracks, depending on the selection of your tracks.

If none of your track is selected, the Range Tool will operate on all the session track visualized in the Editor.

If you want to operate just some track, select the track you want to edit with the Range Tool.

Zoom Tool
When in zoom mode, the mouse pointer appears as a magnifying glass whenever it is over the track canvas or the rulers. This mode is used to zoom the display to any range that is determined by clicking and dragging the Button1 to specify the range. You can also utilize a single click with Button1 to zoom in by one level focused on the mouse cursor, likewise a single click on Button3 will zoom out by one level focused on the mouse.
Region Gain Tool
When in gain edit mode, the mouse pointer will change to cross-hairs. You can then click within a region to change the gain automation for that region. This automation is separate from fader automation for individual tracks, but works in conjunction with the track's fader. This automation will remain locked to the region's time, so if the region is moved, the region gain automation is moved along with it.
TimeFX Tool
When in timefx mode, the mouse pointer appears as a distinctive 'expanding' illustration whenever it is over the track canvas or the rulers. This mode is used to resize regions using a timestretch algorithm. It is utilized by clicking on an edge of a region of audio and dragging it one way or the other to either stretch or shrink the region.
Audition Tool
Clicking a region using the "audition" tool will audition the region.

You can also "scrub" with this tool by clicking and dragging in the direction you wish to listen. The amount you drag in one direction or the other will determine the playback speed.

Draw Tool
Internal/Region Edit Mode

Object Tool

When in object mode, the mouse pointer appears as a hand whenever it is over the track canvas or the rulers. The mouse can now be used to select and perform operations on objects such as regions, markers etc. This is the most commonly utilized mode in Ardour, as it allows you to select and move regions, as well as modify automation points on the automation tracks.

Selecting Regions
Resizing Regions
Moving Regions
Editing Fade In and Fade Out

Smart Mode

The "Smart Mode" button to the left of the mouse mode buttons modifies "Object Tool" mode. When enabled, the mouse behaves as if it is in "Range Tool" mode in the upper half of a region, and in "Object Tool" mode in the lower half.