add a script to multi-split regions

1 files changed, 70 insertions, 0 deletions

diff --git a/scripts/split_all_markers.lua b/scripts/split_all_markers.lua
new file mode 100644
index 0000000000..8c4cdb1e66
--- /dev/null
+++ b/scripts/split_all_markers.lua
@@ -0,0 +1,70 @@
+ardour { ["type"] = "EditorAction", name = "Marker Split",
+	license     = "MIT",
+	author      = "Ardour Team",
+	description = [[Split regions on selected tracks at all locations markers]]
+}
+
+function factory (params) return function ()
+
+	local loc = Session:locations () -- all marker locations
+
+	-- http://manual.ardour.org/lua-scripting/class_reference/#ArdourUI:Selection
+	local sel = Editor:get_selection ()
+
+	-- prepare undo operation
+	-- see http://manual.ardour.org/lua-scripting/class_reference/#ARDOUR:Session
+	Session:begin_reversible_command ("Auto Region Split")
+	local add_undo = false -- keep track if something has changed
+
+	-- Track/Bus Selection -- iterate over all Editor-GUI selected tracks
+	-- http://manual.ardour.org/lua-scripting/class_reference/#ArdourUI:TrackSelection
+	for r in sel.tracks:routelist ():iter () do
+		-- each of the items 'r' is-a
+		-- http://manual.ardour.org/lua-scripting/class_reference/#ARDOUR:Route
+
+		local track = r:to_track () -- see if it's a track
+		if track:isnil () then
+			-- if not, skip it
+			goto continue
+		end
+
+		-- get track's playlist
+		-- http://manual.ardour.org/lua-scripting/class_reference/#ARDOUR:Playlist
+		local playlist = track:playlist ()
+
+		-- clear existing changes, prepare "diff" of state for undo
+		playlist:to_stateful ():clear_changes ()
+
+		-- iterate over all location markers
+		for l in loc:list ():iter () do
+			if l:is_mark() then
+				-- get all regions on the given track's playlist (may be stacked)
+				for reg in playlist:regions_at (l:start ()):iter () do
+					playlist:split_region (reg, l:start (), 0)
+					-- the above operation will invalidate the playlist's region list:
+					-- split creates 2 new regions.
+					--
+					-- Hence this script does it the way it does: the inner-most loop
+					-- is over playlist-regions.
+				end
+			end
+		end
+
+		-- collect undo data
+		if not Session:add_stateful_diff_command (playlist:to_statefuldestructible ()):empty () then
+			-- is something has changed, we need to save it at the end.
+			add_undo = true
+		end
+
+		::continue::
+	end
+
+	-- all done, commit the combined Undo Operation
+	if add_undo then
+		-- the 'nil' Command here mean to use the collected diffs added above
+		Session:commit_reversible_command (nil)
+	else
+		Session:abort_reversible_command ()
+	end
+
+end end