Action Scope

The bottom part of the pane (Purple) is for Actions. As with Selection Criteria, each row in the table will have a target and an operation, which might have some parameters.

Actions also have a scope. At the moment, these are:

• Select [$select]

• Add To Selection [$selectadd]

• Inverted Select [$invertselect]

  select anything which didn't match the criteria

• Deselect [$deselect]

which just perform selections (ignoring the Action section), and then:

• Transform [$transform]

  change events in place

• Transform & Replace [$replace]

  change events in place and delete any events in the way of the new ones

• Transform to Track [$copy]

  create a new track, copy the events matching the selection criteria to a new item in that new track, and transform them there

• Transform to Lane [$copylane]

  REAPER 7+, same as Transform to Track, but in a new lane

• Insert [$insert]

  copy events matching the criteria and transform the copy in the original item – useful for harmonization, for instance

• Insert Exclusive [$insertexclusive]

  same, but delete everything which didn't match the selection criteria

• Extract to Track [$extracttrack]

  like Transform to Track, but the matching events in the original item are deleted

• Extract to Lane [$extractlane]

  REAPER 7+, same as extract to Track, but in a new lane

• Delete [$delete]

  delete matching events – no processing

Right-clicking on a row will give you the option to set that row as the default for future new rows. You can also use Cmd/Ctrl+Up/Down-Arrow to rearrange rows.

Post-Processing

The Action Scope has some post-processing options related to selection:

• Do Nothing: do nothing
• Add To Existing Selection: add the transformed events to the current selection
• Exclusive Select: deselect everything, then add the transformed events to the current selection
• Deselect Transformed Events: deselect all transformed events

When chaining exported scripts (see below) using a Custom Action, knowing what's selected at the end will make your life easier.