mcp_opendaw_clear_region_notes
Clear all notes from a region on the timeline while preserving the region itself. Erase existing notes to rewrite a region's content without deleting the region container.
Instructions
Clear all notes from a region while keeping the region on the timeline.
Removes every note event from the specified region(s) but preserves the region itself — its position, duration, and track placement stay intact. This is the "erase and rewrite" operation: the producer wants to clear a region to start fresh, without deleting and recreating the region container.
Different from delete_note_region (which removes the entire region from the timeline) and delete_note (which removes one note at a time).
unit_index: AU index. track_index: Note track index. region_index: Region index (-1 = all note regions on the track).
Returns notes cleared and remaining region info.
Examples: clear_region_notes(unit_index=0, track_index=0, region_index=0) -> Erase all notes in region 0, region stays on timeline clear_region_notes(unit_index=0, track_index=0, region_index=-1) -> Erase all notes in ALL regions on track 0
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| unit_index | Yes | ||
| track_index | Yes | ||
| region_index | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |