ardour/share/scripts/_osc_hook_example.lua

ardour {
	["type"]    = "EditorHook",
	name        = "OSC Callback Example",
	author      = "Ardour Team",
	description = "Send OSC messages",
}

function action_params ()
	return
	{
		["uri"] = { title = "OSC URI ", default = "osc.udp://localhost:7890"},
	}
end


function signals ()
	s = LuaSignal.Set()
	s:add (
		{
			[LuaSignal.SoloActive] = true,
			[LuaSignal.RegionsPropertyChanged] = true,
			[LuaSignal.Exported] = true,
			[LuaSignal.TransportStateChange] = true
		}
	)
	return s
end

function factory (params)
	return function (signal, ref, ...)
		local uri = params["uri"] or "osc.udp://localhost:7890"
		local tx = ARDOUR.LuaOSC.Address (uri)
		-- debug print (stdout)
		-- print (signal, ref, ...)

		if (signal == LuaSignal.Exported) then
			tx:send ("/session/exported", "ss", ...)
		elseif (signal == LuaSignal.SoloActive) then
			tx:send ("/session/solo_changed", "")
		elseif (signal == LuaSignal.TransportStateChange) then
			tx:send ("/session/transport", "if",
				Session:transport_sample(), Session:transport_speed())
		elseif (signal == LuaSignal.RegionsPropertyChanged) then
			rl,pch = ...
			for region in rl:iter() do
				tx:send ("/region_property_changed", "sTTiii",
					region:name (),
					(pch:containsTimePos (ARDOUR.Properties.Start)),
					(pch:containsTimeCnt (ARDOUR.Properties.Length)),
					region:position ():samples(), region:start ():samples(), region:length ():samples())
			end
		end
	end
end