ardour/scripts/_route_template_example.lua

ardour {
	["type"]    = "EditorAction",
	name        = "Generic Audio Track",
	description = [[Example ]]
}

-- If a route_setup function is present in an Editor Action Script
-- the script is also listed in the "add track/bus" dialog as meta-template
--
-- The function is expected to return a Lua table. The table may be empty.
function route_setup ()
	local e = Session:engine()
	local _, t = e:get_backend_ports ("", ARDOUR.DataType("audio"), ARDOUR.PortFlags.IsOutput | ARDOUR.PortFlags.IsPhysical, C.StringVector())
	return
	{
		-- keys control which AddRouteDialog controls are made sensitive.
		-- The following keys accept a default value to pre-seed the dialog
		['how_many'] = t[4]:size(),
		['name'] = 'Audio',
		['channels'] = 2,
		-- these keys just need to be set (to something other than nil)
		['insert_at'] = ARDOUR.PresentationInfo.max_order,
		['group'] = false,
		['track_mode'] = ARDOUR.TrackMode.Normal,
		['strict_io'] = true,
	}
end

-- The Script can be used as EditorAction in which case it can
-- optionally provide instantiation parmaters
function action_params ()
	return
	{
		['how_many'] = { title = "How Many tracks to add", default = "1" },
		["name"]     = { title = "Track Name Prefix", default = "Audio" },
	}
end


function factory (params) return function ()
	local p         = params or route_setup ()
	local name      = p["name"] or 'Audio'
	local how_many  = p["how_many"] or 1
	local channels  = p["channels"] or 1
	local insert_at = p["insert_at"] or ARDOUR.PresentationInfo.max_order;
	local group     = p["group"] or nil
	local mode      = p["track_mode"] or ARDOUR.TrackMode.Normal
	local strict_io = p["strict_io"] or false

	local tl = Session:new_audio_track (channels, channels, group, how_many, name, insert_at, mode)

	if strict_io then
		for t in tl:iter() do
			t:set_strict_io (true)
		end
	end

end end