# Composite editor

The composite editor features 3 different implementations like notation, automation and wave form editing. You switch the implementation by opening the Edit menu and click one of:

- Notation

- Automation

- Wave

Note there are individual tools available depending on active editor implementation within toolbar.

## Notation editor

The notation edit's screenshot showing notes

The notation editor features a piano roll. After linking an editor index with an enginge you may perform tasks like adding notes or copy, cut and paste them. You may change view segmentation, too. Further you might shift the displayed piano on the left or reverse the channel mapping.

### Linking

Before you might perform any task with the editor you have to link engines by adding an index. Then you should link it with an engine. That can all be done by using the menu button of the index list. The corresponding editor appears as you click appropriate link.

### Toolbar

The editor's toolbar screenshot

In the table below are the various buttons explained you may use for editing.

### AGS editor toolbar controls table.

icon | action | description
| cursor | You may want to set the cursor to paste notes at the position where it is located.
| notes | Add notes by clicking within the piano roll and move to till them having the wished duration. You can resize notes using shift key and mouse click and motion.
| delete | Delete notes by clicking on the note you don't want anymore.
| select | Select notes to copy or cut them.
| copy | Copy notes to the clipboard.
| cut | Cut notes to the clipboard.
| paste | Paste the previously copied or cutted notes at the cursor position or just insert them where they are/were located.
| invert | Invert entire notation in conjunction with reverse mapping or MIDI import.

#### Editing tools

The tools menu button contains items that opens dialogs to do common editing tasks. Like move, crop or select notes.

#### Position cursor

The positon notation cursor dialog screenshot

The position notation cursor dialog allows you to position the cursor.

#### AGS position notation cursor dialog controls.

control | description
position x | Set the cursor at position x.
position y | Set the cursor at position y.

#### Move notes

The move note dialog screenshot

The move notes dialog allows you to move selected notes to a given position.

#### AGS move note dialog controls.

control | description
relative | Radio button to choose relative positioning. The x- and y-offset are going to be added to current selections insets.
absolute | Radio button to choose absolute positioning. The x- and y-offset are goint to be added to most upper-left position x = 0 and y = 0.
x | The x-offset to position the selected notes.
y | The y-offset to position the selected notes.

#### Crop notes

The crop note dialog screenshot

The crop notes dialog allows you to crop selected notes to a specified width or insert desired padding. Per default the values are added or subtracted of each note and doesn't require any additional space.

#### AGS crop note dialog controls.

control | description
absolute | Modify behavior of crop, if checked it does use crop note control as absolute value, rather than add/subtract the value of current insets.
in-place | Radio button to specify that all crop happens in-place i.e. no additional space is used.
do resize | Radio button to specify that all crop adds some extra space i.e. the padding is increased as well.
crop note | Set the crop note value to resize the selected notes. This may be a relative or absolute value.
padding | Set the padding per tic to use.

#### Select notes

The select note dialog screenshot

The select note dialog allows you to select notes of given position and region.

#### AGS select note dialog controls.

control | description
copy selection | Check button to say if you would like to copy selection to clipboard.
select x0 | Set the x0 offset of region to select.
select y0 | Set the y0 offset of region to select.
select x1 | Set the x1 offset of region to select.
select y1 | Set the y1 offset of region to select.

### Pattern edit

The pattern edit widget is available as linking an editor index with a pattern sequencer e.g. drum or matrix.

- Left, Left-Arrow

  - Move within notation left, as there is a pattern you get an audible feedback.

- Right, Right-Arrow

  - Move within notation right, audible feedback as above.

- Up, Up-Arrow

  - Move within notation up, audible feedback as above.

- Down, Down-Arrow

  - Move within notation down, audible feedback as above.

- Space

  - Add audio pattern and give audible feedback.

- Delete

  - Remove audio pattern and give audible feedback.

- Ctrl+c

  - Copy the selected pattern to clipboard.

- Ctrl+x

  - Cut the selected pattern to clipboard.

- Ctrl+v

  - Paste pattern from clipboard.

- Ctrl+a

  - Select all.

- Ctrl+i

  - Invert all.

- Ctrl+m

  - Show/hide meta information.

- Tab

  - Leave notation focus.

### Note edit

The note edit widget is available as linking an editor index with a notes sequencer e.g. Soundfont2 file player.

- Left, Left-Arrow

  - Move within notation left, as there is a note you get an audible feedback.

- Shift and Left, Left-Arrow

  - Shrink note by zoom factor.

- Right, Right-Arrow

  - Move within notation right, audible feedback as above.

- Shift and Right, Right-Arrow

  - Grow note by zoom factor.

- Up, Up-Arrow

  - Move within notation up, audible feedback as above.

- Down, Down-Arrow

  - Move within notation down, audible feedback as above.

- Space

  - Add audio notes and give audible feedback.

- Delete

  - Remove audio notes and give audible feedback.

- Ctrl+c

  - Copy the selected notes to clipboard.

- Ctrl+x

  - Cut the selected notes to clipboard.

- Ctrl+v

  - Paste notes from clipboard.

- Ctrl+a

  - Select all.

- Ctrl+i

  - Invert all.

- Ctrl+m

  - Show/hide meta information.

- Tab

  - Leave notation focus.

## Automation editor

The automation editor's screenshot showing ramped values

The automation editor features a timeline value map. After linking an editor index with an enginge you may perform tasks like adding values or copy, cut and paste them. You may change view segmentation, too.

### Linking

Before you might perform any task with the editor you have to link engines by adding an index. Then you should link it with an engine. That can all be done by using the menu button of the index list. The corresponding editor appears as you click appropriate link, if automation editor is not the default view you have to change it by clicking Edit -> Automation from your menu bar or context menu.

### Toolbar

The editor's toolbar screenshot

In the table below are the various buttons explained you may use for editing.

### AGS automation editor toolbar controls table.

icon | action | description
| cursor | You may want to set the cursor to paste accelerations at the position where it is located.
| accelerations | Add accelerations by clicking within the automation area. You can modify acceleration using shift key and mouse click and motion.
| delete | Delete accelerations by clicking on the acceleration you don't want anymore.
| select | Select accelerations to copy or cut them.
| copy | Copy accelerations to the clipboard.
| cut | Cut accelerations to the clipboard.
| paste | Paste the previously copied or cutted accelerations at the cursor position or just insert them where they are/were located.

#### Editing tools

The tools menu button contains items that opens dialogs to do common editing tasks. Like move, crop or select accelerations.

#### Position cursor

The positon automation cursor dialog screenshot

The position automation cursor dialog allows you to position the cursor.

#### AGS position automation cursor dialog controls.

control | description
position x | Set the cursor at position x.

#### Select accelerations

The select acceleration dialog screenshot

The select acceleration dialog allows you to select accelerations of given position and selected controls.

#### AGS select acceleration dialog controls.

control | description
copy selection | Check button to say if you would like to copy selection to clipboard.
add/remove | Add/remove controls to enable/disable for selecting automation area.
select x0 | Set the x0 offset of region to select.
select x1 | Set the x1 offset of region to select.

#### Ramp accelerations

The ramp acceleration dialog screenshot

The ramp acceleration dialog allows you to ramp accelerations to a specified value using given number of steps.

#### AGS ramp acceleration dialog controls.

control | description
ramp control | Select the control to ramp.
ramp x0 | The x0-offset to start ramp from.
ramp y0 | The y0-value to use as first value.
ramp x1 | The x1-offset to stop ramp to.
ramp y1 | The y1-value to use as last value.
step count | The number of steps to use to ramp value y0 to y1 from offset x0 to x1.

### Automation edit

The automation edit widget is available as linking an editor index with any machine.

There are basic edit tools available to do your automation. You can use keyboard bindings to do your tasks are select appropriate edit tool of toolbar. As the appropriate port is checked it enables the automation of it. Else it is by-passed and won't see any automation data. By enabling a port it gets visible within the editor.

- Position cursor. Use arrow keys. Page-Up and Page-Down switches the automation area.

- Add automation point applied horizontally by time and vertically as value. Add by enter space.

- Delete automation point. Use delete key.

- Select automation. Alternatively do select all, note selects everything visible within scope tab.

- Copy automation. Control-c key-stroke.

- Cut automation. Control-x key-stroke.

- Paste automation. Control-v key-stroke.

- Show/hide meta information. Control-m key-stroke.

## Wave editor

The wave edit's screenshot showing audio data

The wave edit widget is available as linking an editor index with AgsAudiorec.

The wave editor features a wave form area. After linking an editor index with an enginge you may perform tasks like copy, cut and paste audio data. You may change view segmentation, too.

### Linking

Before you might perform any task with the editor you have to link engines by adding an index. Then you should link it with an engine. That can all be done by using the menu button of the index list. The corresponding editor appears as you click appropriate link, if wave editor is not the default view you have to change it by clicking Edit -> Wave from your menu bar or context menu.

### Wave toolbar

The wave editor's toolbar screenshot

In the table below are the various buttons explained you may use for editing.

### AGS wave editor toolbar controls table.

icon | action | description
| cursor | You may want to set the cursor to paste buffers at the position where it is located.
| select | Select buffers to copy or cut them.
| copy | Copy buffers to the clipboard.
| cut | Cut buffers to the clipboard.
| paste | Paste the previously copied or cutted buffers at the cursor position or just insert them where they are/were located.

#### Editing tools

The tools menu button contains items that opens dialogs to do common editing tasks. Like move, crop or select buffers.

#### Position cursor

The position wave cursor dialog screenshot

The position wave cursor dialog allows you to position the cursor.

#### AGS position wave cursor dialog controls.

control | description
position x | Set the cursor at position x.

#### Select buffers

The select buffer dialog screenshot

The select buffer dialog allows you to select buffers of given position.

#### AGS select buffer dialog controls.

control | description
copy selection | Check button to say if you would like to copy selection to clipboard.
select x0 | Set the x0 offset of region to select.
select x1 | Set the x1 offset of region to select.

#### Time-stretch buffers

The time-stretch buffer dialog screenshot

The time-stretch buffer dialog allows you to stretch time of buffers at given frequency.

#### AGS time-stretch buffer dialog controls.

control | description
frequency | The time-stretch center frequency.
orig BPM | The original BPM the audio data was recorded.
new BPM | The new BPM the audio data shall have.

### Wave edit

The wave edit widget is available as linking an editor index with AgsAudiorec.

There are basic edit tools available to do modify wave form. You can use keyboard bindings to do your tasks are select appropriate edit tool of toolbar. The wave editor shows all audio channels in vertical alignment and are grouped by default.

- Position cursor. Use arrow keys. Page-Up and Page-Down switches the wave area.

- Select wave. Alternatively do select all, note selects everything visible within scope tab.

- Copy wave. Control-C key-stroke.

- Cut wave. Control-X key-stroke.

- Paste wave. Control-V key-stroke.