X-Git-Url: http://shamusworld.gotdns.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=include%2Fclass-reference.html;h=becc5a807f3eb7952456f3e3b548b5a37a702602;hb=53168d99209b770d9894692b820f06393a63abb5;hp=75ff7d856f552f6f0dc08a0ac3f72de3f38d2f5d;hpb=94085e0ed8465b25f39c69f35c55544a9f3286d8;p=ardour-manual diff --git a/include/class-reference.html b/include/class-reference.html index 75ff7d8..becc5a8 100644 --- a/include/class-reference.html +++ b/include/class-reference.html @@ -165,6 +165,7 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C DiskReaderto_diskreader () DiskWriterto_diskwriter () PluginInsertto_insert () + InternalSendto_internalsend () IOProcessorto_ioprocessor () Latentto_latent () PeakMeterto_meter () @@ -212,6 +213,8 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C
o
Port name

Returns true if this port is connected to o, otherwise false.

intdisconnect (std::string) intdisconnect_all () + PortFlagsflags () +

Returns flags

LuaTable(...)get_connected_latency_range (LatencyRange&, bool) std::stringname ()

Returns Port short name

@@ -305,8 +308,11 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C Methods BackendVectoravailable_backends () std::stringcurrent_backend_name () + boolfreewheeling () floatget_dsp_load () std::stringget_last_backend_error () + longprocessed_samples () + boolrunning () AudioBackendset_backend (std::string, std::string, std::string) intset_buffer_size (unsigned int) intset_device_name (std::string) @@ -335,6 +341,7 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C boolphysically_connected (std::string) PortEngineport_engine () boolport_is_physical (std::string) + voidreset_input_meters ()

 ARDOUR:AudioPlaylist

C‡: boost::shared_ptr< ARDOUR::AudioPlaylist >, boost::weak_ptr< ARDOUR::AudioPlaylist >

@@ -380,6 +387,7 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C RegionListPtrregions_with_end_within (Range) RegionListPtrregions_with_start_within (Range) voidremove_region (Region) + boolset_name (std::string) boolshared () voidsplit_region (Region, MusicSample) Regiontop_region_at (long) @@ -416,6 +424,8 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C
o
Port name

Returns true if this port is connected to o, otherwise false.

intdisconnect (std::string) intdisconnect_all () + PortFlagsflags () +

Returns flags

LuaTable(...)get_connected_latency_range (LatencyRange&, bool) std::stringname ()

Returns Port short name

@@ -433,6 +443,22 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C AudioPortto_audioport () MidiPortto_midiport () +

 ARDOUR:AudioPortMeters

+

C‡: std::map<std::string, ARDOUR::PortManager::DPM >

+
+ + + + + + + + + + + + +
Constructor
ARDOUR.AudioPortMeters ()
Methods
LuaTableadd (std::string, ARDOUR::PortManager::DPM )
...at (--lua--)
voidclear ()
unsigned longcount (std::string)
boolempty ()
LuaIteriter ()
unsigned longsize ()
LuaTabletable ()

 ARDOUR:AudioRange

C‡: ARDOUR::AudioRange

@@ -443,7 +469,7 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C boolequal (AudioRange) longlength () Data Members - longend + long_end unsigned intid longstart @@ -470,6 +496,8 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C + + @@ -479,6 +507,7 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C + @@ -494,6 +523,7 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C + @@ -610,6 +640,7 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C + @@ -642,9 +673,9 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C

Inherited from ARDOUR:Track

Methods
AudioSourceaudio_source (unsigned int)
AutomationListenvelope ()
boolenvelope_active ()
boolfade_in_active ()
boolfade_out_active ()
boolisnil ()

Returns the maximum (rms) signal power of the region, or a -1 if the Progress object reports that the process was cancelled.

floatscale_amplitude ()
LuaTable(int, ...)separate_by_channel (RegionVector&)
voidset_envelope_active (bool)
voidset_fade_in_active (bool)
voidset_fade_in_length (long)
voidset_fade_in_shape (FadeShape)
boolautomatic ()
boolcan_move ()
boolcaptured ()
voidcaptured_xruns (XrunPositions&, bool)
voidclear_sync_position ()
Controlcontrol (Parameter, bool)
boolcovers (long)
Methods
std::stringancestor_name ()
boolcan_be_analysed ()
XrunPositionscaptured_xruns ()
boolhas_been_analysed ()
longnatural_position ()
longtimeline_position ()
- + - + @@ -654,7 +685,7 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C - + @@ -663,6 +694,9 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C
Methods
Regionbounce (InterThreadInfo&)
Regionbounce (InterThreadInfo&, std::string)

bounce track from session start to session end to new region

itt
asynchronous progress report and cancel

Returns a new audio region (or nil in case of error)

Regionbounce_range (long, long, InterThreadInfo&, Processor, bool)
Regionbounce_range (long, long, InterThreadInfo&, Processor, bool, std::string)

Bounce the given range to a new audio region.

start
start time (in samples)
end
end time (in samples)
itt
asynchronous progress report and cancel
endpoint
the processor to tap the signal off (or nil for the top)
include_endpoint
include the given processor in the bounced audio.

Returns a new audio region (or nil in case of error)

boolbounceable (Processor, bool)

Test if the track can be bounced with the given settings. If sends/inserts/returns are present in the signal path or the given track has no audio outputs bouncing is not possible.

endpoint
the processor to tap the signal off (or nil for the top)
include_endpoint
include the given processor in the bounced audio.

Returns true if the track can be bounced, or false otherwise.

boolset_name (std::string)
intuse_copy_playlist ()
intuse_new_playlist (DataType)
intuse_playlist (DataType, Playlist)
intuse_playlist (DataType, Playlist, bool)
Cast
AudioTrackto_audio_track ()
MidiTrackto_midi_track ()
+ + + @@ -674,6 +708,8 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C + + @@ -696,7 +732,7 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C - + @@ -797,6 +833,8 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C
Methods
boolactive ()
intadd_aux_send (Route, Processor)

Add an aux send to a route.

route
route to send to.
before
Processor to insert before, or 0 to insert at the end.
intadd_foldback_send (Route, bool)
intadd_processor_by_index (Processor, int, ProcessorStreams, bool)

Add a processor to a route such that it ends up with a given index into the visible processors.

index
Index to add the processor at, or -1 to add at the end of the list.

Returns 0 on success, non-0 on failure.

booladd_sidechain (Processor)
IOinput ()
Deliverymain_outs ()

the signal processorat at end of the processing chain which produces output

MonitorControlmonitoring_control ()
MonitorStatemonitoring_state ()
boolmuted ()
ChanCountn_inputs ()
ChanCountn_outputs ()

reset plugin-insert configuration to default, disable customizations.

This is equivalent to calling

 customize_plugin_insert (proc, 0, unused)
proc
Processor to reset

Returns true if successful

voidset_active (bool, void*)
voidset_comment (std::string, void*)
voidset_meter_point (MeterPoint, bool)
voidset_meter_point (MeterPoint)
boolset_strict_io (bool)
longsignal_latency ()
boolsoloed ()
+ + @@ -815,6 +853,8 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C

Inherited from ARDOUR:Automatable

Methods
ParameterListall_automatable_params ()

API for Lua binding

AutomationControlautomation_control (Parameter, bool)
boolisnil ()
Cast
+ + @@ -881,27 +921,33 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C
Methods
ParameterListall_automatable_params ()

API for Lua binding

AutomationControlautomation_control (Parameter, bool)
Cast
Slavableto_slavable ()
- + - + + - + + + - + - + + - + - + + +
Methods
voidadd (double, double, bool, bool)

add automation events

when
absolute time in samples
value
parameter value
with_guards
if true, add guard-points
with_initial
if true, add an initial point if the list is empty

Add an event to this list.

This method is intended to write automation in realtime. If the transport is stopped, guard-points will be added regardless of parameter with_guards.

when
absolute time in samples
value
parameter value
with_guards
if true, add guard-points
with_initial
if true, add an initial point if the list is empty
voidclear (double, double)

remove all automation events between the given time range

start
start of range (inclusive) in audio samples
end
end of range (inclusive) in audio samples

Remove all events in the given time range from this list.

start
start of range (inclusive) in audio samples
end
end of range (inclusive) in audio samples
voidclear_list ()
booleditor_add (double, double, bool)

Add an event to this list.

This method is intended for making manual changes from the GUI. An event will only be created if no other event exists at the given time.

when
absolute time in samples
value
parameter value
with_guards
if true, add guard-points

Returns true if an event was added.

doubleeval (double)

query value at given time (takes a read-lock, not safe while writing automation)

where
absolute time in samples

Returns parameter value

Queries the event value at the given time (takes a read-lock, not safe while writing automation).

where
absolute time in samples

Returns parameter value

EventListevents ()

Returns the list of events

boolin_write_pass ()

Returns true if transport is running and this list is in write mode

InterpolationStyleinterpolation ()

query interpolation style of the automation data

Returns Interpolation Style

LuaTable(double, ...)rt_safe_eval (double, bool&)

realtime safe version of eval, may fail if read-lock cannot be taken

where
absolute time in samples
ok
boolean reference if returned value is valid

Returns parameter value

Realtime safe version of eval(). This may fail if a read-lock cannot be taken.

where
absolute time in samples
ok
boolean reference if returned value is valid

Returns parameter value

boolset_interpolation (InterpolationStyle)

set the interpolation style of the automation data.

This will fail when asking for Logarithmic scale and min,max crosses 0 or Exponential scale with min != 0.

is
interpolation style

Returns true if style change was successful

Sets the interpolation style of the automation data.

This will fail when asking for Logarithmic scale and min,max crosses 0 or Exponential scale with min != 0.

is
interpolation style

Returns true if style change was successful

unsigned longsize ()
voidthin (double)

Thin the number of events in this list.

The thinning factor corresponds to the area of a triangle computed between three points in the list (time-difference * value-difference). If the area is large, it indicates significant non-linearity between the points.

Time is measured in samples, value is usually normalized to 0..1.

During automation recording we thin the recorded points using this value. If a point is sufficiently co-linear with its neighbours (as defined by the area of the triangle formed by three of them), we will not include it in the list. The larger the value, the more points are excluded, so this effectively measures the amount of thinning to be done.

thinning_factor
area-size (default: 20)
voidtruncate_end (double)

truncate the event list after the given time

last_coordinate
last event to include

Remove all events after the given time from this list.

last_coordinate
time in audio samples of the last event to keep
voidtruncate_start (double)

truncate the event list to the given time

overall_length
overall length

Remove all events up to to the given time from this list.

overall_length
overall length in audio samples
Cast
AutomationListto_automationlist ()

 ARDOUR:BackendVector

C‡: std::vector<ARDOUR::AudioBackendInfo const* >

@@ -940,6 +986,40 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C AudioBufferget_audio (unsigned long) MidiBufferget_midi (unsigned long) +

 ARDOUR:Bundle

+

C‡: boost::shared_ptr< ARDOUR::Bundle >, boost::weak_ptr< ARDOUR::Bundle >

+
+

A set of `channels', each of which is associated with 0 or more ports. Each channel has a name which can be anything useful, and a data type. Intended for grouping things like, for example, a buss' outputs. `Channel' is a rather overloaded term but I can't think of a better one right now.

+ + + + + + + + + + + + + + +
Methods
std::stringchannel_name (unsigned int)
ch
Channel.

Returns Channel name.

boolisnil ()
unsigned intn_total ()
std::stringname ()

Returns Bundle name

ChanCountnchannels ()

Returns Number of channels that this Bundle has

boolports_are_inputs ()
boolports_are_outputs ()
Cast
UserBundleto_userbundle ()
+

 ARDOUR:BundleListPtr

+

C‡: boost::shared_ptr<std::vector<boost::shared_ptr<ARDOUR::Bundle> > >

+
+ + + + + + + + + + + +
Constructor
ARDOUR.BundleListPtr ()
Methods
LuaTableadd (LuaTable {Bundle})
Bundleat (unsigned long)
boolempty ()
LuaIteriter ()
voidpush_back (Bundle)
unsigned longsize ()
LuaTabletable ()

 ARDOUR:ChanCount

C‡: ARDOUR::ChanCount

@@ -1051,7 +1131,7 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C

Instantiate Biquad Filter

samplerate
Samplerate
Methods voidcompute (Type, double, double, double) -

setup filter, compute coefficients

type
filter type (LowPass, HighPass, etc)
freq
filter frequency
Q
filter quality
gain
filter gain
+

setup filter, compute coefficients

t
filter type (LowPass, HighPass, etc)
freq
filter frequency
Q
filter quality
gain
filter gain
voidconfigure (double, double, double, double, double)

setup filter, set coefficients directly

floatdB_at_freq (float) @@ -1084,8 +1164,10 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C Constructor ℂARDOUR.DSP.Convolver (Session&, std::string, IRChannelConfig, IRSettings) Methods - voidrun_mono (FloatArray, unsigned int) - voidrun_stereo (FloatArray, FloatArray, unsigned int) + voidrun_mono_buffered (FloatArray, unsigned int) + voidrun_mono_no_latency (FloatArray, unsigned int) + voidrun_stereo_buffered (FloatArray, FloatArray, unsigned int) + voidrun_stereo_no_latency (FloatArray, FloatArray, unsigned int)

Inherited from ARDOUR:DSP:Convolution

@@ -1132,7 +1214,7 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C - +

process current data in buffer

floatfreq_at_bin (unsigned int)
floatpower_at_bin (unsigned int, float)

query

b
the frequency bin 0 .. window_size / 2
norm
gain factor (set equal to bin for 1/f normalization)

Returns signal power at given bin (in dBFS)

query

bin
the frequency bin 0 .. window_size / 2
norm
gain factor (set equal to bin for 1/f normalization)

Returns signal power at given bin (in dBFS)

voidset_data_hann (FloatArray, unsigned int, unsigned int)

 ARDOUR:DSP:Generator

@@ -1238,6 +1320,7 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C DiskReaderto_diskreader () DiskWriterto_diskwriter () PluginInsertto_insert () + InternalSendto_internalsend () IOProcessorto_ioprocessor () Latentto_latent () PeakMeterto_meter () @@ -1298,6 +1381,7 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C DiskReaderto_diskreader () DiskWriterto_diskwriter () PluginInsertto_insert () + InternalSendto_internalsend () IOProcessorto_ioprocessor () Latentto_latent () PeakMeterto_meter () @@ -1376,6 +1460,7 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C DiskReaderto_diskreader () DiskWriterto_diskwriter () PluginInsertto_insert () + InternalSendto_internalsend () IOProcessorto_ioprocessor () Latentto_latent () PeakMeterto_meter () @@ -1427,6 +1512,7 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C DiskReaderto_diskreader () DiskWriterto_diskwriter () PluginInsertto_insert () + InternalSendto_internalsend () IOProcessorto_ioprocessor () Latentto_latent () PeakMeterto_meter () @@ -1478,6 +1564,7 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C DiskReaderto_diskreader () DiskWriterto_diskwriter () PluginInsertto_insert () + InternalSendto_internalsend () IOProcessorto_ioprocessor () Latentto_latent () PeakMeterto_meter () @@ -1545,6 +1632,7 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C Methods std::stringancestor_name () boolcan_be_analysed () + XrunPositionscaptured_xruns () boolempty () boolhas_been_analysed () longlength (long) @@ -1707,6 +1795,7 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C DiskReaderto_diskreader () DiskWriterto_diskwriter () PluginInsertto_insert () + InternalSendto_internalsend () IOProcessorto_ioprocessor () Latentto_latent () PeakMeterto_meter () @@ -1740,7 +1829,7 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C

C‡: boost::shared_ptr< ARDOUR::InternalReturn >, boost::weak_ptr< ARDOUR::InternalReturn >

is-a: ARDOUR:Return

-

A mixer strip element (Processor) with 1 or 2 IO elements.

+

A mixer strip element - plugin, send, meter, etc

@@ -1776,6 +1865,7 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C + @@ -1802,13 +1892,25 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C

A mixer strip element (Processor) with 1 or 2 IO elements.

Methods
boolisnil ()
DiskReaderto_diskreader ()
DiskWriterto_diskwriter ()
PluginInsertto_insert ()
InternalSendto_internalsend ()
IOProcessorto_ioprocessor ()
Latentto_latent ()
PeakMeterto_meter ()
+ + + + + + +
Methods
boolallow_feedback ()
std::stringdisplay_name ()
boolfeeds (Route)
boolisnil ()
voidset_allow_feedback (bool)
boolset_name (std::string)
Routesource_route ()
Routetarget_route ()

Inherited from ARDOUR:Send

+ + + + +
Methods
GainControlgain_control ()
longget_delay_in ()
longget_delay_out ()
boolis_foldback ()
voidset_remove_on_disconnect (bool)
Cast
InternalSendto_internalsend ()

Inherited from ARDOUR:Delivery

@@ -1830,7 +1932,6 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C - @@ -1846,6 +1947,7 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C + @@ -1893,7 +1995,7 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C

Location on Timeline - abstract representation for Markers, Loop/Punch Ranges, CD-Markers etc.

boolactive ()
longcapture_offset ()
voiddeactivate ()
std::stringdisplay_name ()
booldisplay_to_user ()
longinput_latency ()
ChanCountinput_streams ()
DiskReaderto_diskreader ()
DiskWriterto_diskwriter ()
PluginInsertto_insert ()
InternalSendto_internalsend ()
IOProcessorto_ioprocessor ()
Latentto_latent ()
PeakMeterto_meter ()
- + @@ -1949,6 +2051,8 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C

A collection of session locations including unique dedicated locations (loop, punch, etc)

Methods
longend ()
long_end ()
Flagsflags ()
boolis_auto_loop ()
boolis_auto_punch ()
+ + @@ -1959,6 +2063,8 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C + +
Methods
Locationadd_range (long, long)

Add new range to the collection

start
start position
end
end position

Returns New location object

Locationauto_loop_location ()
Locationauto_punch_location ()
LuaTable(...)find_all_between (long, long, LocationList&, Flags)
Locationmark_at (long, long)
LuaTable(...)marks_either_side (long, long&, long&)

Look for the `marks' (either locations which are marks, or start/end points of range markers) either side of a sample. Note that if sample is exactly on a `mark', that mark will not be considered for returning as before/after.

sample
Frame to look for.
before
Filled in with the position of the last `mark' before `sample' (or max_samplepos if none exists)
after
Filled in with the position of the next `mark' after `sample' (or max_samplepos if none exists)
Locationrange_starts_at (long, long, bool)

Return range with closest start pos to the where argument

pos
point to compare with start pos
slop
area around point to search for start pos
incl
(optional) look only for ranges that includes 'where' point

Returns Location object or nil

voidremove (Location)
Locationsession_range_location ()
@@ -1980,6 +2086,9 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C ...color_to_rgba (--lua--)

A convenience function to expand RGBA parameters from an integer

convert a Canvas::Color (uint32_t 0xRRGGBBAA) into double RGBA values which can be passed as parameters to Cairo::Context::set_source_rgba

Example:

 local r, g, b, a = ARDOUR.LuaAPI.color_to_rgba (0x88aa44ff)
  cairo_ctx:set_source_rgba (ARDOUR.LuaAPI.color_to_rgba (0x11336699)

Returns 4 parameters: red, green, blue, alpha (in range 0..1)

+ ...desc_scale_points (--lua--) + std::stringdump_untagged_plugins () +

Write a list of untagged plugins to a file, so we can bulk-tag them

Returns path to XML file or empty string on error

std::stringfile_get_contents (std::string) boolfile_test (std::string, FileTest) LuaTable(float, ...)get_plugin_insert_param (PluginInsert, unsigned int, bool&) @@ -1992,14 +2101,17 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C

List all installed plugins

longmonotonic_time () Processornew_luaproc (Session, std::string) -

create a new Lua Processor (Plugin)

s
Session Handle
p
Identifier or Name of the Processor

Returns Processor object (may be nil)

+

create a new Lua Processor (Plugin)

s
Session Handle
name
Identifier or Name of the Processor

Returns Processor object (may be nil)

NotePtrnew_noteptr (unsigned char, Beats, Beats, unsigned char, unsigned char) - Processornew_plugin (Session, std::string, PluginType, std::string) -

create a new Plugin Instance

s
Session Handle
id
Plugin Name, ID or URI
type
Plugin Type
preset
name of plugin-preset to load, leave empty "" to not load any preset after instantiation

Returns Processor or nil

- PluginInfonew_plugin_info (std::string, PluginType) -

search a Plugin

id
Plugin Name, ID or URI
type
Plugin Type

Returns PluginInfo or nil if not found

+ Processornew_plugin (Session, std::string, PluginType, std::string) +

create a new Plugin Instance

s
Session Handle
name
Plugin Name, ID or URI
type
Plugin Type
preset
name of plugin-preset to load, leave empty "" to not load any preset after instantiation

Returns Processor or nil

+ PluginInfonew_plugin_info (std::string, PluginType) +

search a Plugin

name
Plugin Name, ID or URI
type
Plugin Type

Returns PluginInfo or nil if not found

+ Processornew_send (Session, Route, Processor) +

add a new [external] Send to the given Route

s
Session Handle
r
Route to add Send to
p
add send before given processor (or nil_processor to add at the end)
Processornil_proc () NotePtrListnote_list (MidiModel) + std::stringpath_get_basename (std::string) ...plugin_automation (--lua--)

A convenience function to get a Automation Lists and ParamaterDescriptor for a given plugin control.

This is equivalent to the following lua code

 function (processor, param_id)
   local plugininsert = processor:to_insert ()
@@ -2014,6 +2126,8 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C
 

reset a processor to its default values (only works for plugins )

This is a wrapper which looks up the Processor by plugin-insert.

proc
Plugin-Insert

Returns true on success, false when the processor is not a plugin

...sample_to_timecode (--lua--)

Generic conversion from audio sample count to timecode. (TimecodeType, sample-rate, sample-pos)

+ voidsegfault () +

Crash Test Dummy

boolset_plugin_insert_param (PluginInsert, unsigned int, float)

set a plugin control-input parameter value

This is a wrapper around set_processor_param which looks up the Processor by plugin-insert.

pi
Plugin-Insert
which
control-input to set (starting at 0)
value
value to set

Returns true on success, false on error or out-of-bounds value

boolset_processor_param (Processor, unsigned int, float) @@ -2021,6 +2135,8 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C ...timecode_to_sample (--lua--)

Generic conversion from timecode to audio sample count. (TimecodeType, sample-rate, hh, mm, ss, ff)

voidusleep (unsigned long) + boolwait_for_process_callback (unsigned long, long) +

Delay execution until next prcess cycle starts.

n_cycles
process-cycles to wait for. 0: means wait until next cycle-start, otherwise skip given number of cycles.
timeout_ms
wait at most this many milliseconds

Returns true on success, false if timeout was reached or engine was not running

 ARDOUR:LuaAPI:Rubberband

C‡: ARDOUR::LuaAPI::Rubberband

@@ -2089,6 +2205,8 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C LuaTable(int, ...)get_parameter_descriptor (unsigned int, ParameterDescriptor&) std::stringget_parameter_docs (unsigned int) char*label () + PresetRecordlast_preset () +

Returns Last preset to be requested; the settings may have been changed since; find out with parameter_changed_since_last_preset.

boolload_preset (PresetRecord)

Set parameters using a preset

char*maker () @@ -2122,6 +2240,22 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C ...get (--lua--) ...set (--lua--) +

 ARDOUR:MIDIPortMeters

+

C‡: std::map<std::string, ARDOUR::PortManager::MPM >

+
+ + + + + + + + + + + + +
Constructor
ARDOUR.MIDIPortMeters ()
Methods
LuaTableadd (std::string, ARDOUR::PortManager::MPM )
...at (--lua--)
voidclear ()
unsigned longcount (std::string)
boolempty ()
LuaIteriter ()
unsigned longsize ()
LuaTabletable ()

 ARDOUR:Meter

C‡: ARDOUR::Meter

@@ -2183,7 +2317,7 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C Methods voidcopy (MidiBuffer) boolempty () - boolpush_back (long, unsigned long, unsigned char*) + boolpush_back (long, EventType, unsigned long, unsigned char*) boolpush_event (Event) voidresize (unsigned long)

Reallocate the buffer used internally to handle at least size_t units of data.

The buffer is not silent after this operation. the capacity argument passed to the constructor must have been non-zero.

@@ -2212,6 +2346,8 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C

Inherited from ARDOUR:Automatable

+ + @@ -2303,6 +2439,7 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C + @@ -2344,6 +2481,8 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C + + @@ -2383,6 +2522,7 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C + @@ -2473,6 +2613,7 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C + @@ -2501,13 +2642,14 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C
Methods
ParameterListall_automatable_params ()

API for Lua binding

AutomationControlautomation_control (Parameter, bool)
Cast
Slavableto_slavable ()
RegionListPtrregions_with_end_within (Range)
RegionListPtrregions_with_start_within (Range)
voidremove_region (Region)
boolset_name (std::string)
boolshared ()
voidsplit_region (Region, MusicSample)
Regiontop_region_at (long)
o
Port name

Returns true if this port is connected to o, otherwise false.

intdisconnect (std::string)
intdisconnect_all ()
PortFlagsflags ()

Returns flags

LuaTable(...)get_connected_latency_range (LatencyRange&, bool)
std::stringname ()

Returns Port short name

boolautomatic ()
boolcan_move ()
boolcaptured ()
voidcaptured_xruns (XrunPositions&, bool)
voidclear_sync_position ()
Controlcontrol (Parameter, bool)
boolcovers (long)
Methods
std::stringancestor_name ()
boolcan_be_analysed ()
XrunPositionscaptured_xruns ()
boolhas_been_analysed ()
longnatural_position ()
longtimeline_position ()
+
Methods
boolisnil ()
boolwrite_immediate_event (EventType, unsigned long, unsigned char*)

Inherited from ARDOUR:Track

- + - + @@ -2517,7 +2659,7 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C - + @@ -2526,6 +2668,9 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C
Methods
Regionbounce (InterThreadInfo&)
Regionbounce (InterThreadInfo&, std::string)

bounce track from session start to session end to new region

itt
asynchronous progress report and cancel

Returns a new audio region (or nil in case of error)

Regionbounce_range (long, long, InterThreadInfo&, Processor, bool)
Regionbounce_range (long, long, InterThreadInfo&, Processor, bool, std::string)

Bounce the given range to a new audio region.

start
start time (in samples)
end
end time (in samples)
itt
asynchronous progress report and cancel
endpoint
the processor to tap the signal off (or nil for the top)
include_endpoint
include the given processor in the bounced audio.

Returns a new audio region (or nil in case of error)

boolbounceable (Processor, bool)

Test if the track can be bounced with the given settings. If sends/inserts/returns are present in the signal path or the given track has no audio outputs bouncing is not possible.

endpoint
the processor to tap the signal off (or nil for the top)
include_endpoint
include the given processor in the bounced audio.

Returns true if the track can be bounced, or false otherwise.

boolset_name (std::string)
intuse_copy_playlist ()
intuse_new_playlist (DataType)
intuse_playlist (DataType, Playlist)
intuse_playlist (DataType, Playlist, bool)
Cast
AudioTrackto_audio_track ()
MidiTrackto_midi_track ()
+ + + @@ -2537,6 +2682,8 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C + + @@ -2559,7 +2706,7 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C - + @@ -2654,6 +2801,62 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C
Methods
boolactive ()
intadd_aux_send (Route, Processor)

Add an aux send to a route.

route
route to send to.
before
Processor to insert before, or 0 to insert at the end.
intadd_foldback_send (Route, bool)
intadd_processor_by_index (Processor, int, ProcessorStreams, bool)

Add a processor to a route such that it ends up with a given index into the visible processors.

index
Index to add the processor at, or -1 to add at the end of the list.

Returns 0 on success, non-0 on failure.

booladd_sidechain (Processor)
IOinput ()
Deliverymain_outs ()

the signal processorat at end of the processing chain which produces output

MonitorControlmonitoring_control ()
MonitorStatemonitoring_state ()
boolmuted ()
ChanCountn_inputs ()
ChanCountn_outputs ()

reset plugin-insert configuration to default, disable customizations.

This is equivalent to calling

 customize_plugin_insert (proc, 0, unused)
proc
Processor to reset

Returns true if successful

voidset_active (bool, void*)
voidset_comment (std::string, void*)
voidset_meter_point (MeterPoint, bool)
voidset_meter_point (MeterPoint)
boolset_strict_io (bool)
longsignal_latency ()
boolsoloed ()
LuaTabletable ()
voidunique ()
+

 ARDOUR:MonitorControl

+

C‡: boost::shared_ptr< ARDOUR::MonitorControl >, boost::weak_ptr< ARDOUR::MonitorControl >

+

is-a: ARDOUR:SlavableAutomationControl

+
+

A PBD::Controllable with associated automation data (AutomationList)

+ + + + +
Methods
boolisnil ()
MonitorChoicemonitoring_choice ()
+

Inherited from ARDOUR:SlavableAutomationControl

+ + + + + + + + + +
Methods
voidadd_master (AutomationControl)
voidclear_masters ()
intget_boolean_masters ()
doubleget_masters_value ()
voidremove_master (AutomationControl)
boolslaved ()
boolslaved_to (AutomationControl)
+

Inherited from ARDOUR:AutomationControl

+ + + + + + + + + + + + + + + + + + + + +
Methods
AutomationListalist ()
AutoStateautomation_state ()
ParameterDescriptordesc ()
doubleget_value ()

Get `internal' value

Returns raw value as used for the plugin/processor control port

doublelower ()
doublenormal ()
voidset_automation_state (AutoState)
voidset_value (double, GroupControlDisposition)

Set `internal' value

All derived classes must implement this.

Basic derived classes will ignore group_override but more sophisticated children, notably those that proxy the value setting logic via an object that is aware of group relationships between this control and others, will find it useful.

value
raw numeric value to set
group_override
if and how to propagate value to grouped controls
voidstart_touch (double)
voidstop_touch (double)
booltoggled ()
doubleupper ()
boolwritable ()
Cast
Controlto_ctrl ()
SlavableAutomationControlto_slavable ()
+

Inherited from PBD:Controllable

+ + + +
Methods
std::stringname ()
+

Inherited from PBD:StatefulPtr

+ + + + + + +
Methods
voidclear_changes ()

Forget about any changes to this object's properties

IDid ()
OwnedPropertyListproperties ()

 ARDOUR:MonitorProcessor

C‡: boost::shared_ptr< ARDOUR::MonitorProcessor >, boost::weak_ptr< ARDOUR::MonitorProcessor >

is-a: ARDOUR:Processor

@@ -2712,6 +2915,7 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C DiskReaderto_diskreader () DiskWriterto_diskwriter () PluginInsertto_insert () + InternalSendto_internalsend () IOProcessorto_ioprocessor () Latentto_latent () PeakMeterto_meter () @@ -2862,7 +3066,18 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C Methods std::stringmidi_note_name (unsigned char, bool) Data Members + unsigned intdisplay_priority +

higher is more important http://lv2plug.in/ns/ext/port-props#displayPriority

+ boolenumeration + boolinline_ctrl + boolinteger_step std::stringlabel + floatlargestep + std::stringprint_fmt +

format string for pretty printing

+ floatsmallstep + boolsr_dependent + floatstep

Inherited from Evoral:ParameterDescriptor

@@ -2880,6 +3095,19 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C
floatupper

Maximum value (in Hz, for frequencies)

+

 ARDOUR:ParameterList

+

C‡: std::vector<Evoral::Parameter >

+
+ + + + + + + + + +
Constructor
ARDOUR.ParameterList ()
Methods
Parameterat (unsigned long)
boolempty ()
LuaIteriter ()
unsigned longsize ()
LuaTabletable ()

 ARDOUR:PeakMeter

C‡: boost::shared_ptr< ARDOUR::PeakMeter >, boost::weak_ptr< ARDOUR::PeakMeter >

is-a: ARDOUR:Processor

@@ -2916,6 +3144,7 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C DiskReaderto_diskreader () DiskWriterto_diskwriter () PluginInsertto_insert () + InternalSendto_internalsend () IOProcessorto_ioprocessor () Latentto_latent () PeakMeterto_meter () @@ -3020,6 +3249,7 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C RegionListPtrregions_with_end_within (Range) RegionListPtrregions_with_start_within (Range) voidremove_region (Region) + boolset_name (std::string) boolshared () voidsplit_region (Region, MusicSample) Regiontop_region_at (long) @@ -3070,6 +3300,8 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C std::stringget_parameter_docs (unsigned int) boolisnil () char*label () + PresetRecordlast_preset () +

Returns Last preset to be requested; the settings may have been changed since; find out with parameter_changed_since_last_preset.

boolload_preset (PresetRecord)

Set parameters using a preset

char*maker () @@ -3166,7 +3398,7 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C ARDOUR:ChanCountn_outputs std::stringname std::stringpath - ARDOUR.PluginTypetype + ARDOUR.PluginType_type std::stringunique_id

 ARDOUR:PluginInfoList

@@ -3200,7 +3432,7 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C voidenable (bool) boolenabled () unsigned intget_count () - LuaTable(bool, ...)get_stats (unsigned long&, unsigned long&, double&, double&) + LuaTable(bool, ...)get_stats (long&, long&, double&, double&) boolhas_sidechain () ChanMappinginput_map (unsigned int) boolis_channelstrip () @@ -3213,9 +3445,13 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C boolreset_parameters_to_default () voidset_input_map (unsigned int, ChanMapping) voidset_output_map (unsigned int, ChanMapping) + voidset_thru_map (ChanMapping) + IOsidechain_input () longsignal_latency () boolstrict_io_configured () - PluginTypetype () + ChanMappingthru_map () + PluginType_type () + boolwrite_immediate_event (EventType, unsigned long, unsigned char*)

Inherited from ARDOUR:Processor

@@ -3237,6 +3473,7 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C + @@ -3256,6 +3493,12 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C
DiskReaderto_diskreader ()
DiskWriterto_diskwriter ()
PluginInsertto_insert ()
InternalSendto_internalsend ()
IOProcessorto_ioprocessor ()
Latentto_latent ()
PeakMeterto_meter ()
Statefulto_stateful ()
StatefulDestructibleto_statefuldestructible ()
+

 ARDOUR.PluginType

+
+ + + +
Methods
std::stringname (PluginType, bool)

 ARDOUR:PolarityProcessor

C‡: boost::shared_ptr< ARDOUR::PolarityProcessor >, boost::weak_ptr< ARDOUR::PolarityProcessor >

is-a: ARDOUR:Processor

@@ -3288,6 +3531,7 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C DiskReaderto_diskreader () DiskWriterto_diskwriter () PluginInsertto_insert () + InternalSendto_internalsend () IOProcessorto_ioprocessor () Latentto_latent () PeakMeterto_meter () @@ -3319,6 +3563,8 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C
o
Port name

Returns true if this port is connected to o, otherwise false.

intdisconnect (std::string) intdisconnect_all () + PortFlagsflags () +

Returns flags

LuaTable(...)get_connected_latency_range (LatencyRange&, bool) boolisnil () std::stringname () @@ -3340,7 +3586,6 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C

 ARDOUR:PortEngine

C‡: ARDOUR::PortEngine

-

PortEngine is an abstract base class that defines the functionality required by Ardour.

A Port is basically an endpoint for a datastream (which can either be continuous, like audio, or event-based, like MIDI). Ports have buffers associated with them into which data can be written (if they are output ports) and from which data can be read (if they input ports). Ports can be connected together so that data written to an output port can be read from an input port. These connections can be 1:1, 1:N OR N:1.

Ports may be associated with software only, or with hardware. Hardware related ports are often referred to as physical, and correspond to some relevant physical entity on a hardware device, such as an audio jack or a MIDI connector. Physical ports may be potentially asked to monitor their inputs, though some implementations may not support this.

Most physical ports will also be considered "terminal", which means that data delivered there or read from there will go to or comes from a system outside of the PortEngine implementation's control (e.g. the analog domain for audio, or external MIDI devices for MIDI). Non-physical ports can also be considered "terminal". For example, the output port of a software synthesizer is a terminal port, because the data contained in its buffer does not and cannot be considered to come from any other port - it is synthesized by its owner.

Ports also have latency associated with them. Each port has a playback latency and a capture latency:

capture latency: how long since the data read from the buffer of a port arrived at at a terminal port. The data will have come from the "outside world" if the terminal port is also physical, or will have been synthesized by the entity that owns the terminal port.

playback latency: how long until the data written to the buffer of port will reach a terminal port.

For more detailed questions about the PortEngine API, consult the JACK API documentation, on which this entire object is based.

This class object is only used indirectly as return-value and function-parameter. It provides no methods by itself.

 ARDOUR:PortList

C‡: std::list<boost::shared_ptr<ARDOUR::Port> >

@@ -3379,6 +3624,7 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C boolphysically_connected (std::string) PortEngineport_engine () boolport_is_physical (std::string) + voidreset_input_meters ()

 ARDOUR:PortSet

C‡: boost::shared_ptr< ARDOUR::PortSet >, boost::weak_ptr< ARDOUR::PortSet >

@@ -3476,6 +3722,7 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C DiskReaderto_diskreader () DiskWriterto_diskwriter () PluginInsertto_insert () + InternalSendto_internalsend () IOProcessorto_ioprocessor () Latentto_latent () PeakMeterto_meter () @@ -3582,6 +3829,7 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C boolget_auto_analyse_audio () boolget_auto_connect_standard_busses () boolget_auto_input_does_talkback () + boolget_auto_return_after_rewind_ffwd () AutoReturnTargetget_auto_return_target_list () boolget_automation_follows_regions () floatget_automation_interval_msecs () @@ -3593,15 +3841,16 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C std::stringget_click_sound () boolget_clicking () boolget_conceal_lv1_if_lv2_exists () + boolget_conceal_vst2_if_vst3_exists () boolget_copy_demo_sessions () + intget_cpu_dma_latency () boolget_create_xrun_marker () FadeShapeget_default_fade_shape () std::stringget_default_session_parent_dir () DenormalModelget_denormal_model () boolget_denormal_protection () boolget_disable_disarm_during_roll () - boolget_discover_audio_units () - boolget_discover_vst_on_start () + boolget_discover_plugins_on_start () unsigned intget_disk_choice_space_threshold () std::stringget_donate_url () EditModeget_edit_mode () @@ -3624,7 +3873,7 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C std::stringget_linux_pingback_url () ListenPositionget_listen_position () boolget_locate_while_waiting_for_sync () - --MISSING (ARDOUR::LoopFadeChoice)--get_loop_fade_choice () + LoopFadeChoiceget_loop_fade_choice () boolget_loop_is_mode () std::stringget_ltc_output_port () floatget_ltc_output_volume () @@ -3661,8 +3910,11 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C unsigned intget_periodic_safety_backup_interval () boolget_periodic_safety_backups () PFLPositionget_pfl_position () + unsigned intget_plugin_cache_version () std::stringget_plugin_path_lxvst () std::stringget_plugin_path_vst () + std::stringget_plugin_path_vst3 () + unsigned intget_plugin_scan_timeout () boolget_plugins_stop_with_transport () longget_postroll () longget_preroll () @@ -3671,12 +3923,15 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C boolget_quieten_at_speed () longget_range_location_minimum () RangeSelectionAfterSplitget_range_selection_after_split () + boolget_recording_resets_xrun_count () std::stringget_reference_manual_url () boolget_region_boundaries_from_onscreen_tracks () boolget_region_boundaries_from_selected_tracks () RegionEquivalenceget_region_equivalence () RegionSelectionAfterSplitget_region_selection_after_split () boolget_replicate_missing_region_channels () + boolget_reset_default_speed_on_stop () + boolget_rewind_ffwd_like_tape_decks () boolget_run_all_transport_masters_always () boolget_save_history () intget_saved_history_depth () @@ -3687,7 +3942,7 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C boolget_show_solo_mutes () boolget_show_video_export_info () boolget_show_video_server_dialog () - ShuttleBehaviourget_shuttle_behaviour () + boolget_show_vst3_micro_edit_inline () floatget_shuttle_max_speed () floatget_shuttle_speed_factor () floatget_shuttle_speed_threshold () @@ -3708,21 +3963,24 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C boolget_try_autostart_engine () std::stringget_tutorial_manual_url () std::stringget_updates_url () + boolget_use_audio_units () boolget_use_click_emphasis () boolget_use_lxvst () boolget_use_macvst () + boolget_use_master_volume () boolget_use_monitor_bus () boolget_use_osc () boolget_use_plugin_own_gui () boolget_use_tranzport () + boolget_use_vst3 () boolget_use_windows_vst () boolget_verbose_plugin_scan () boolget_verify_remove_last_capture () boolget_video_advanced_setup () std::stringget_video_server_docroot () std::stringget_video_server_url () - intget_vst_scan_timeout () std::stringget_windows_pingback_url () + boolget_work_around_jack_no_copy_optimization () std::stringget_xjadeo_binary () boolset_afl_position (AFLPosition) boolset_all_safe (bool) @@ -3736,6 +3994,7 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C boolset_auto_analyse_audio (bool) boolset_auto_connect_standard_busses (bool) boolset_auto_input_does_talkback (bool) + boolset_auto_return_after_rewind_ffwd (bool) boolset_auto_return_target_list (AutoReturnTarget) boolset_automation_follows_regions (bool) boolset_automation_interval_msecs (float) @@ -3747,15 +4006,16 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C boolset_click_sound (std::string) boolset_clicking (bool) boolset_conceal_lv1_if_lv2_exists (bool) + boolset_conceal_vst2_if_vst3_exists (bool) boolset_copy_demo_sessions (bool) + boolset_cpu_dma_latency (int) boolset_create_xrun_marker (bool) boolset_default_fade_shape (FadeShape) boolset_default_session_parent_dir (std::string) boolset_denormal_model (DenormalModel) boolset_denormal_protection (bool) boolset_disable_disarm_during_roll (bool) - boolset_discover_audio_units (bool) - boolset_discover_vst_on_start (bool) + boolset_discover_plugins_on_start (bool) boolset_disk_choice_space_threshold (unsigned int) boolset_donate_url (std::string) boolset_edit_mode (EditMode) @@ -3778,7 +4038,7 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C boolset_linux_pingback_url (std::string) boolset_listen_position (ListenPosition) boolset_locate_while_waiting_for_sync (bool) - boolset_loop_fade_choice (--MISSING (ARDOUR::LoopFadeChoice)--) + boolset_loop_fade_choice (LoopFadeChoice) boolset_loop_is_mode (bool) boolset_ltc_output_port (std::string) boolset_ltc_output_volume (float) @@ -3815,8 +4075,11 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C boolset_periodic_safety_backup_interval (unsigned int) boolset_periodic_safety_backups (bool) boolset_pfl_position (PFLPosition) + boolset_plugin_cache_version (unsigned int) boolset_plugin_path_lxvst (std::string) boolset_plugin_path_vst (std::string) + boolset_plugin_path_vst3 (std::string) + boolset_plugin_scan_timeout (unsigned int) boolset_plugins_stop_with_transport (bool) boolset_postroll (long) boolset_preroll (long) @@ -3825,12 +4088,15 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C boolset_quieten_at_speed (bool) boolset_range_location_minimum (long) boolset_range_selection_after_split (RangeSelectionAfterSplit) + boolset_recording_resets_xrun_count (bool) boolset_reference_manual_url (std::string) boolset_region_boundaries_from_onscreen_tracks (bool) boolset_region_boundaries_from_selected_tracks (bool) boolset_region_equivalence (RegionEquivalence) boolset_region_selection_after_split (RegionSelectionAfterSplit) boolset_replicate_missing_region_channels (bool) + boolset_reset_default_speed_on_stop (bool) + boolset_rewind_ffwd_like_tape_decks (bool) boolset_run_all_transport_masters_always (bool) boolset_save_history (bool) boolset_saved_history_depth (int) @@ -3841,7 +4107,7 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C boolset_show_solo_mutes (bool) boolset_show_video_export_info (bool) boolset_show_video_server_dialog (bool) - boolset_shuttle_behaviour (ShuttleBehaviour) + boolset_show_vst3_micro_edit_inline (bool) boolset_shuttle_max_speed (float) boolset_shuttle_speed_factor (float) boolset_shuttle_speed_threshold (float) @@ -3862,21 +4128,24 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C boolset_try_autostart_engine (bool) boolset_tutorial_manual_url (std::string) boolset_updates_url (std::string) + boolset_use_audio_units (bool) boolset_use_click_emphasis (bool) boolset_use_lxvst (bool) boolset_use_macvst (bool) + boolset_use_master_volume (bool) boolset_use_monitor_bus (bool) boolset_use_osc (bool) boolset_use_plugin_own_gui (bool) boolset_use_tranzport (bool) + boolset_use_vst3 (bool) boolset_use_windows_vst (bool) boolset_verbose_plugin_scan (bool) boolset_verify_remove_last_capture (bool) boolset_video_advanced_setup (bool) boolset_video_server_docroot (std::string) boolset_video_server_url (std::string) - boolset_vst_scan_timeout (int) boolset_windows_pingback_url (std::string) + boolset_work_around_jack_no_copy_optimization (bool) boolset_xjadeo_binary (std::string) Properties ARDOUR.AFLPositionafl_position @@ -3891,6 +4160,7 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C boolauto_analyse_audio boolauto_connect_standard_busses boolauto_input_does_talkback + boolauto_return_after_rewind_ffwd ARDOUR.AutoReturnTargetauto_return_target_list boolautomation_follows_regions floatautomation_interval_msecs @@ -3902,15 +4172,16 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C std::stringclick_sound boolclicking boolconceal_lv1_if_lv2_exists + boolconceal_vst2_if_vst3_exists boolcopy_demo_sessions + intcpu_dma_latency boolcreate_xrun_marker ARDOUR.FadeShapedefault_fade_shape std::stringdefault_session_parent_dir ARDOUR.DenormalModeldenormal_model booldenormal_protection booldisable_disarm_during_roll - booldiscover_audio_units - booldiscover_vst_on_start + booldiscover_plugins_on_start unsigned intdisk_choice_space_threshold std::stringdonate_url ARDOUR.EditModeedit_mode @@ -3933,7 +4204,7 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C std::stringlinux_pingback_url ARDOUR.ListenPositionlisten_position boollocate_while_waiting_for_sync - --MISSING (ARDOUR::LoopFadeChoice)--loop_fade_choice + ARDOUR.LoopFadeChoiceloop_fade_choice boolloop_is_mode std::stringltc_output_port floatltc_output_volume @@ -3970,8 +4241,11 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C unsigned intperiodic_safety_backup_interval boolperiodic_safety_backups ARDOUR.PFLPositionpfl_position + unsigned intplugin_cache_version std::stringplugin_path_lxvst std::stringplugin_path_vst + std::stringplugin_path_vst3 + unsigned intplugin_scan_timeout boolplugins_stop_with_transport longpostroll longpreroll @@ -3980,12 +4254,15 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C boolquieten_at_speed longrange_location_minimum ARDOUR.RangeSelectionAfterSplitrange_selection_after_split + boolrecording_resets_xrun_count std::stringreference_manual_url boolregion_boundaries_from_onscreen_tracks boolregion_boundaries_from_selected_tracks ARDOUR.RegionEquivalenceregion_equivalence ARDOUR.RegionSelectionAfterSplitregion_selection_after_split boolreplicate_missing_region_channels + boolreset_default_speed_on_stop + boolrewind_ffwd_like_tape_decks boolrun_all_transport_masters_always boolsave_history intsaved_history_depth @@ -3996,7 +4273,7 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C boolshow_solo_mutes boolshow_video_export_info boolshow_video_server_dialog - ARDOUR.ShuttleBehaviourshuttle_behaviour + boolshow_vst3_micro_edit_inline floatshuttle_max_speed floatshuttle_speed_factor floatshuttle_speed_threshold @@ -4017,21 +4294,24 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C booltry_autostart_engine std::stringtutorial_manual_url std::stringupdates_url + booluse_audio_units booluse_click_emphasis booluse_lxvst booluse_macvst + booluse_master_volume booluse_monitor_bus booluse_osc booluse_plugin_own_gui booluse_tranzport + booluse_vst3 booluse_windows_vst boolverbose_plugin_scan boolverify_remove_last_capture boolvideo_advanced_setup std::stringvideo_server_docroot std::stringvideo_server_url - intvst_scan_timeout std::stringwindows_pingback_url + boolwork_around_jack_no_copy_optimization std::stringxjadeo_binary

Inherited from PBD:Stateful

@@ -4113,6 +4393,7 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C boolautomatic () boolcan_move () boolcaptured () + voidcaptured_xruns (XrunPositions&, bool) voidclear_sync_position () Controlcontrol (Parameter, bool) boolcovers (long) @@ -4301,6 +4582,7 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C DiskReaderto_diskreader () DiskWriterto_diskwriter () PluginInsertto_insert () + InternalSendto_internalsend () IOProcessorto_ioprocessor () Latentto_latent () PeakMeterto_meter () @@ -4328,6 +4610,9 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C + + + @@ -4340,6 +4625,8 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C + + @@ -4362,7 +4649,7 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C - + @@ -4552,9 +4839,14 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C

A mixer strip element (Processor) with 1 or 2 IO elements.

Methods
boolactive ()
intadd_aux_send (Route, Processor)

Add an aux send to a route.

route
route to send to.
before
Processor to insert before, or 0 to insert at the end.
intadd_foldback_send (Route, bool)
intadd_processor_by_index (Processor, int, ProcessorStreams, bool)

Add a processor to a route such that it ends up with a given index into the visible processors.

index
Index to add the processor at, or -1 to add at the end of the list.

Returns 0 on success, non-0 on failure.

booladd_sidechain (Processor)
boolisnil ()
Deliverymain_outs ()

the signal processorat at end of the processing chain which produces output

MonitorControlmonitoring_control ()
MonitorStatemonitoring_state ()
boolmuted ()
ChanCountn_inputs ()
ChanCountn_outputs ()

reset plugin-insert configuration to default, disable customizations.

This is equivalent to calling

 customize_plugin_insert (proc, 0, unused)
proc
Processor to reset

Returns true if successful

voidset_active (bool, void*)
voidset_comment (std::string, void*)
voidset_meter_point (MeterPoint, bool)
voidset_meter_point (MeterPoint)
boolset_name (std::string)
boolset_strict_io (bool)
longsignal_latency ()
+ + + + +
Methods
GainControlgain_control ()
longget_delay_in ()
longget_delay_out ()
boolis_foldback ()
boolisnil ()
voidset_remove_on_disconnect (bool)
Cast
InternalSendto_internalsend ()

Inherited from ARDOUR:Delivery

@@ -4592,6 +4884,7 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C + @@ -4617,19 +4910,26 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C

Ardour Session

DiskReaderto_diskreader ()
DiskWriterto_diskwriter ()
PluginInsertto_insert ()
InternalSendto_internalsend ()
IOProcessorto_ioprocessor ()
Latentto_latent ()
PeakMeterto_meter ()
+ + + + + + + @@ -4637,6 +4937,7 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C + @@ -4659,9 +4960,9 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C - + - + @@ -4672,11 +4973,13 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C + + - + @@ -4706,8 +5009,16 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C + + + + + + + + @@ -4963,6 +5274,7 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C + @@ -5225,6 +5537,7 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C + @@ -5377,7 +5690,7 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C - + @@ -5424,9 +5737,9 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C

A track is an route (bus) with a recordable diskstream and related objects relevant to recording, playback and editing.

Specifically a track has a playlist object that describes material to be played from disk, and modifies that object during recording and editing.

Methods
boolabort_empty_reversible_command ()

Abort reversible commend IFF no undo changes have been collected.

Returns true if undo operation was aborted.

voidabort_reversible_command ()

abort an open undo command This must only be called after begin_reversible_command ()

boolactively_recording ()
doubleactual_speed ()
voidadd_command (Command)
voidadd_internal_send (Route, Processor, Route)
voidadd_internal_sends (Route, Placement, RouteListPtr)
intadd_master_bus (ChanCount)
StatefulDiffCommandadd_stateful_diff_command (StatefulDestructiblePtr)

create an StatefulDiffCommand from the given object and add it to the stack.

This function must only be called after begin_reversible_command. Failing to do so may lead to a crash.

sfd
the object to diff

Returns the allocated StatefulDiffCommand (already added via add_command)

voidbegin_reversible_command (std::string)

begin collecting undo information

This call must always be followed by either begin_reversible_command() or commit_reversible_command()

cmd_name
human readable name for the undo operation
BundleListPtrbundles ()
voidcancel_all_solo ()
SessionConfigurationcfg ()
voidclear_all_solo_state (RouteListPtr)
boolcollected_undo_commands ()

Test if any undo commands were added since the call to begin_reversible_command ()

This is is useful to determine if an undoable action was performed before adding additional information (e.g. selection changes) to the undo transaction.

Returns true if undo operation is valid but empty

voidcommit_reversible_command (Command)

finalize an undo command and commit pending transactions

This must only be called after begin_reversible_command ()

cmd
(additional) command to add
Controllablecontrollable_by_id (ID)
longcurrent_start_sample ()
voiddisable_record (bool, bool)
AudioEngineengine ()
doubleengine_speed ()
boolexport_track_state (RouteListPtr, std::string)
unsigned intget_block_size ()
boolget_play_loop ()
Routemonitor_out ()
std::stringname ()
RouteListnew_audio_route (int, int, RouteGroup, unsigned int, std::string, Flag, unsigned int)
AudioTrackListnew_audio_track (int, int, RouteGroup, unsigned int, std::string, unsigned int, TrackMode)
AudioTrackListnew_audio_track (int, int, RouteGroup, unsigned int, std::string, unsigned int, TrackMode, bool)
RouteListnew_midi_route (RouteGroup, unsigned int, std::string, bool, PluginInfo, PresetRecord, Flag, unsigned int)
MidiTrackListnew_midi_track (ChanCount, ChanCount, bool, PluginInfo, PresetRecord, RouteGroup, unsigned int, std::string, unsigned int, TrackMode)
MidiTrackListnew_midi_track (ChanCount, ChanCount, bool, PluginInfo, PresetRecord, RouteGroup, unsigned int, std::string, unsigned int, TrackMode, bool)
RouteListnew_route_from_template (unsigned int, unsigned int, std::string, std::string, PlaylistDisposition)
RouteGroupnew_route_group (std::string)
longnominal_sample_rate ()
Processorprocessor_by_id (ID)
RecordStaterecord_status ()
voidremove_route_group (RouteGroup)
intrename (std::string)
voidrequest_bounded_roll (long, long)
voidrequest_locate (long, LocateTransportDisposition, TransportRequestSource)
voidrequest_play_loop (bool, bool)
voidrequest_roll (TransportRequestSource)
voidrequest_stop (bool, bool, TransportRequestSource)
voidrequest_transport_speed (double, bool, TransportRequestSource)
voidrequest_transport_speed (double, TransportRequestSource)
voidreset_xrun_count ()
Routeroute_by_id (ID)
Routeroute_by_name (std::string)
doubletimecode_frames_per_second ()
...timecode_to_sample_lua (--lua--)
booltransport_rolling ()

Returns true if the the transport is actively (audible) rolling. playback speed is not zero, and count-in as well as latency-preroll is complete, and _transport_sample changes every process cycle.

longtransport_sample ()
doubletransport_speed ()
booltransport_state_rolling ()

Returns true if the transport state (TFSM) is rolling. Note: the transport may not yet move if pre-roll or count-in in ongoing.

booltransport_stopped ()

Returns true if the transport state (TFSM) is stopped

booltransport_stopped_or_stopping ()

Returns true if the transport state (TFSM) is stopped or stopping

booltransport_will_roll_forwards ()
StringListunknown_processors ()
VCAManagervca_manager ()
longworst_input_latency ()
DiskReaderto_diskreader ()
DiskWriterto_diskwriter ()
PluginInsertto_insert ()
InternalSendto_internalsend ()
IOProcessorto_ioprocessor ()
Latentto_latent ()
PeakMeterto_meter ()
Methods
std::stringancestor_name ()
boolcan_be_analysed ()
XrunPositionscaptured_xruns ()
boolempty ()
boolhas_been_analysed ()
boolisnil ()
Methods
MeterSectionadd_meter (Meter, BBT_TIME, long, PositionLockStyle)
TempoSectionadd_tempo (Tempo, double, long, PositionLockStyle)
BBT_TIMEbbt_at_sample (long)
BBT_TIMEbbt_at_sample (long)

Returns the BBT time corresponding to the supplied sample position.

sample
the position in audio samples.

Returns the BBT time at the sample position .

doubleexact_beat_at_sample (long, int)
doubleexact_qn_at_sample (long, int)
- + - + @@ -5437,7 +5750,7 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C - + @@ -5446,6 +5759,9 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C
Methods
Regionbounce (InterThreadInfo&)
Regionbounce (InterThreadInfo&, std::string)

bounce track from session start to session end to new region

itt
asynchronous progress report and cancel

Returns a new audio region (or nil in case of error)

Regionbounce_range (long, long, InterThreadInfo&, Processor, bool)
Regionbounce_range (long, long, InterThreadInfo&, Processor, bool, std::string)

Bounce the given range to a new audio region.

start
start time (in samples)
end
end time (in samples)
itt
asynchronous progress report and cancel
endpoint
the processor to tap the signal off (or nil for the top)
include_endpoint
include the given processor in the bounced audio.

Returns a new audio region (or nil in case of error)

boolbounceable (Processor, bool)

Test if the track can be bounced with the given settings. If sends/inserts/returns are present in the signal path or the given track has no audio outputs bouncing is not possible.

endpoint
the processor to tap the signal off (or nil for the top)
include_endpoint
include the given processor in the bounced audio.

Returns true if the track can be bounced, or false otherwise.

boolset_name (std::string)
intuse_copy_playlist ()
intuse_new_playlist (DataType)
intuse_playlist (DataType, Playlist)
intuse_playlist (DataType, Playlist, bool)
Cast
AudioTrackto_audio_track ()
MidiTrackto_midi_track ()
+ + + @@ -5457,6 +5773,8 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C + + @@ -5479,7 +5797,7 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C - + @@ -5588,6 +5906,7 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C + @@ -5607,6 +5926,30 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C
Methods
boolactive ()
intadd_aux_send (Route, Processor)

Add an aux send to a route.

route
route to send to.
before
Processor to insert before, or 0 to insert at the end.
intadd_foldback_send (Route, bool)
intadd_processor_by_index (Processor, int, ProcessorStreams, bool)

Add a processor to a route such that it ends up with a given index into the visible processors.

index
Index to add the processor at, or -1 to add at the end of the list.

Returns 0 on success, non-0 on failure.

booladd_sidechain (Processor)
IOinput ()
Deliverymain_outs ()

the signal processorat at end of the processing chain which produces output

MonitorControlmonitoring_control ()
MonitorStatemonitoring_state ()
boolmuted ()
ChanCountn_inputs ()
ChanCountn_outputs ()

reset plugin-insert configuration to default, disable customizations.

This is equivalent to calling

 customize_plugin_insert (proc, 0, unused)
proc
Processor to reset

Returns true if successful

voidset_active (bool, void*)
voidset_comment (std::string, void*)
voidset_meter_point (MeterPoint, bool)
voidset_meter_point (MeterPoint)
boolset_strict_io (bool)
longsignal_latency ()
boolsoloed ()
DiskReaderto_diskreader ()
DiskWriterto_diskwriter ()
PluginInsertto_insert ()
InternalSendto_internalsend ()
IOProcessorto_ioprocessor ()
Latentto_latent ()
PeakMeterto_meter ()
Statefulto_stateful ()
StatefulDestructibleto_statefuldestructible ()
+

 ARDOUR:UserBundle

+

C‡: boost::shared_ptr< ARDOUR::UserBundle >, boost::weak_ptr< ARDOUR::UserBundle >

+

is-a: ARDOUR:Bundle

+
+

A set of `channels', each of which is associated with 0 or more ports. Each channel has a name which can be anything useful, and a data type. Intended for grouping things like, for example, a buss' outputs. `Channel' is a rather overloaded term but I can't think of a better one right now.

+ + + +
Methods
boolisnil ()
+

Inherited from ARDOUR:Bundle

+ + + + + + + + + + + + + +
Methods
std::stringchannel_name (unsigned int)
ch
Channel.

Returns Channel name.

unsigned intn_total ()
std::stringname ()

Returns Bundle name

ChanCountnchannels ()

Returns Number of channels that this Bundle has

boolports_are_inputs ()
boolports_are_outputs ()
Cast
UserBundleto_userbundle ()

 ARDOUR:VCA

C‡: boost::shared_ptr< ARDOUR::VCA >, boost::weak_ptr< ARDOUR::VCA >

is-a: ARDOUR:Stripable

@@ -5779,6 +6122,24 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C unsigned longsize () LuaTabletable () +

 ARDOUR:XrunPositions

+

C‡: std::vector<long >

+
+ + + + + + + + + + + + + + +
Constructor
ARDOUR.XrunPositions ()
ARDOUR.XrunPositions ()
Methods
LuaTableadd (LuaTable {long})
longat (unsigned long)
voidclear ()
boolempty ()
LuaIteriter ()
voidpush_back (long)
unsigned longsize ()
LuaTabletable ()
...to_array (--lua--)

 ArdourUI

@@ -5798,7 +6159,7 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C - +
Methods
std::stringname ()
longposition ()
Typetype ()
Type_type ()

 ArdourUI:ArdourMarkerList

C‡: std::list<ArdourMarker* >

@@ -5830,19 +6191,19 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C Methods voidaccess_action (std::string, std::string) voidadd_location_from_playhead_cursor () + voidadd_location_mark (long) TrackViewListaxis_views_from_routes (RouteListPtr) voidcenter_screen (long) + voidclear_grouped_playlists (RouteUI) voidclear_playlist (Playlist) - voidclear_playlists (TimeAxisView) voidconsider_auditioning (Region)

Possibly start the audition of a region.

If r is 0, or not an AudioRegion any current audition is cancelled. If we are currently auditioning r , the audition will be cancelled. Otherwise an audition of r will start.

r
Region to consider auditioning
- voidcopy_playlists (TimeAxisView) MouseModecurrent_mouse_mode ()

Returns The current mouse mode (gain, object, range, timefx etc.) (defined in editing_syms.h)

longcurrent_page_samples () voiddeselect_all () LuaTable(...)do_embed (StringVector, ImportDisposition, ImportMode, long&, PluginInfo) - LuaTable(...)do_import (StringVector, ImportDisposition, ImportMode, SrcQuality, MidiTrackNameSource, MidiTempoMapDisposition, long&, PluginInfo) + LuaTable(...)do_import (StringVector, ImportDisposition, ImportMode, SrcQuality, MidiTrackNameSource, MidiTempoMapDisposition, long&, PluginInfo, bool)

Import existing media

booldragging_playhead ()

Returns true if the playhead is currently being dragged, otherwise false

@@ -5880,7 +6241,10 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C voidmaximise_editing_space () voidmaybe_locate_with_edit_preroll (long) voidmouse_add_new_marker (long, bool) - voidnew_playlists (TimeAxisView) + voidnew_playlists_for_all_tracks (bool) + voidnew_playlists_for_armed_tracks (bool) + voidnew_playlists_for_grouped_tracks (RouteUI, bool) + voidnew_playlists_for_selected_tracks (bool) voidnew_region_from_selection () voidoverride_visible_track_count () longpixel_to_sample (double) @@ -6071,9 +6435,9 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C
- - - + + +
Methods
longend_sample ()
longlength ()
longstart ()
longend_sample ()
longlength ()
longstart ()

Inherited from ARDOUR:AudioRangeList

@@ -6135,6 +6499,7 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C + @@ -6142,6 +6507,7 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C + @@ -6156,19 +6522,24 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C + + + + + - - + + - + @@ -6178,25 +6549,29 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C - + + - - + + + + + @@ -6214,6 +6589,7 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C + @@ -6231,12 +6607,13 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C - - + + + @@ -6244,6 +6621,7 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C + @@ -6258,19 +6636,24 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C + + + + + - - + + - + @@ -6280,25 +6663,29 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C - + + - - + + + + + @@ -6316,6 +6703,7 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C + @@ -6333,13 +6721,14 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C - - + + + @@ -6347,6 +6736,7 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C + @@ -6361,19 +6751,24 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C + + + + + - - + + - + @@ -6383,25 +6778,29 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C - + + - - + + + + + @@ -6419,6 +6818,7 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C + @@ -6436,8 +6836,8 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C - - + +
unsigned intget_action_table_columns ()
boolget_all_floating_windows_are_dialogs ()
boolget_allow_non_quarter_pulse ()
boolget_automation_edit_cancels_auto_hide ()
boolget_autoplay_files ()
boolget_autoscroll_editor ()
boolget_blink_alert_indicators ()
boolget_boxy_buttons ()
boolget_buggy_gradients ()
boolget_cairo_image_surface ()
boolget_check_announcements ()
unsigned longget_clock_display_limit ()
std::stringget_color_file ()
boolget_color_regions_using_track_color ()
boolget_follow_edits ()
intget_font_scale ()
boolget_grid_follows_internal ()
boolget_hide_splash_screen ()
boolget_hiding_groups_deactivates_groups ()
std::stringget_icon_set ()
InputMeterLayoutget_input_meter_layout ()
boolget_input_meter_scopes ()
std::stringget_keyboard_layout ()
std::stringget_keyboard_layout_name ()
boolget_link_region_and_track_selection ()
unsigned intget_lock_gui_after_seconds ()
unsigned intget_max_inline_controls ()
intget_max_plugin_chart ()
intget_max_plugin_recent ()
floatget_meter_hold ()
--MISSING (ARDOUR::MeterLineUp)--get_meter_line_up_din ()
--MISSING (ARDOUR::MeterLineUp)--get_meter_line_up_level ()
MeterLineUpget_meter_line_up_din ()
MeterLineUpget_meter_line_up_level ()
floatget_meter_peak ()
boolget_meter_style_led ()
--MISSING (ARDOUR::VUMeterStandard)--get_meter_vu_standard ()
VUMeterStandardget_meter_vu_standard ()
std::stringget_mixer_strip_visibility ()
boolget_name_new_markers ()
boolget_never_display_periodic_midi ()
boolget_open_gui_after_adding_plugin ()
boolget_prefer_inline_over_gui ()
boolget_preview_video_frame_on_drag ()
--MISSING (ARDOUR::ClockDeltaMode)--get_primary_clock_delta_mode ()
ClockDeltaModeget_primary_clock_delta_mode ()
intget_recent_session_sort ()
boolget_rubberbanding_snaps_to_grid ()
unsigned intget_ruler_granularity ()
boolget_rulers_follow_grid ()
boolget_save_export_analysis_image ()
boolget_save_export_mixer_screenshot ()
--MISSING (ARDOUR::ScreenSaverMode)--get_screen_saver_mode ()
--MISSING (ARDOUR::ClockDeltaMode)--get_secondary_clock_delta_mode ()
ScreenSaverModeget_screen_saver_mode ()
ClockDeltaModeget_secondary_clock_delta_mode ()
boolget_show_editor_meter ()
boolget_show_grids_ruler ()
boolget_show_inline_display_by_default ()
boolget_show_mini_timeline ()
boolget_show_name_highlight ()
boolget_show_plugin_scan_window ()
boolget_show_region_cue_markers ()
boolget_show_region_gain ()
boolget_show_region_name ()
boolget_show_region_xrun_markers ()
boolget_show_secondary_clock ()
boolget_show_snapped_cursor ()
boolget_show_toolbar_latency ()
boolget_show_toolbar_monitor_info ()
boolget_show_toolbar_monitoring ()
boolget_show_toolbar_recpunch ()
boolget_show_toolbar_selclock ()
boolget_sound_midi_notes ()
std::stringget_stripable_color_palette ()
boolget_super_rapid_clock_update ()
intget_time_axis_name_ellipsize_mode ()
floatget_timeline_item_gradient_depth ()
boolget_transients_follow_front ()
std::stringget_ui_font_family ()
unsigned longget_waveform_cache_size ()
doubleget_waveform_clip_level ()
floatget_waveform_gradient_depth ()
--MISSING (ARDOUR::WaveformScale)--get_waveform_scale ()
--MISSING (ARDOUR::WaveformShape)--get_waveform_shape ()
WaveformScaleget_waveform_scale ()
WaveformShapeget_waveform_shape ()
boolget_widget_prelight ()
boolset_action_table_columns (unsigned int)
boolset_all_floating_windows_are_dialogs (bool)
boolset_allow_non_quarter_pulse (bool)
boolset_automation_edit_cancels_auto_hide (bool)
boolset_autoplay_files (bool)
boolset_autoscroll_editor (bool)
boolset_blink_alert_indicators (bool)
boolset_boxy_buttons (bool)
boolset_buggy_gradients (bool)
boolset_cairo_image_surface (bool)
boolset_check_announcements (bool)
boolset_clock_display_limit (unsigned long)
boolset_color_file (std::string)
boolset_color_regions_using_track_color (bool)
boolset_follow_edits (bool)
boolset_font_scale (int)
boolset_grid_follows_internal (bool)
boolset_hide_splash_screen (bool)
boolset_hiding_groups_deactivates_groups (bool)
boolset_icon_set (std::string)
boolset_input_meter_layout (InputMeterLayout)
boolset_input_meter_scopes (bool)
boolset_keyboard_layout (std::string)
boolset_keyboard_layout_name (std::string)
boolset_link_region_and_track_selection (bool)
boolset_lock_gui_after_seconds (unsigned int)
boolset_max_inline_controls (unsigned int)
boolset_max_plugin_chart (int)
boolset_max_plugin_recent (int)
boolset_meter_hold (float)
boolset_meter_line_up_din (--MISSING (ARDOUR::MeterLineUp)--)
boolset_meter_line_up_level (--MISSING (ARDOUR::MeterLineUp)--)
boolset_meter_line_up_din (MeterLineUp)
boolset_meter_line_up_level (MeterLineUp)
boolset_meter_peak (float)
boolset_meter_style_led (bool)
boolset_meter_vu_standard (--MISSING (ARDOUR::VUMeterStandard)--)
boolset_meter_vu_standard (VUMeterStandard)
boolset_mixer_strip_visibility (std::string)
boolset_name_new_markers (bool)
boolset_never_display_periodic_midi (bool)
boolset_open_gui_after_adding_plugin (bool)
boolset_prefer_inline_over_gui (bool)
boolset_preview_video_frame_on_drag (bool)
boolset_primary_clock_delta_mode (--MISSING (ARDOUR::ClockDeltaMode)--)
boolset_primary_clock_delta_mode (ClockDeltaMode)
boolset_recent_session_sort (int)
boolset_rubberbanding_snaps_to_grid (bool)
boolset_ruler_granularity (unsigned int)
boolset_rulers_follow_grid (bool)
boolset_save_export_analysis_image (bool)
boolset_save_export_mixer_screenshot (bool)
boolset_screen_saver_mode (--MISSING (ARDOUR::ScreenSaverMode)--)
boolset_secondary_clock_delta_mode (--MISSING (ARDOUR::ClockDeltaMode)--)
boolset_screen_saver_mode (ScreenSaverMode)
boolset_secondary_clock_delta_mode (ClockDeltaMode)
boolset_show_editor_meter (bool)
boolset_show_grids_ruler (bool)
boolset_show_inline_display_by_default (bool)
boolset_show_mini_timeline (bool)
boolset_show_name_highlight (bool)
boolset_show_plugin_scan_window (bool)
boolset_show_region_cue_markers (bool)
boolset_show_region_gain (bool)
boolset_show_region_name (bool)
boolset_show_region_xrun_markers (bool)
boolset_show_secondary_clock (bool)
boolset_show_snapped_cursor (bool)
boolset_show_toolbar_latency (bool)
boolset_show_toolbar_monitor_info (bool)
boolset_show_toolbar_monitoring (bool)
boolset_show_toolbar_recpunch (bool)
boolset_show_toolbar_selclock (bool)
boolset_sound_midi_notes (bool)
boolset_stripable_color_palette (std::string)
boolset_super_rapid_clock_update (bool)
boolset_time_axis_name_ellipsize_mode (int)
boolset_timeline_item_gradient_depth (float)
boolset_transients_follow_front (bool)
boolset_ui_font_family (std::string)
boolset_waveform_cache_size (unsigned long)
boolset_waveform_clip_level (double)
boolset_waveform_gradient_depth (float)
boolset_waveform_scale (--MISSING (ARDOUR::WaveformScale)--)
boolset_waveform_shape (--MISSING (ARDOUR::WaveformShape)--)
boolset_waveform_scale (WaveformScale)
boolset_waveform_shape (WaveformShape)
boolset_widget_prelight (bool)
Properties
unsigned intaction_table_columns
boolall_floating_windows_are_dialogs
boolallow_non_quarter_pulse
boolautomation_edit_cancels_auto_hide
boolautoplay_files
boolautoscroll_editor
boolblink_alert_indicators
boolboxy_buttons
boolbuggy_gradients
boolcairo_image_surface
boolcheck_announcements
unsigned longclock_display_limit
std::stringcolor_file
boolcolor_regions_using_track_color
boolfollow_edits
intfont_scale
boolgrid_follows_internal
boolhide_splash_screen
boolhiding_groups_deactivates_groups
std::stringicon_set
ARDOUR.InputMeterLayoutinput_meter_layout
boolinput_meter_scopes
std::stringkeyboard_layout
std::stringkeyboard_layout_name
boollink_region_and_track_selection
unsigned intlock_gui_after_seconds
unsigned intmax_inline_controls
intmax_plugin_chart
intmax_plugin_recent
floatmeter_hold
--MISSING (ARDOUR::MeterLineUp)--meter_line_up_din
--MISSING (ARDOUR::MeterLineUp)--meter_line_up_level
ARDOUR.MeterLineUpmeter_line_up_din
ARDOUR.MeterLineUpmeter_line_up_level
floatmeter_peak
boolmeter_style_led
--MISSING (ARDOUR::VUMeterStandard)--meter_vu_standard
ARDOUR.VUMeterStandardmeter_vu_standard
std::stringmixer_strip_visibility
boolname_new_markers
boolnever_display_periodic_midi
boolopen_gui_after_adding_plugin
boolprefer_inline_over_gui
boolpreview_video_frame_on_drag
--MISSING (ARDOUR::ClockDeltaMode)--primary_clock_delta_mode
ARDOUR.ClockDeltaModeprimary_clock_delta_mode
intrecent_session_sort
boolrubberbanding_snaps_to_grid
unsigned intruler_granularity
boolrulers_follow_grid
boolsave_export_analysis_image
boolsave_export_mixer_screenshot
--MISSING (ARDOUR::ScreenSaverMode)--screen_saver_mode
--MISSING (ARDOUR::ClockDeltaMode)--secondary_clock_delta_mode
ARDOUR.ScreenSaverModescreen_saver_mode
ARDOUR.ClockDeltaModesecondary_clock_delta_mode
boolshow_editor_meter
boolshow_grids_ruler
boolshow_inline_display_by_default
boolshow_mini_timeline
boolshow_name_highlight
boolshow_plugin_scan_window
boolshow_region_cue_markers
boolshow_region_gain
boolshow_region_name
boolshow_region_xrun_markers
boolshow_secondary_clock
boolshow_snapped_cursor
boolshow_toolbar_latency
boolshow_toolbar_monitor_info
boolshow_toolbar_monitoring
boolshow_toolbar_recpunch
boolshow_toolbar_selclock
boolsound_midi_notes
std::stringstripable_color_palette
boolsuper_rapid_clock_update
inttime_axis_name_ellipsize_mode
floattimeline_item_gradient_depth
booltransients_follow_front
std::stringui_font_family
unsigned longwaveform_cache_size
doublewaveform_clip_level
floatwaveform_gradient_depth
--MISSING (ARDOUR::WaveformScale)--waveform_scale
--MISSING (ARDOUR::WaveformShape)--waveform_shape
ARDOUR.WaveformScalewaveform_scale
ARDOUR.WaveformShapewaveform_shape
boolwidget_prelight

 C:ByteArray

@@ -6784,28 +7184,34 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C - + - + + - + + + - + - + + - + - + + +
Methods
voidadd (double, double, bool, bool)

add automation events

when
absolute time in samples
value
parameter value
with_guards
if true, add guard-points
with_initial
if true, add an initial point if the list is empty

Add an event to this list.

This method is intended to write automation in realtime. If the transport is stopped, guard-points will be added regardless of parameter with_guards.

when
absolute time in samples
value
parameter value
with_guards
if true, add guard-points
with_initial
if true, add an initial point if the list is empty
voidclear (double, double)

remove all automation events between the given time range

start
start of range (inclusive) in audio samples
end
end of range (inclusive) in audio samples

Remove all events in the given time range from this list.

start
start of range (inclusive) in audio samples
end
end of range (inclusive) in audio samples
voidclear_list ()
booleditor_add (double, double, bool)

Add an event to this list.

This method is intended for making manual changes from the GUI. An event will only be created if no other event exists at the given time.

when
absolute time in samples
value
parameter value
with_guards
if true, add guard-points

Returns true if an event was added.

doubleeval (double)

query value at given time (takes a read-lock, not safe while writing automation)

where
absolute time in samples

Returns parameter value

Queries the event value at the given time (takes a read-lock, not safe while writing automation).

where
absolute time in samples

Returns parameter value

EventListevents ()

Returns the list of events

boolin_write_pass ()

Returns true if transport is running and this list is in write mode

InterpolationStyleinterpolation ()

query interpolation style of the automation data

Returns Interpolation Style

boolisnil ()
LuaTable(double, ...)rt_safe_eval (double, bool&)

realtime safe version of eval, may fail if read-lock cannot be taken

where
absolute time in samples
ok
boolean reference if returned value is valid

Returns parameter value

Realtime safe version of eval(). This may fail if a read-lock cannot be taken.

where
absolute time in samples
ok
boolean reference if returned value is valid

Returns parameter value

boolset_interpolation (InterpolationStyle)

set the interpolation style of the automation data.

This will fail when asking for Logarithmic scale and min,max crosses 0 or Exponential scale with min != 0.

is
interpolation style

Returns true if style change was successful

Sets the interpolation style of the automation data.

This will fail when asking for Logarithmic scale and min,max crosses 0 or Exponential scale with min != 0.

is
interpolation style

Returns true if style change was successful

unsigned longsize ()
voidthin (double)

Thin the number of events in this list.

The thinning factor corresponds to the area of a triangle computed between three points in the list (time-difference * value-difference). If the area is large, it indicates significant non-linearity between the points.

Time is measured in samples, value is usually normalized to 0..1.

During automation recording we thin the recorded points using this value. If a point is sufficiently co-linear with its neighbours (as defined by the area of the triangle formed by three of them), we will not include it in the list. The larger the value, the more points are excluded, so this effectively measures the amount of thinning to be done.

thinning_factor
area-size (default: 20)
voidtruncate_end (double)

truncate the event list after the given time

last_coordinate
last event to include

Remove all events after the given time from this list.

last_coordinate
time in audio samples of the last event to keep
voidtruncate_start (double)

truncate the event list to the given time

overall_length
overall length

Remove all events up to to the given time from this list.

overall_length
overall length in audio samples
Cast
AutomationListto_automationlist ()

 Evoral:ControlSet

C‡: boost::shared_ptr< Evoral::ControlSet >, boost::weak_ptr< Evoral::ControlSet >

@@ -6827,7 +7233,7 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C voidset_type (unsigned char) unsigned intsize () longtime () - unsigned chartype () + unsigned char_type ()

 Evoral:NotePtr

C‡: boost::shared_ptr< Evoral::Note<Temporal::Beats> >, boost::weak_ptr< Evoral::Note<Temporal::Beats> >

@@ -6852,7 +7258,7 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C Methods unsigned charchannel () unsigned intid () - unsigned inttype () + unsigned int_type ()

 Evoral:ParameterDescriptor

C‡: Evoral::ParameterDescriptor

@@ -7481,6 +7887,12 @@ Pointer Classes cannot be created in Lua scripts. It always requires a call to C
  • Evoral.InterpolationStyle.Linear
  • Evoral.InterpolationStyle.Curved
  • +

     Evoral.EventType

    +

     Vamp.Plugin.InputDomain

    +

     ARDOUR

    +

     ARDOUR.ChanMapping

     ARDOUR.PresentationInfo.Flag

    +

     ARDOUR.MonitorState

    +

     ARDOUR.NoteMode

    +

     ARDOUR.LoopFadeChoice

    +

     ARDOUR.DenormalModel

    -

     ARDOUR.ShuttleBehaviour

    +

     ARDOUR.ScreenSaverMode

    + +

     ARDOUR.ClockDeltaMode

    + +

     ARDOUR.WaveformScale

    + +

     ARDOUR.WaveformShape

    + +

     ARDOUR.MeterLineUp

    + +

     ARDOUR.InputMeterLayout

    + +

     ARDOUR.VUMeterStandard

     ARDOUR.ShuttleUnits

    - +
    -
    Ardour 6.0-pre1  -  Thu, 26 Mar 2020 17:53:58 +0100
    +
    Ardour 6.9  -  Fri, 13 Aug 2021 15:53:36 +0200