X-Git-Url: http://shamusworld.gotdns.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=include%2Fclass-reference.html;h=03b88eb4175bb3e4cc5375f9fbba5b8b9682a5c7;hb=2f90765c8261de810292efc26272543f994fc98f;hp=8b7a996c501a72d1af0fe51f064978c01f39651d;hpb=f56f05b33bf5b64f0ad3f47074d1759c96b65156;p=ardour-manual diff --git a/include/class-reference.html b/include/class-reference.html index 8b7a996..03b88eb 100644 --- a/include/class-reference.html +++ b/include/class-reference.html @@ -130,7 +130,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C Methods GainControlgain_control () boolisnil () - boolsameinstance (Amp)

Inherited from ARDOUR:Processor

@@ -139,6 +138,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C + @@ -149,10 +149,11 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C +
boolactive ()
voiddeactivate ()
std::stringdisplay_name ()
booldisplay_to_user ()
ChanCountinput_streams ()
ChanCountoutput_streams ()
Cast
PeakMeterto_meter ()
MonitorProcessorto_monitorprocessor ()
PeakMeterto_peakmeter ()
PluginInsertto_plugininsert ()
SideChainto_sidechain ()
UnknownProcessorto_unknownprocessor ()
-

Inherited from ARDOUR:SessionObject

+

Inherited from ARDOUR:SessionObjectPtr

@@ -188,7 +189,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C - @@ -225,7 +225,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C -
Methods
std::stringname ()
unsigned intoutput_channels ()
std::stringoutput_device_name ()
unsigned intperiod_size ()
boolsameinstance (AudioBackend)
floatsample_rate ()
intset_buffer_size (unsigned int)

Set the buffer size to be used.

The device is assumed to use a double buffering scheme, so that one buffer's worth of data can be processed by hardware while software works on the other buffer. All known suitable audio APIs support this model (though ALSA allows for alternate numbers of buffers, and CoreAudio doesn't directly expose the concept).

check buffer for silence

nframes
number of frames to check
n
first non zero sample (if any)

Returns true if all samples are zero

FloatArraydata (long)
voidread_from (FloatArray, long, long, long)
boolsameinstance (AudioBuffer)
voidsilence (long, long)

silence buffer

len
number of samples to clear
offset
start offset
@@ -277,7 +276,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C Methods boolisnil () longread (FloatArray, FloatArray, FloatArray, long, long, unsigned int) - boolsameinstance (AudioPlaylist)

Inherited from ARDOUR:Playlist

@@ -295,6 +293,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C + @@ -309,7 +308,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C - + @@ -317,7 +316,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C
gap
from the beginning of the region to the next beginning
end
the first frame that does _not_ contain a duplicated frame
Regionfind_next_region (long, RegionPoint, int)
longfind_next_region_boundary (long, int)
longfind_next_transient (long, int)
voidlower_region (Region)
voidlower_region_to_bottom (Region)
unsigned intn_regions ()
RegionListPtrregions_with_start_within (Range)
voidremove_region (Region)
voidsplit (long)
voidsplit_region (Region, MusicFrame)
voidsplit_region (Region, MusicFrame)
Regiontop_region_at (long)
Regiontop_unmuted_region_at (long)
voiduncombine (Region)
AudioPlaylistto_audioplaylist ()
MidiPlaylistto_midiplaylist ()
-

Inherited from ARDOUR:SessionObject

+

Inherited from ARDOUR:SessionObjectPtr

@@ -332,7 +331,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C
Methods
std::stringname ()
-
Methods
boolisnil ()
boolsameinstance (AudioPort)

Inherited from ARDOUR:Port

@@ -377,7 +375,9 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C + + @@ -396,7 +396,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C -
Constructor
ARDOUR.AudioRangeList ()
Methods
AudioRangeback ()
boolempty ()
AudioRangefront ()
LuaIteriter ()
voidreverse ()
unsigned longsize ()

Returns the maximum (linear) amplitude of the region, or a -ve number if the Progress object reports that the process was cancelled.

doublerms (Progress)

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

boolsameinstance (AudioRegion)
floatscale_amplitude ()
voidset_scale_amplitude (float)
@@ -408,11 +407,13 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C boolcan_move () boolcaptured () voidclear_sync_position () + Controlcontrol (Parameter, bool) boolcovers (long) voidcut_end (long, int) voidcut_front (long, int) DataTypedata_type () boolexternal () + boolhas_transients () boolhidden () boolimport () boolis_compound () @@ -456,6 +457,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C LuaTable(long, ...)sync_offset (int&) longsync_position ()

Returns Sync position in session time

+ Int64Listtransients () voidtrim_end (long, int) voidtrim_front (long, int) voidtrim_to (long, long, int) @@ -466,7 +468,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C MidiRegionto_midiregion () Readableto_readable () -

Inherited from ARDOUR:SessionObject

+

Inherited from ARDOUR:SessionObjectPtr

@@ -491,8 +493,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C - - @@ -512,9 +512,10 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C +
Methods
std::stringname ()
longread (FloatArray, long, long, int)
longreadable_length ()
longreadable_length ()
boolsameinstance (AudioSource)
boolsameinstance (AudioSource)
floatsample_rate ()
Cast
Readableto_readable ()
boolwritable ()
Cast
AudioSourceto_audiosource ()
FileSourceto_filesource ()
MidiSourceto_midisource ()
-

Inherited from ARDOUR:SessionObject

+

Inherited from ARDOUR:SessionObjectPtr

@@ -530,7 +531,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C
Methods
std::stringname ()
-
Methods
boolisnil ()
boolsameinstance (AudioTrack)

Inherited from ARDOUR:Track

@@ -574,7 +574,9 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C + + @@ -599,7 +601,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C - + @@ -608,9 +610,11 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C - + + + @@ -639,8 +643,9 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C +

************************************************************* Pure interface begins here*************************************************************

intremove_processor (Processor, ProcessorStreams, bool)

remove plugin/processor

proc
processor to remove
err
error report (index where removal vailed, channel-count why it failed) may be nil
need_process_lock
if locking is required (set to true, unless called from RT context with lock)

Returns 0 on success

intremove_processors (ProcessorList, ProcessorStreams)
boolremove_sidechain (Processor)
intreorder_processors (ProcessorList, ProcessorStreams)
intreplace_processor (Processor, Processor, ProcessorStreams)

replace plugin/processor with another

old
processor to remove
sub
processor to substitute the old one with
err
error report (index where removal vailed, channel-count why it failed) may be nil

Returns 0 on success

boolreset_plugin_insert (Processor)
AutomationControlcomp_makeup_control ()
AutomationControlcomp_mode_control ()
std::stringcomp_mode_name (unsigned int)
AutomationControlcomp_redux_control ()
--MISSING (boost::shared_ptr<ARDOUR::ReadOnlyControl>)--comp_redux_control ()
AutomationControlcomp_speed_control ()
std::stringcomp_speed_name (unsigned int)
AutomationControlcomp_threshold_control ()
AutomationControleq_enable_control ()
AutomationControleq_freq_control (unsigned int)
AutomationControleq_gain_control (unsigned int)
AutomationControleq_hpf_control ()
AutomationControleq_q_control (unsigned int)
AutomationControleq_shape_control (unsigned int)
AutomationControlfilter_enable_controllable (bool)
AutomationControlfilter_freq_controllable (bool)
AutomationControlfilter_slope_controllable (bool)
GainControlgain_control ()
boolis_auditioner ()
boolis_hidden ()
GainControltrim_control ()
Cast
Routeto_route ()
VCAto_vca ()
-

Inherited from ARDOUR:SessionObject

+

Inherited from ARDOUR:SessionObjectPtr

@@ -656,7 +661,9 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C + + @@ -672,7 +679,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C -
Methods
std::stringname ()
ARDOUR.AudioTrackList ()
Methods
LuaTableadd (LuaTable {AudioTrack})
AudioTrackback ()
boolempty ()
AudioTrackfront ()
LuaIteriter ()
voidpush_back (AudioTrack)
voidreverse ()
Methods
AutomationControlautomation_control (Parameter, bool)
boolisnil ()
boolsameinstance (Automatable)

 ARDOUR:AutomatableSequence

C‡: boost::shared_ptr< ARDOUR::AutomatableSequence<Evoral::Beats> >, boost::weak_ptr< ARDOUR::AutomatableSequence<Evoral::Beats> >

@@ -681,7 +687,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C -
Methods
boolisnil ()
boolsameinstance (AutomatableSequence)
Cast
Sequenceto_sequence ()
@@ -703,7 +708,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C doubleget_value ()

Get the current effective `user' value based on automation state

boolisnil () - boolsameinstance (AutomationControl) voidset_automation_state (AutoState) voidset_automation_style (AutoStyle) voidset_value (double, GroupControlDisposition) @@ -713,6 +717,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C boolwritable () Cast Controlto_ctrl () + SlavableAutomationControl,to_slavable ()

Inherited from PBD:Controllable

@@ -729,6 +734,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C

 ARDOUR:AutomationList

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

+

is-a: Evoral:ControlList

AutomationList is a stateful wrapper around Evoral::ControlList. It includes session-specifics (such as automation state), control logic (e.g. touch, signals) and acts as proxy to the underlying ControlList which holds the actual data.

@@ -736,7 +742,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C - @@ -745,6 +750,31 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C
XMLNodeget_state ()
boolisnil ()
Commandmemento_command (XMLNode, XMLNode)
boolsameinstance (AutomationList)
booltouch_enabled ()
booltouching ()
boolwriting ()
Statefulto_stateful ()
StatefulDestructibleto_statefuldestructible ()
+

Inherited from Evoral:ControlList

+ + + + + + + + + + + + + + + + + + + + + + + +
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
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
voidclear_list ()
doubleeval (double)

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

where
absolute time in samples

Returns parameter value

EventListevents ()
boolin_write_pass ()
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

voidset_interpolation (InterpolationStyle)

set the interpolation style of the automation data

is
interpolation style
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
voidtruncate_start (double)

truncate the event list to the given time

overall_length
overall length

 ARDOUR:BackendVector

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

@@ -752,14 +782,25 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C Constructor ℂARDOUR.BackendVector () Methods - LuaTableadd (ARDOUR::AudioBackendInfo* ) AudioBackendInfoat (unsigned long) boolempty () LuaIteriter () - voidpush_back (AudioBackendInfo) unsigned longsize () LuaTabletable () +

 ARDOUR:BeatsFramesConverter

+

C‡: ARDOUR::BeatsFramesConverter

+
+

Converter between quarter-note beats and frames. Takes distances in quarter-note beats or frames from some origin (supplied to the constructor in frames), and converts them to the opposite unit, taking tempo changes into account.

+ + + + + + + + +
Constructor
ARDOUR.BeatsFramesConverter (TempoMap, long)
Methods
Beatsfrom (long)

Convert B time to A time (A from B)

longto (Beats)

Convert A time to B time (A to B)

 ARDOUR:BufferSet

C‡: ARDOUR::BufferSet

@@ -769,7 +810,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C ChanCountcount () AudioBufferget_audio (unsigned long) MidiBufferget_midi (unsigned long) - boolsameinstance (BufferSet)

 ARDOUR:ChanCount

C‡: ARDOUR::ChanCount

@@ -810,6 +850,40 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C voidset (DataType, unsigned int, unsigned int)

set buffer mapping for given data type

from
numeric source id
to
buffer
type
data type
+

 ARDOUR:ControlList

+

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

+
+ + + + + + + + + + + + + + +
Constructor
ARDOUR.ControlList ()
Methods
LuaTableadd (LuaTable {AutomationControl})
AutomationControlback ()
boolempty ()
AutomationControlfront ()
LuaIteriter ()
voidpush_back (AutomationControl)
voidreverse ()
unsigned longsize ()
LuaTabletable ()
voidunique ()
+

 ARDOUR:ControlListPtr

+

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

+
+ + + + + + + + + + + + +
Constructor
ARDOUR.ControlListPtr ()
Methods
LuaTableadd (LuaTable {AutomationControl})
boolempty ()
LuaIteriter ()
voidpush_back (AutomationControl)
voidreverse ()
unsigned longsize ()
LuaTabletable ()
voidunique ()

 ARDOUR.DSP

@@ -933,7 +1007,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C -
Methods
boolisnil ()
PannerShellpanner_shell ()
boolsameinstance (Delivery)

Inherited from ARDOUR:IOProcessor

@@ -950,6 +1023,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C + @@ -960,10 +1034,11 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C +
boolactive ()
voiddeactivate ()
std::stringdisplay_name ()
booldisplay_to_user ()
ChanCountinput_streams ()
ChanCountoutput_streams ()
Cast
PeakMeterto_meter ()
MonitorProcessorto_monitorprocessor ()
PeakMeterto_peakmeter ()
PluginInsertto_plugininsert ()
SideChainto_sidechain ()
UnknownProcessorto_unknownprocessor ()
-

Inherited from ARDOUR:SessionObject

+

Inherited from ARDOUR:SessionObjectPtr

@@ -986,6 +1061,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C
Methods
std::stringname ()
+ @@ -995,6 +1071,77 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C
Constructor
ARDOUR.DeviceStatusVector ()
ARDOUR.DeviceStatusVector ()
Methods
LuaTableadd (LuaTable {DeviceStatus})
DeviceStatusat (unsigned long)
unsigned longsize ()
LuaTabletable ()
+

 ARDOUR:DoubleBeatsFramesConverter

+

C‡: ARDOUR::DoubleBeatsFramesConverter

+
+

Converter between quarter-note beats and frames. Takes distances in quarter-note beats or frames from some origin (supplied to the constructor in frames), and converts them to the opposite unit, taking tempo changes into account.

+ + + + + + + + +
Constructor
ARDOUR.DoubleBeatsFramesConverter (TempoMap, long)
Methods
doublefrom (long)

Convert B time to A time (A from B)

longto (double)

Convert A time to B time (A to B)

+

 ARDOUR:EventList

+

C‡: std::list<Evoral::ControlEvent* >

+
+ + + + + + + + + + + +
Constructor
ARDOUR.EventList ()
Methods
ControlEventback ()
boolempty ()
ControlEventfront ()
LuaIteriter ()
voidreverse ()
unsigned longsize ()
LuaTabletable ()
+

 ARDOUR:FileSource

+

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

+

is-a: ARDOUR:Source

+
+

A source associated with a file on disk somewhere

+ + + + + + + + + +
Methods
unsigned shortchannel ()
floatgain ()
boolisnil ()
std::stringorigin ()
std::stringpath ()
std::stringtake_id ()
boolwithin_session ()
+

Inherited from ARDOUR:Source

+ + + + + + + + + + + + + + + + + + +
Methods
std::stringancestor_name ()
boolcan_be_analysed ()
booldestructive ()
boolempty ()
boolhas_been_analysed ()
longlength (long)
longnatural_position ()
longtimeline_position ()
longtimestamp ()
intuse_count ()
boolused ()
boolwritable ()
Cast
AudioSourceto_audiosource ()
FileSourceto_filesource ()
MidiSourceto_midisource ()
+

Inherited from ARDOUR:SessionObjectPtr

+ + + + + + +
Methods
std::stringname ()
Cast
Statefulto_stateful ()
StatefulDestructibleto_statefuldestructible ()

 ARDOUR:FluidSynth

C‡: ARDOUR::FluidSynth

@@ -1019,7 +1166,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C -
Methods
boolisnil ()
boolsameinstance (GainControl)

Inherited from ARDOUR:SlavableAutomationControl,

@@ -1049,6 +1195,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C +
boolwritable ()
Cast
Controlto_ctrl ()
SlavableAutomationControl,to_slavable ()

Inherited from PBD:Controllable

@@ -1065,7 +1212,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C

 ARDOUR:IO

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

-

is-a: ARDOUR:SessionObject

+

is-a: ARDOUR:SessionObjectPtr

A collection of ports (all input or all output) with connections.

An IO can contain ports of varying types, making routes/inserts/etc with varied combinations of types (eg MIDI and audio) possible.

@@ -1085,9 +1232,8 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C -
boolphysically_connected ()
Portport_by_name (unsigned int)
intremove_port (Port, void*)
boolsameinstance (IO)
-

Inherited from ARDOUR:SessionObject

+

Inherited from ARDOUR:SessionObjectPtr

@@ -1107,7 +1253,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C -
Methods
std::stringname ()
ChanCountnatural_input_streams ()
ChanCountnatural_output_streams ()
IOoutput ()
boolsameinstance (IOProcessor)

Inherited from ARDOUR:Processor

@@ -1116,6 +1261,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C + @@ -1126,10 +1272,11 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C +
boolactive ()
voiddeactivate ()
std::stringdisplay_name ()
booldisplay_to_user ()
ChanCountinput_streams ()
ChanCountoutput_streams ()
Cast
PeakMeterto_meter ()
MonitorProcessorto_monitorprocessor ()
PeakMeterto_peakmeter ()
PluginInsertto_plugininsert ()
SideChainto_sidechain ()
UnknownProcessorto_unknownprocessor ()
-

Inherited from ARDOUR:SessionObject

+

Inherited from ARDOUR:SessionObjectPtr

@@ -1192,7 +1339,9 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C + + @@ -1231,12 +1380,16 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C + + + @@ -1245,6 +1398,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C + + + + + @@ -1401,7 +1558,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C - @@ -1418,7 +1574,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C -
Methods
std::stringname ()
Constructor
ARDOUR.LocationList ()
Methods
Locationback ()
boolempty ()
Locationfront ()
LuaIteriter ()
voidreverse ()
unsigned longsize ()
Methods
...build_filename (--lua--)

Creates a filename from a series of elements using the correct separator for filenames.

No attempt is made to force the resulting filename to be an absolute path. If the first element is a relative path, the result will be a relative path.

...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)

LuaTable(float, ...)get_plugin_insert_param (PluginInsert, unsigned int, bool&)

get a plugin control parameter value

which
control port to query (starting at 0, including ports of type input and output)
ok
boolean variable contains true or false after call returned. to be checked by caller before using value.
proc
Plugin-Insert

Returns value

LuaTable(float, ...)get_processor_param (Processor, unsigned int, bool&)

get a plugin control parameter value

proc
Plugin-Processor
which
control port to set (starting at 0, including ports of type input and output))
ok
boolean variable contains true or false after call returned. to be checked by caller before using value.

Returns value

...hsla_to_rgba (--lua--)

A convenience function for colorspace HSL to RGB conversion. All ranges are 0..1

Example:

 local r, g, b, a = ARDOUR.LuaAPI.hsla_to_rgba (hue, saturation, luminosity, alpha)

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

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)

NotePtrnew_noteptr (unsigned char, Beats, Beats, unsigned char, unsigned char)
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

Processornil_proc ()
NotePtrListnote_list (MidiModel)
...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 ()
@@ -1308,7 +1462,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C
 
- 
Methods
boolisnil ()
boolsameinstance (LuaProc)
DspShmshmem ()
LuaTableReftable ()
@@ -1327,7 +1480,11 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C
char*name ()
LuaTable(unsigned int, ...)nth_parameter (unsigned int, bool&)
unsigned intparameter_count ()
boolparameter_is_audio (unsigned int)
boolparameter_is_control (unsigned int)
boolparameter_is_input (unsigned int)
boolparameter_is_output (unsigned int)
std::stringparameter_label (unsigned int)
PresetRecordpreset_by_label (std::string)
PresetRecordpreset_by_uri (std::string)
std::stringunique_id ()
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.

boolsameinstance (MidiBuffer)
voidsilence (long, long)

Clear (eg zero, or empty) buffer

unsigned longsize ()
boolisnil ()
NoteDiffCommandnew_note_diff_command (std::string)

Start a new NoteDiff command.

This has no side-effects on the model or Session, the returned command can be held on to for as long as the caller wishes, or discarded without formality, until apply_command is called and ownership is taken.

boolsameinstance (MidiModel)

Inherited from ARDOUR:AutomatableSequence

@@ -1482,7 +1637,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C
-
Methods
boolisnil ()
boolsameinstance (MidiPlaylist)
voidset_note_mode (NoteMode)

Inherited from ARDOUR:Playlist

@@ -1501,6 +1655,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C
gap
from the beginning of the region to the next beginning
end
the first frame that does _not_ contain a duplicated frame
Regionfind_next_region (long, RegionPoint, int) longfind_next_region_boundary (long, int) + longfind_next_transient (long, int) voidlower_region (Region) voidlower_region_to_bottom (Region) unsigned intn_regions () @@ -1515,7 +1670,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C RegionListPtrregions_with_start_within (Range) voidremove_region (Region) voidsplit (long) - voidsplit_region (Region, MusicFrame) + voidsplit_region (Region, MusicFrame) Regiontop_region_at (long) Regiontop_unmuted_region_at (long) voiduncombine (Region) @@ -1523,7 +1678,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C AudioPlaylistto_audioplaylist () MidiPlaylistto_midiplaylist () -

Inherited from ARDOUR:SessionObject

+

Inherited from ARDOUR:SessionObjectPtr

@@ -1540,7 +1695,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C -
Methods
std::stringname ()
MidiBufferget_midi_buffer (unsigned int)
boolinput_active ()
boolisnil ()
boolsameinstance (MidiPort)
voidset_input_active (bool)

Inherited from ARDOUR:Port

@@ -1578,7 +1732,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C doublelength_beats () MidiSourcemidi_source (unsigned int) MidiModelmodel () - boolsameinstance (MidiRegion) doublestart_beats ()

Inherited from ARDOUR:Region

@@ -1589,11 +1742,13 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C boolcan_move () boolcaptured () voidclear_sync_position () + Controlcontrol (Parameter, bool) boolcovers (long) voidcut_end (long, int) voidcut_front (long, int) DataTypedata_type () boolexternal () + boolhas_transients () boolhidden () boolimport () boolis_compound () @@ -1637,6 +1792,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C LuaTable(long, ...)sync_offset (int&) longsync_position ()

Returns Sync position in session time

+ Int64Listtransients () voidtrim_end (long, int) voidtrim_front (long, int) voidtrim_to (long, long, int) @@ -1647,7 +1803,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C MidiRegionto_midiregion () Readableto_readable () -

Inherited from ARDOUR:SessionObject

+

Inherited from ARDOUR:SessionObjectPtr

@@ -1666,7 +1822,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C -
Methods
std::stringname ()
boolisnil ()
longlength (long)
MidiModelmodel ()
boolsameinstance (MidiSource)

Inherited from ARDOUR:Source

@@ -1683,9 +1838,10 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C +
boolwritable ()
Cast
AudioSourceto_audiosource ()
FileSourceto_filesource ()
MidiSourceto_midisource ()
-

Inherited from ARDOUR:SessionObject

+

Inherited from ARDOUR:SessionObjectPtr

@@ -1701,7 +1857,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C
Methods
std::stringname ()
-
Methods
boolisnil ()
boolsameinstance (MidiTrack)

Inherited from ARDOUR:Track

@@ -1745,7 +1900,9 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C + + @@ -1770,7 +1927,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C - + @@ -1779,9 +1936,11 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C - + + + @@ -1810,8 +1969,9 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C +

************************************************************* Pure interface begins here*************************************************************

intremove_processor (Processor, ProcessorStreams, bool)

remove plugin/processor

proc
processor to remove
err
error report (index where removal vailed, channel-count why it failed) may be nil
need_process_lock
if locking is required (set to true, unless called from RT context with lock)

Returns 0 on success

intremove_processors (ProcessorList, ProcessorStreams)
boolremove_sidechain (Processor)
intreorder_processors (ProcessorList, ProcessorStreams)
intreplace_processor (Processor, Processor, ProcessorStreams)

replace plugin/processor with another

old
processor to remove
sub
processor to substitute the old one with
err
error report (index where removal vailed, channel-count why it failed) may be nil

Returns 0 on success

boolreset_plugin_insert (Processor)
AutomationControlcomp_makeup_control ()
AutomationControlcomp_mode_control ()
std::stringcomp_mode_name (unsigned int)
AutomationControlcomp_redux_control ()
--MISSING (boost::shared_ptr<ARDOUR::ReadOnlyControl>)--comp_redux_control ()
AutomationControlcomp_speed_control ()
std::stringcomp_speed_name (unsigned int)
AutomationControlcomp_threshold_control ()
AutomationControleq_enable_control ()
AutomationControleq_freq_control (unsigned int)
AutomationControleq_gain_control (unsigned int)
AutomationControleq_hpf_control ()
AutomationControleq_q_control (unsigned int)
AutomationControleq_shape_control (unsigned int)
AutomationControlfilter_enable_controllable (bool)
AutomationControlfilter_freq_controllable (bool)
AutomationControlfilter_slope_controllable (bool)
GainControlgain_control ()
boolis_auditioner ()
boolis_hidden ()
GainControltrim_control ()
Cast
Routeto_route ()
VCAto_vca ()
-

Inherited from ARDOUR:SessionObject

+

Inherited from ARDOUR:SessionObjectPtr

@@ -1827,7 +1987,9 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C + + @@ -1859,7 +2021,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C - @@ -1878,6 +2039,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C + @@ -1888,10 +2050,11 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C +
Methods
std::stringname ()
ARDOUR.MidiTrackList ()
Methods
LuaTableadd (LuaTable {MidiTrack})
MidiTrackback ()
boolempty ()
MidiTrackfront ()
LuaIteriter ()
voidpush_back (MidiTrack)
voidreverse ()
boolmonitor_active ()
boolmono ()
Controllablemono_control ()
boolsameinstance (MonitorProcessor)
voidset_cut (unsigned int, bool)
voidset_cut_all (bool)
voidset_dim (unsigned int, bool)
boolactive ()
voiddeactivate ()
std::stringdisplay_name ()
booldisplay_to_user ()
ChanCountinput_streams ()
ChanCountoutput_streams ()
Cast
PeakMeterto_meter ()
MonitorProcessorto_monitorprocessor ()
PeakMeterto_peakmeter ()
PluginInsertto_plugininsert ()
SideChainto_sidechain ()
UnknownProcessorto_unknownprocessor ()
-

Inherited from ARDOUR:SessionObject

+

Inherited from ARDOUR:SessionObjectPtr

@@ -1921,7 +2084,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C -
Methods
std::stringname ()
boolisnil ()
boolmuted ()
boolmuted_by_self ()
boolsameinstance (MuteControl)

Inherited from ARDOUR:SlavableAutomationControl,

@@ -1951,6 +2113,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C +
boolwritable ()
Cast
Controlto_ctrl ()
SlavableAutomationControl,to_slavable ()

Inherited from PBD:Controllable

@@ -1965,25 +2128,42 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C
IDid ()
OwnedPropertyListproperties ()
+

 ARDOUR:NotePtrList

+

C‡: std::list<boost::shared_ptr<Evoral::Note<Evoral::Beats> > > >

+
+ + + + + + + + + + + + + + +
Constructor
ARDOUR.NotePtrList ()
Methods
LuaTableadd (LuaTable {Beats})
NotePtrback ()
boolempty ()
NotePtrfront ()
LuaIteriter ()
voidpush_back (NotePtr)
voidreverse ()
unsigned longsize ()
LuaTabletable ()
voidunique ()

 ARDOUR:OwnedPropertyList

C‡: PBD::OwnedPropertyList

is-a: ARDOUR:PropertyList

-

A variant of PropertyList that does not delete its property list in its destructor. Objects with their own Properties store them in an OwnedPropertyList to avoid having them deleted at the wrong time.

+

Persistent Property List

A variant of PropertyList that does not delete its property list in its destructor. Objects with their own Properties store them in an OwnedPropertyList to avoid having them deleted at the wrong time.

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

 ARDOUR:PannerShell

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

-

is-a: ARDOUR:SessionObject

+

is-a: ARDOUR:SessionObjectPtr

Class to manage panning by instantiating and controlling an appropriate Panner object for a given in/out configuration.

-
Methods
boolbypassed ()
boolisnil ()
boolsameinstance (PannerShell)
voidset_bypassed (bool)
-

Inherited from ARDOUR:SessionObject

+

Inherited from ARDOUR:SessionObjectPtr

@@ -2000,7 +2180,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C - + @@ -2029,7 +2209,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C -
Methods
std::stringname ()
Constructor
ARDOUR.ParameterDescriptor ()
Methods
std::stringmidi_note_name (unsigned char)
std::stringmidi_note_name (unsigned char, bool)
Data Members
std::stringlabel
boollogarithmic
boolisnil ()
floatmeter_level (unsigned int, MeterType)
voidreset_max ()
boolsameinstance (PeakMeter)
voidset_type (MeterType)

Inherited from ARDOUR:Processor

@@ -2039,6 +2218,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C boolactive () voiddeactivate () std::stringdisplay_name () + booldisplay_to_user () ChanCountinput_streams () ChanCountoutput_streams () Cast @@ -2049,10 +2229,11 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C PeakMeterto_meter () MonitorProcessorto_monitorprocessor () PeakMeterto_peakmeter () + PluginInsertto_plugininsert () SideChainto_sidechain () UnknownProcessorto_unknownprocessor () -

Inherited from ARDOUR:SessionObject

+

Inherited from ARDOUR:SessionObjectPtr

@@ -2069,7 +2250,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C -
Methods
std::stringname ()
Methods
boolinverted (unsigned int)
boolisnil ()
boolsameinstance (PhaseControl)
voidset_phase_invert (unsigned int, bool)
c
Audio channel index.
yn
true to invert phase, otherwise false.
@@ -2090,6 +2270,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C boolwritable () Cast Controlto_ctrl () + SlavableAutomationControl,to_slavable ()

Inherited from PBD:Controllable

@@ -2106,7 +2287,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C

 ARDOUR:Playlist

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

-

is-a: ARDOUR:SessionObject

+

is-a: ARDOUR:SessionObjectPtr

A named object associated with a Session. Objects derived from this class are expected to be destroyed before the session calls drop_references().

@@ -2124,6 +2305,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C + @@ -2138,9 +2320,8 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C - - + @@ -2148,7 +2329,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C
gap
from the beginning of the region to the next beginning
end
the first frame that does _not_ contain a duplicated frame
Regionfind_next_region (long, RegionPoint, int)
longfind_next_region_boundary (long, int)
longfind_next_transient (long, int)
boolisnil ()
voidlower_region (Region)
voidlower_region_to_bottom (Region)
RegionListPtrregions_with_end_within (Range)
RegionListPtrregions_with_start_within (Range)
voidremove_region (Region)
boolsameinstance (Playlist)
voidsplit (long)
voidsplit_region (Region, MusicFrame)
voidsplit_region (Region, MusicFrame)
Regiontop_region_at (long)
Regiontop_unmuted_region_at (long)
voiduncombine (Region)
AudioPlaylistto_audioplaylist ()
MidiPlaylistto_midiplaylist ()
-

Inherited from ARDOUR:SessionObject

+

Inherited from ARDOUR:SessionObjectPtr

@@ -2176,10 +2357,13 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C + + + + - @@ -2210,7 +2394,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C
Methods
std::stringname ()
char*name ()
LuaTable(unsigned int, ...)nth_parameter (unsigned int, bool&)
unsigned intparameter_count ()
boolparameter_is_audio (unsigned int)
boolparameter_is_control (unsigned int)
boolparameter_is_input (unsigned int)
boolparameter_is_output (unsigned int)
std::stringparameter_label (unsigned int)
PresetRecordpreset_by_label (std::string)
PresetRecordpreset_by_uri (std::string)
boolsameinstance (Plugin)
std::stringunique_id ()
Cast
LuaProcto_luaproc ()
-
Methods
boolisnil ()
boolsameinstance (PluginControl)

Inherited from ARDOUR:AutomationControl

@@ -2229,6 +2412,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C +
boolwritable ()
Cast
Controlto_ctrl ()
SlavableAutomationControl,to_slavable ()

Inherited from PBD:Controllable

@@ -2253,7 +2437,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C - @@ -2280,7 +2463,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C - @@ -2290,6 +2472,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C + @@ -2300,10 +2483,11 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C +
PresetVectorget_presets (bool)
boolis_instrument ()
boolisnil ()
boolsameinstance (PluginInfo)
Data Members
std::stringcategory
std::stringcreator
ChanMappingoutput_map (unsigned int)
Pluginplugin (unsigned int)
boolreset_parameters_to_default ()
boolsameinstance (PluginInsert)
voidset_input_map (unsigned int, ChanMapping)
voidset_output_map (unsigned int, ChanMapping)
boolstrict_io_configured ()
Methods
boolactive ()
std::stringdisplay_name ()
booldisplay_to_user ()
ChanCountinput_streams ()
ChanCountoutput_streams ()
Cast
PeakMeterto_meter ()
MonitorProcessorto_monitorprocessor ()
PeakMeterto_peakmeter ()
PluginInsertto_plugininsert ()
SideChainto_sidechain ()
UnknownProcessorto_unknownprocessor ()
-

Inherited from ARDOUR:SessionObject

+

Inherited from ARDOUR:SessionObjectPtr

@@ -2330,7 +2514,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C - @@ -2349,7 +2532,9 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C + + @@ -2394,7 +2579,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C -
Methods
std::stringname ()

Returns Port human readable name

boolreceives_input ()

Returns true if this Port receives input, otherwise false

boolsameinstance (Port)
boolsends_output ()

Returns true if this Port sends output, otherwise false

Cast
Constructor
ARDOUR.PortList ()
Methods
Portback ()
boolempty ()
Portfront ()
LuaIteriter ()
voidreverse ()
unsigned longsize ()
Portport (DataType, unsigned long)

nth port of type t, or nth port if t = NIL

t
data type
index
port index
boolremove (Port)
boolsameinstance (PortSet)

 ARDOUR:PresentationInfo

C‡: ARDOUR::PresentationInfo

@@ -2433,6 +2617,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C + @@ -2444,7 +2629,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C
Constructor
ARDOUR.PresetVector ()
ARDOUR.PresetVector ()
Methods
LuaTableadd (LuaTable {PresetRecord})
PresetRecordat (unsigned long)

 ARDOUR:Processor

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

-

is-a: ARDOUR:SessionObject

+

is-a: ARDOUR:SessionObjectPtr

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

@@ -2453,10 +2638,10 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C + - @@ -2465,10 +2650,11 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C +
boolactive ()
voiddeactivate ()
std::stringdisplay_name ()
booldisplay_to_user ()
ChanCountinput_streams ()
boolisnil ()
ChanCountoutput_streams ()
boolsameinstance (Processor)
Cast
Ampto_amp ()
Automatableto_automatable ()
PeakMeterto_meter ()
MonitorProcessorto_monitorprocessor ()
PeakMeterto_peakmeter ()
PluginInsertto_plugininsert ()
SideChainto_sidechain ()
UnknownProcessorto_unknownprocessor ()
-

Inherited from ARDOUR:SessionObject

+

Inherited from ARDOUR:SessionObjectPtr

@@ -2476,12 +2662,31 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C
Methods
std::stringname ()
Statefulto_stateful ()
StatefulDestructibleto_statefuldestructible ()
+

 ARDOUR:ProcessorList

+

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

+
+ + + + + + + + + + + + + + +
Constructor
ARDOUR.ProcessorList ()
Methods
LuaTableadd (LuaTable {Processor})
Processorback ()
boolempty ()
Processorfront ()
LuaIteriter ()
voidpush_back (Processor)
voidreverse ()
unsigned longsize ()
LuaTabletable ()
voidunique ()

 ARDOUR:ProcessorVector

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

+ @@ -2532,11 +2737,10 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C -
Constructor
ARDOUR.ProcessorVector ()
ARDOUR.ProcessorVector ()
Methods
LuaTableadd (LuaTable {Processor})
Processorat (unsigned long)
unsigned intn_channels ()
longread (FloatArray, long, long, int)
longreadable_length ()
boolsameinstance (Readable)

 ARDOUR:Region

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

-

is-a: ARDOUR:SessionObject

+

is-a: ARDOUR:SessionObjectPtr

A named object associated with a Session. Objects derived from this class are expected to be destroyed before the session calls drop_references().

@@ -2546,11 +2750,13 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C + + @@ -2574,7 +2780,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C - @@ -2596,6 +2801,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C + @@ -2606,7 +2812,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C
boolcan_move ()
boolcaptured ()
voidclear_sync_position ()
Controlcontrol (Parameter, bool)
boolcovers (long)
voidcut_end (long, int)
voidcut_front (long, int)
DataTypedata_type ()
boolexternal ()
boolhas_transients ()
boolhidden ()
boolimport ()
boolis_compound ()
doublequarter_note ()
voidraise ()
voidraise_to_top ()
boolsameinstance (Region)
voidset_hidden (bool)
voidset_initial_position (long)

A gui may need to create a region, then place it in an initial position determined by the user. When this takes place within one gui operation, we have to reset _last_position to prevent an implied move.

LuaTable(long, ...)sync_offset (int&)
longsync_position ()

Returns Sync position in session time

Int64Listtransients ()
voidtrim_end (long, int)
voidtrim_front (long, int)
voidtrim_to (long, long, int)
MidiRegionto_midiregion ()
Readableto_readable ()
-

Inherited from ARDOUR:SessionObject

+

Inherited from ARDOUR:SessionObjectPtr

@@ -2628,7 +2834,9 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C + + @@ -2681,12 +2889,13 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C + + - @@ -2708,7 +2917,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C - + @@ -2717,9 +2926,11 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C - + + + @@ -2748,8 +2959,9 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C +
Methods
std::stringname ()
Constructor
ARDOUR.RegionList ()
Methods
Regionback ()
boolempty ()
Regionfront ()
LuaIteriter ()
voidreverse ()
unsigned longsize ()

************************************************************* Pure interface begins here*************************************************************

intremove_processor (Processor, ProcessorStreams, bool)

remove plugin/processor

proc
processor to remove
err
error report (index where removal vailed, channel-count why it failed) may be nil
need_process_lock
if locking is required (set to true, unless called from RT context with lock)

Returns 0 on success

intremove_processors (ProcessorList, ProcessorStreams)
boolremove_sidechain (Processor)
intreorder_processors (ProcessorList, ProcessorStreams)
intreplace_processor (Processor, Processor, ProcessorStreams)

replace plugin/processor with another

old
processor to remove
sub
processor to substitute the old one with
err
error report (index where removal vailed, channel-count why it failed) may be nil

Returns 0 on success

boolreset_plugin_insert (Processor)

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

boolsameinstance (Route)
voidset_active (bool, void*)
voidset_comment (std::string, void*)
voidset_meter_point (MeterPoint, bool)
AutomationControlcomp_makeup_control ()
AutomationControlcomp_mode_control ()
std::stringcomp_mode_name (unsigned int)
AutomationControlcomp_redux_control ()
--MISSING (boost::shared_ptr<ARDOUR::ReadOnlyControl>)--comp_redux_control ()
AutomationControlcomp_speed_control ()
std::stringcomp_speed_name (unsigned int)
AutomationControlcomp_threshold_control ()
AutomationControleq_enable_control ()
AutomationControleq_freq_control (unsigned int)
AutomationControleq_gain_control (unsigned int)
AutomationControleq_hpf_control ()
AutomationControleq_q_control (unsigned int)
AutomationControleq_shape_control (unsigned int)
AutomationControlfilter_enable_controllable (bool)
AutomationControlfilter_freq_controllable (bool)
AutomationControlfilter_slope_controllable (bool)
GainControlgain_control ()
boolis_auditioner ()
boolis_hidden ()
GainControltrim_control ()
Cast
Routeto_route ()
VCAto_vca ()
-

Inherited from ARDOUR:SessionObject

+

Inherited from ARDOUR:SessionObjectPtr

@@ -2767,6 +2979,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C
Methods
std::stringname ()

 ARDOUR:RouteGroup

C‡: ARDOUR::RouteGroup

+

is-a: ARDOUR:SessionObject

A group identifier for routes.

RouteGroups permit to define properties which are shared among all Routes that use the given identifier.

A route can at most be in one group.

@@ -2791,6 +3004,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C + @@ -2800,11 +3014,20 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C + +
boolis_solo ()
voidmake_subgroup (bool, Placement)
intremove (Route)
unsigned intrgba ()
RouteListPtrroute_list ()
voidset_active (bool, void*)
voidset_color (bool)
voidset_mute (bool)
voidset_recenable (bool)
voidset_relative (bool, void*)
voidset_rgba (unsigned int)

set route-group color and notify UI about change

voidset_route_active (bool)
voidset_select (bool)
voidset_solo (bool)
unsigned longsize ()
+

Inherited from ARDOUR:SessionObject

+ + + + + +
Methods
std::stringname ()
Cast
Statefulto_stateful ()

 ARDOUR:RouteGroupList

C‡: std::list<ARDOUR::RouteGroup* >

@@ -2812,7 +3035,9 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C Constructor ℂARDOUR.RouteGroupList () Methods + RouteGroupback () boolempty () + RouteGroupfront () LuaIteriter () voidreverse () unsigned longsize () @@ -2825,7 +3050,9 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C Constructor ℂARDOUR.RouteList () Methods + Routeback () boolempty () + Routefront () LuaIteriter () voidreverse () unsigned longsize () @@ -2857,17 +3084,21 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C

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

boolactively_recording () voidadd_command (Command) + voidadd_internal_sends (Route, Placement, RouteListPtr) 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
+ voidcancel_all_solo () SessionConfigurationcfg () + voidclear_all_solo_state (RouteListPtr) 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_end_frame () longcurrent_start_frame () voiddisable_record (bool, bool) + boolend_is_free () AudioEngineengine () boolexport_track_state (RouteListPtr, std::string) longframe_rate () @@ -2883,6 +3114,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C voidgoto_end () voidgoto_start (bool) longlast_transport_start () + boollistening () Locationslocations () Routemaster_out () voidmaybe_enable_record (bool) @@ -2913,8 +3145,14 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C intsave_state (std::string, bool, bool, bool)

save session

snapshot_name
name of the session (use an empty string for the current name)
pending
save a 'recovery', not full state (default: false)
switch_to_snapshot
switch to given snapshot after saving (default: false)
template_only
save a session template (default: false)

Returns zero on success

voidscripts_changed () + voidset_control (AutomationControl, double, GroupControlDisposition) + voidset_controls (ControlListPtr, double, GroupControlDisposition) voidset_dirty () + voidset_end_is_free (bool) + voidset_exclusive_input_active (RouteListPtr, bool, bool) std::stringsnap_name () + boolsolo_isolated () + boolsoloing () Sourcesource_by_id (ID) TempoMaptempo_map () booltimecode_drop_frames () @@ -2926,6 +3164,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C booltransport_rolling () doubletransport_speed () StringListunknown_processors () + VCAManagervca_manager () longworst_input_latency () longworst_output_latency () longworst_playback_latency () @@ -3104,7 +3343,17 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C IDid () OwnedPropertyListproperties () -

 ARDOUR:SessionObject

+

 ARDOUR:SessionObject

+

C‡: ARDOUR::SessionObject

+
+

A named object associated with a Session. Objects derived from this class are expected to be destroyed before the session calls drop_references().

+ + + + + +
Methods
std::stringname ()
Cast
Statefulto_stateful ()
+

 ARDOUR:SessionObjectPtr

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

A named object associated with a Session. Objects derived from this class are expected to be destroyed before the session calls drop_references().

@@ -3112,7 +3361,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C Methods boolisnil () std::stringname () - boolsameinstance (SessionObject) Cast Statefulto_stateful () StatefulDestructibleto_statefuldestructible () @@ -3125,7 +3373,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C -
Methods
boolisnil ()
boolsameinstance (SideChain)

Inherited from ARDOUR:IOProcessor

@@ -3142,6 +3389,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C + @@ -3152,10 +3400,11 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C +
boolactive ()
voiddeactivate ()
std::stringdisplay_name ()
booldisplay_to_user ()
ChanCountinput_streams ()
ChanCountoutput_streams ()
Cast
PeakMeterto_meter ()
MonitorProcessorto_monitorprocessor ()
PeakMeterto_peakmeter ()
PluginInsertto_plugininsert ()
SideChainto_sidechain ()
UnknownProcessorto_unknownprocessor ()
-

Inherited from ARDOUR:SessionObject

+

Inherited from ARDOUR:SessionObjectPtr

@@ -3176,7 +3425,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C -
Methods
std::stringname ()
doubleget_masters_value ()
boolisnil ()
voidremove_master (AutomationControl)
boolsameinstance (SlavableAutomationControl,)
boolslaved ()
boolslaved_to (AutomationControl)
@@ -3197,6 +3445,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C boolwritable () Cast Controlto_ctrl () + SlavableAutomationControl,to_slavable ()

Inherited from PBD:Controllable

@@ -3220,7 +3469,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C -
Methods
boolcan_solo ()
boolisnil ()
boolsameinstance (SoloControl)
boolself_soloed ()
boolsoloed ()
@@ -3252,6 +3500,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C boolwritable () Cast Controlto_ctrl () + SlavableAutomationControl,to_slavable ()

Inherited from PBD:Controllable

@@ -3274,7 +3523,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C
-
Methods
boolisnil ()
boolsameinstance (SoloIsolateControl)
boolself_solo_isolated ()
boolsolo_isolated ()
@@ -3306,6 +3554,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C boolwritable () Cast Controlto_ctrl () + SlavableAutomationControl,to_slavable ()

Inherited from PBD:Controllable

@@ -3328,7 +3577,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C
-
Methods
boolisnil ()
boolsameinstance (SoloSafeControl)
boolsolo_safe ()

Inherited from ARDOUR:SlavableAutomationControl,

@@ -3359,6 +3607,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C boolwritable () Cast Controlto_ctrl () + SlavableAutomationControl,to_slavable ()

Inherited from PBD:Controllable

@@ -3375,7 +3624,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C

 ARDOUR:Source

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

-

is-a: ARDOUR:SessionObject

+

is-a: ARDOUR:SessionObjectPtr

A named object associated with a Session. Objects derived from this class are expected to be destroyed before the session calls drop_references().

@@ -3388,7 +3637,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C - @@ -3396,9 +3644,10 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C +
boolisnil ()
longlength (long)
longnatural_position ()
boolsameinstance (Source)
longtimeline_position ()
longtimestamp ()
intuse_count ()
boolwritable ()
Cast
AudioSourceto_audiosource ()
FileSourceto_filesource ()
MidiSourceto_midisource ()
-

Inherited from ARDOUR:SessionObject

+

Inherited from ARDOUR:SessionObjectPtr

@@ -3412,6 +3661,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C
Methods
std::stringname ()
+ @@ -3423,7 +3673,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C
Constructor
ARDOUR.SourceList ()
ARDOUR.SourceList ()
Methods
LuaTableadd (LuaTable {Source})
Sourceat (unsigned long)

 ARDOUR:Stripable

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

-

is-a: ARDOUR:SessionObject

+

is-a: ARDOUR:SessionObjectPtr

A named object associated with a Session. Objects derived from this class are expected to be destroyed before the session calls drop_references().

@@ -3432,7 +3682,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C - + @@ -3441,9 +3691,11 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C - + + + @@ -3463,7 +3715,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C - @@ -3474,8 +3725,9 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C +
AutomationControlcomp_makeup_control ()
AutomationControlcomp_mode_control ()
std::stringcomp_mode_name (unsigned int)
AutomationControlcomp_redux_control ()
--MISSING (boost::shared_ptr<ARDOUR::ReadOnlyControl>)--comp_redux_control ()
AutomationControlcomp_speed_control ()
std::stringcomp_speed_name (unsigned int)
AutomationControlcomp_threshold_control ()
AutomationControleq_enable_control ()
AutomationControleq_freq_control (unsigned int)
AutomationControleq_gain_control (unsigned int)
AutomationControleq_hpf_control ()
AutomationControleq_q_control (unsigned int)
AutomationControleq_shape_control (unsigned int)
AutomationControlfilter_enable_controllable (bool)
AutomationControlfilter_freq_controllable (bool)
AutomationControlfilter_slope_controllable (bool)
GainControlgain_control ()
boolis_auditioner ()
boolis_hidden ()
PresentationInfopresentation_info_ptr ()
AutomationControlrec_enable_control ()
AutomationControlrec_safe_control ()
boolsameinstance (Stripable)
AutomationControlsend_enable_control (unsigned int)
AutomationControlsend_level_control (unsigned int)
std::stringsend_name (unsigned int)
GainControltrim_control ()
Cast
Routeto_route ()
VCAto_vca ()
-

Inherited from ARDOUR:SessionObject

+

Inherited from ARDOUR:SessionObjectPtr

@@ -3483,14 +3735,28 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C
Methods
std::stringname ()
Statefulto_stateful ()
StatefulDestructibleto_statefuldestructible ()
+

 ARDOUR:StripableList

+

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

+
+ + + + + + + + + + + +
Constructor
ARDOUR.StripableList ()
Methods
Stripableback ()
boolempty ()
Stripablefront ()
LuaIteriter ()
voidreverse ()
unsigned longsize ()
LuaTabletable ()

 ARDOUR:Tempo

C‡: ARDOUR::Tempo

Tempo, the speed at which musical time progresses (BPM).

- - + @@ -3507,11 +3773,15 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C
Constructor
ARDOUR.Tempo (double, double)
npm
Note Types per minute
type
Note Type (default `4': quarter note)
ARDOUR.Tempo (double, double, double)
Methods
doubleframes_per_note_type (long)

audio samples per note type. if you want an instantaneous value for this, use TempoMap::frames_per_quarter_note_at() instead.

sr
samplerate
- + + + + + @@ -3548,7 +3818,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C - @@ -3580,7 +3849,9 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C + + @@ -3605,7 +3876,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C - + @@ -3614,9 +3885,11 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C - + + + @@ -3645,8 +3918,9 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C +
Methods
MeterSectionadd_meter (Meter, double, BBT_TIME, long, PositionLockStyle)
TempoSectionadd_tempo (Tempo, double, long, Type, PositionLockStyle)
TempoSectionadd_tempo (Tempo, double, long, PositionLockStyle)
BBT_TIMEbbt_at_frame (long)

Returns the BBT time corresponding to the supplied frame position.

frame
the position in audio samples.

Returns the BBT time at the frame position .

doubleexact_beat_at_frame (long, int)
doubleexact_qn_at_frame (long, int)
longframepos_plus_qn (long, Beats)

Add some (fractional) Beats to a session frame position, and return the result in frames. pos can be -ve, if required.

Beatsframewalk_to_qn (long, long)

Count the number of beats that are equivalent to distance when going forward, starting at pos.

MeterSectionmeter_section_at_beat (double)
MeterSectionmeter_section_at_frame (long)
TempoSectiontempo_section_at_frame (long)
boolcan_record ()
boolisnil ()
Playlistplaylist ()
boolsameinstance (Track)
boolset_name (std::string)
Cast
AudioTrackto_audio_track ()

************************************************************* Pure interface begins here*************************************************************

intremove_processor (Processor, ProcessorStreams, bool)

remove plugin/processor

proc
processor to remove
err
error report (index where removal vailed, channel-count why it failed) may be nil
need_process_lock
if locking is required (set to true, unless called from RT context with lock)

Returns 0 on success

intremove_processors (ProcessorList, ProcessorStreams)
boolremove_sidechain (Processor)
intreorder_processors (ProcessorList, ProcessorStreams)
intreplace_processor (Processor, Processor, ProcessorStreams)

replace plugin/processor with another

old
processor to remove
sub
processor to substitute the old one with
err
error report (index where removal vailed, channel-count why it failed) may be nil

Returns 0 on success

boolreset_plugin_insert (Processor)
AutomationControlcomp_makeup_control ()
AutomationControlcomp_mode_control ()
std::stringcomp_mode_name (unsigned int)
AutomationControlcomp_redux_control ()
--MISSING (boost::shared_ptr<ARDOUR::ReadOnlyControl>)--comp_redux_control ()
AutomationControlcomp_speed_control ()
std::stringcomp_speed_name (unsigned int)
AutomationControlcomp_threshold_control ()
AutomationControleq_enable_control ()
AutomationControleq_freq_control (unsigned int)
AutomationControleq_gain_control (unsigned int)
AutomationControleq_hpf_control ()
AutomationControleq_q_control (unsigned int)
AutomationControleq_shape_control (unsigned int)
AutomationControlfilter_enable_controllable (bool)
AutomationControlfilter_freq_controllable (bool)
AutomationControlfilter_slope_controllable (bool)
GainControlgain_control ()
boolis_auditioner ()
boolis_hidden ()
GainControltrim_control ()
Cast
Routeto_route ()
VCAto_vca ()
-

Inherited from ARDOUR:SessionObject

+

Inherited from ARDOUR:SessionObjectPtr

@@ -3662,7 +3936,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C
Methods
std::stringname ()
-
Methods
boolisnil ()
boolsameinstance (UnknownProcessor)

Inherited from ARDOUR:Processor

@@ -3671,6 +3944,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C + @@ -3681,10 +3955,11 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C +
boolactive ()
voiddeactivate ()
std::stringdisplay_name ()
booldisplay_to_user ()
ChanCountinput_streams ()
ChanCountoutput_streams ()
Cast
PeakMeterto_meter ()
MonitorProcessorto_monitorprocessor ()
PeakMeterto_peakmeter ()
PluginInsertto_plugininsert ()
SideChainto_sidechain ()
UnknownProcessorto_unknownprocessor ()
-

Inherited from ARDOUR:SessionObject

+

Inherited from ARDOUR:SessionObjectPtr

@@ -3692,6 +3967,109 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C
Methods
std::stringname ()
Statefulto_stateful ()
StatefulDestructibleto_statefuldestructible ()
+

 ARDOUR:VCA

+

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

+

is-a: ARDOUR:Stripable

+
+

A named object associated with a Session. Objects derived from this class are expected to be destroyed before the session calls drop_references().

+ + + + + + + + +
Methods
std::stringfull_name ()
GainControlgain_control ()
boolisnil ()
MuteControlmute_control ()
intnumber ()
SoloControlsolo_control ()
+

Inherited from ARDOUR:Stripable

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Methods
AutomationControlcomp_enable_control ()
AutomationControlcomp_makeup_control ()
AutomationControlcomp_mode_control ()
std::stringcomp_mode_name (unsigned int)
--MISSING (boost::shared_ptr<ARDOUR::ReadOnlyControl>)--comp_redux_control ()
AutomationControlcomp_speed_control ()
std::stringcomp_speed_name (unsigned int)
AutomationControlcomp_threshold_control ()
unsigned inteq_band_cnt ()
std::stringeq_band_name (unsigned int)
AutomationControleq_enable_control ()
AutomationControleq_freq_control (unsigned int)
AutomationControleq_gain_control (unsigned int)
AutomationControleq_q_control (unsigned int)
AutomationControleq_shape_control (unsigned int)
AutomationControlfilter_enable_controllable (bool)
AutomationControlfilter_freq_controllable (bool)
AutomationControlfilter_slope_controllable (bool)
boolis_auditioner ()
boolis_hidden ()
boolis_master ()
boolis_monitor ()
boolis_selected ()
AutomationControlmaster_send_enable_control ()
MonitorProcessormonitor_control ()
AutomationControlpan_azimuth_control ()
AutomationControlpan_elevation_control ()
AutomationControlpan_frontback_control ()
AutomationControlpan_lfe_control ()
AutomationControlpan_width_control ()
PhaseControlphase_control ()
PresentationInfopresentation_info_ptr ()
AutomationControlrec_enable_control ()
AutomationControlrec_safe_control ()
AutomationControlsend_enable_control (unsigned int)
AutomationControlsend_level_control (unsigned int)
std::stringsend_name (unsigned int)
voidset_presentation_order (unsigned int)
SoloIsolateControlsolo_isolate_control ()
SoloSafeControlsolo_safe_control ()
GainControltrim_control ()
Cast
Routeto_route ()
VCAto_vca ()
+

Inherited from ARDOUR:SessionObjectPtr

+ + + + + + +
Methods
std::stringname ()
Cast
Statefulto_stateful ()
StatefulDestructibleto_statefuldestructible ()
+

 ARDOUR:VCAList

+

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

+
+ + + + + + + + + + + +
Constructor
ARDOUR.VCAList ()
Methods
VCAback ()
boolempty ()
VCAfront ()
LuaIteriter ()
voidreverse ()
unsigned longsize ()
LuaTabletable ()
+

 ARDOUR:VCAManager

+

C‡: ARDOUR::VCAManager

+

is-a: PBD:StatefulDestructible

+
+

Base class for objects with saveable and undoable state with destruction notification

+ + + + +
Methods
VCAvca_by_number (int)
VCAListvcas ()
+

Inherited from PBD:Stateful

+ + + + + + +
Methods
voidclear_changes ()

Forget about any changes to this object's properties

IDid ()
OwnedPropertyListproperties ()

 ARDOUR:WeakAudioSourceList

C‡: std::list<boost::weak_ptr<ARDOUR::AudioSource> >

@@ -3699,7 +4077,9 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C Constructor ℂARDOUR.WeakAudioSourceList () Methods + AudioSourceback () boolempty () + AudioSourcefront () LuaIteriter () voidreverse () unsigned longsize () @@ -3712,7 +4092,9 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C Constructor ℂARDOUR.WeakRouteList () Methods + Routeback () boolempty () + Routefront () LuaIteriter () voidreverse () unsigned longsize () @@ -3725,7 +4107,9 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C Constructor ℂARDOUR.WeakSourceList () Methods + Sourceback () boolempty () + Sourcefront () LuaIteriter () voidreverse () unsigned longsize () @@ -3756,7 +4140,9 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C ℂArdourUI.ArdourMarkerList () Methods LuaTableadd (ArdourMarker* ) + ArdourMarkerback () boolempty () + ArdourMarkerfront () LuaIteriter () voidpush_back (ArdourMarker) voidreverse () @@ -3764,6 +4150,11 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C LuaTabletable () voidunique () +

 ArdourUI:AxisView

+

C‡: AxisView

+
+

AxisView defines the abstract base class for horizontal and vertical presentations of Stripables.

+

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

 ArdourUI:Editor

C‡: PublicEditor

@@ -3772,9 +4163,13 @@ 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 () + TrackViewListaxis_views_from_routes (RouteListPtr) voidcenter_screen (long) + 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
will start.
r
Region to consider.
r,
the audition will be cancelled. Otherwise an audition of
+ voidcopy_playlists (TimeAxisView) MouseModecurrent_mouse_mode ()

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

longcurrent_page_samples () @@ -3802,17 +4197,21 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C LuaTable(long, ...)get_nudge_distance (long, long&) longget_paste_offset (long, unsigned int, long) LuaTable(...)get_pointer_position (double&, double&) + RouteTimeAxisViewget_route_view_by_route_id (ID) Selectionget_selection () LuaTable(bool, ...)get_selection_extents (long&, long&) boolget_smart_mode () + TrackViewListget_track_views () intget_videotl_bar_height () doubleget_y_origin () ZoomFocusget_zoom_focus () voidgoto_nth_marker (int) + voidhide_track_in_display (TimeAxisView, bool) longleftmost_sample () voidmaximise_editing_space () voidmaybe_locate_with_edit_preroll (long) voidmouse_add_new_marker (long, bool) + voidnew_playlists (TimeAxisView) voidnew_region_from_selection () voidoverride_visible_track_count () longpixel_to_sample (double) @@ -3820,6 +4219,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C voidplay_with_preroll () voidredo (unsigned int)

Redo some transactions.

n
Number of transaction to redo.
+ RegionViewregionview_from_region (Region) voidremove_last_capture () voidremove_location_at_playhead_cursor () voidremove_tracks () @@ -3827,6 +4227,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C voidreset_y_origin (double) voidreset_zoom (long) voidrestore_editing_space () + RouteTimeAxisViewrtav_from_route (Route) doublesample_to_pixel (long) boolscroll_down_one_track (bool) voidscroll_tracks_down_line () @@ -3840,6 +4241,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C voidset_mouse_mode (MouseMode, bool)

Set the mouse mode (gain, object, range, timefx etc.)

m
Mouse mode (defined in editing_syms.h)
force
Perform the effects of the change even if no change is required (ie even if the current mouse mode is equal to
voidset_punch_range (long, long, std::string) + voidset_selection (SelectionList, Operation) voidset_show_measures (bool) voidset_snap_mode (SnapMode)

Set the snap mode.

m
Snap mode (defined in editing_syms.h)
@@ -3849,6 +4251,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C voidset_video_timeline_height (int) voidset_zoom_focus (ZoomFocus) boolshow_measures () + voidshow_track_in_display (TimeAxisView, bool) SnapModesnap_mode () SnapTypesnap_type () boolstationary_playhead () @@ -3873,7 +4276,9 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C ℂArdourUI.ArdourMarkerList () Methods LuaTableadd (ArdourMarker* ) + ArdourMarkerback () boolempty () + ArdourMarkerfront () LuaIteriter () voidpush_back (ArdourMarker) voidreverse () @@ -3887,13 +4292,37 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C

Class to represent list of selected regions.

- -
Methods
voidclear_all ()

Empty this RegionSelection.

longend_frame ()
unsigned longn_midi_regions ()
RegionListregionlist ()
longstart ()
+

 ArdourUI:RegionView

+

C‡: RegionView

+

is-a: ArdourUI:TimeAxisViewItem

+
+

Base class for items that may appear upon a TimeAxisView.

+

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

+

 ArdourUI:RouteTimeAxisView

+

C‡: RouteTimeAxisView

+

is-a: ArdourUI:RouteUI

+
+

Base class for objects with auto-disconnection. trackable must be inherited when objects shall automatically invalidate slots referring to them on destruction. A slot built from a member function of a trackable derived type installs a callback that is invoked when the trackable object is destroyed or overwritten.

add_destroy_notify_callback() and remove_destroy_notify_callback() can be used to manually install and remove callbacks when notification of the object dying is needed.

notify_callbacks() invokes and removes all previously installed callbacks and can therefore be used to disconnect from all signals.

Note that there is no virtual destructor. Don't use trackable* as pointer type for managing your data or the destructors of your derived types won't be called when deleting your objects.

 signal
+ + + +
Cast
TimeAxisViewto_timeaxisview ()
+

 ArdourUI:RouteUI

+

C‡: RouteUI

+

is-a: ArdourUI:Selectable

+
+

Base class for objects with auto-disconnection. trackable must be inherited when objects shall automatically invalidate slots referring to them on destruction. A slot built from a member function of a trackable derived type installs a callback that is invoked when the trackable object is destroyed or overwritten.

add_destroy_notify_callback() and remove_destroy_notify_callback() can be used to manually install and remove callbacks when notification of the object dying is needed.

notify_callbacks() invokes and removes all previously installed callbacks and can therefore be used to disconnect from all signals.

Note that there is no virtual destructor. Don't use trackable* as pointer type for managing your data or the destructors of your derived types won't be called when deleting your objects.

 signal
+

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

+

 ArdourUI:Selectable

+

C‡: Selectable

+
+

Base class for objects with auto-disconnection. trackable must be inherited when objects shall automatically invalidate slots referring to them on destruction. A slot built from a member function of a trackable derived type installs a callback that is invoked when the trackable object is destroyed or overwritten.

add_destroy_notify_callback() and remove_destroy_notify_callback() can be used to manually install and remove callbacks when notification of the object dying is needed.

notify_callbacks() invokes and removes all previously installed callbacks and can therefore be used to disconnect from all signals.

Note that there is no virtual destructor. Don't use trackable* as pointer type for managing your data or the destructors of your derived types won't be called when deleting your objects.

 signal
+

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

 ArdourUI:Selection

C‡: Selection

@@ -3911,6 +4340,35 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C ArdourUI:TimeSelectiontime ArdourUI:TrackSelectiontracks +

 ArdourUI:SelectionList

+

C‡: std::list<Selectable* >

+
+ + + + + + + + + + + + + +
Constructor
ArdourUI.SelectionList ()
Methods
Selectableback ()
boolempty ()
Selectablefront ()
LuaIteriter ()
voidpush_back (Selectable)
voidreverse ()
unsigned longsize ()
LuaTabletable ()
voidunique ()
+

 ArdourUI:TimeAxisView

+

C‡: TimeAxisView

+

is-a: ArdourUI:AxisView

+
+

Abstract base class for time-axis views (horizontal editor 'strips')

This class provides the basic LHS controls and display methods. This should be extended to create functional time-axis based views.

+

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

+

 ArdourUI:TimeAxisViewItem

+

C‡: TimeAxisViewItem

+

is-a: ArdourUI:Selectable

+
+

Base class for items that may appear upon a TimeAxisView.

+

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

 ArdourUI:TimeSelection

C‡: TimeSelection

is-a: ARDOUR:AudioRangeList

@@ -3926,7 +4384,9 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C Constructor ℂARDOUR.AudioRangeList () Methods + AudioRangeback () boolempty () + AudioRangefront () LuaIteriter () voidreverse () unsigned longsize () @@ -3940,15 +4400,65 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C

Inherited from ArdourUI:TrackViewList

+
Methods
boolcontains (TimeAxisView)
RouteListroutelist ()
+

Inherited from ArdourUI:TrackViewStdList

+ + + + + + + + + + + + + +
Constructor
ArdourUI.TrackViewStdList ()
Methods
TimeAxisViewback ()
boolempty ()
TimeAxisViewfront ()
LuaIteriter ()
voidpush_back (TimeAxisView)
voidreverse ()
unsigned longsize ()
LuaTabletable ()
voidunique ()

 ArdourUI:TrackViewList

C‡: TrackViewList

+

is-a: ArdourUI:TrackViewStdList

+
Methods
boolcontains (TimeAxisView)
RouteListroutelist ()
+

Inherited from ArdourUI:TrackViewStdList

+ + + + + + + + + + + + + +
Constructor
ArdourUI.TrackViewStdList ()
Methods
TimeAxisViewback ()
boolempty ()
TimeAxisViewfront ()
LuaIteriter ()
voidpush_back (TimeAxisView)
voidreverse ()
unsigned longsize ()
LuaTabletable ()
voidunique ()
+

 ArdourUI:TrackViewStdList

+

C‡: std::list<TimeAxisView* >

+
+ + + + + + + + + + + + + +
Constructor
ArdourUI.TrackViewStdList ()
Methods
TimeAxisViewback ()
boolempty ()
TimeAxisViewfront ()
LuaIteriter ()
voidpush_back (TimeAxisView)
voidreverse ()
unsigned longsize ()
LuaTabletable ()
voidunique ()

 C:ByteArray

C‡: unsigned char*

@@ -3957,7 +4467,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C LuaMetaTablearray () LuaTableget_table () unsigned char*offset (unsigned int) - boolsameinstance (unsigned char*) voidset_table (LuaTable {unsigned char})

 C:DoubleVector

@@ -3966,6 +4475,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C + @@ -3983,7 +4493,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C -
Constructor
C.DoubleVector ()
C.DoubleVector ()
Methods
LuaTableadd (LuaTable {double})
doubleat (unsigned long)
LuaMetaTablearray ()
LuaTableget_table ()
FloatArrayoffset (unsigned int)
boolsameinstance (FloatArray)
voidset_table (LuaTable {float})

 C:FloatArrayVector

@@ -3992,6 +4501,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C + @@ -4007,6 +4517,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C
Constructor
C.FloatArrayVector ()
C.FloatArrayVector ()
Methods
LuaTableadd (LuaTable {FloatArray})
FloatArrayat (unsigned long)
+ @@ -4016,6 +4527,24 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C
Constructor
C.FloatVector ()
C.FloatVector ()
Methods
LuaTableadd (LuaTable {float})
floatat (unsigned long)
unsigned longsize ()
LuaTabletable ()
+

 C:Int64List

+

C‡: std::list<long >

+
+ + + + + + + + + + + + + + +
Constructor
C.Int64List ()
Methods
LuaTableadd (LuaTable {long})
longback ()
boolempty ()
longfront ()
LuaIteriter ()
voidpush_back (long)
voidreverse ()
unsigned longsize ()
LuaTabletable ()
voidunique ()

 C:IntArray

C‡: int*

@@ -4024,7 +4553,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C LuaMetaTablearray () LuaTableget_table () IntArrayoffset (unsigned int) - boolsameinstance (IntArray) voidset_table (LuaTable {int})

 C:StringList

@@ -4035,7 +4563,9 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C ℂC.StringList () Methods LuaTableadd (LuaTable {std::string}) + std::stringback () boolempty () + std::stringfront () LuaIteriter () voidpush_back (std::string) voidreverse () @@ -4049,6 +4579,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C + @@ -4182,6 +4713,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C + @@ -4213,7 +4745,15 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C - +
Constructor
C.StringVector ()
C.StringVector ()
Methods
LuaTableadd (LuaTable {std::string})
std::stringat (unsigned long)

Queries whether the layout had to ellipsize any paragraphs.

This returns true if the ellipsization mode for layout is not Pango::ELLIPSIZE_NONE, a positive width is set on layout, and there are paragraphs exceeding that width that have to be ellipsized.

Returns true if any paragraphs had to be ellipsized, false otherwise.

boolis_wrapped ()

Queries whether the layout had to wrap any paragraphs.

This returns true if a positive width is set on layout, ellipsization mode of layout is set to Pango::ELLIPSIZE_NONE, and there are paragraphs exceeding the layout width that have to be wrapped.

Returns true if any paragraphs had to be wrapped, false otherwise.

voidlayout_cairo_path (Context)
voidset_ellipsize (EllipsizeMode)

Sets the type of ellipsization being performed for layout. Depending on the ellipsization mode ellipsize text is removed from the start, middle, or end of text so they fit within the width and height of layout set with set_width() and set_height().

If the layout contains characters such as newlines that force it to be layed out in multiple paragraphs, then whether each paragraph is ellipsized separately or the entire layout is ellipsized as a whole depends on the set height of the layout. See set_height() for details.

ellipsize
The new ellipsization mode for layout.
voidset_markup (std::string)
Methods
boolisnil ()
ControlListlist ()
boolsameinstance (Control)
+

 Evoral:ControlEvent

+

C‡: Evoral::ControlEvent

+
+

A single event (time-stamped value) for a control

+ + + +
Data Members
doublevalue
doublewhen

 Evoral:ControlList

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

@@ -4225,15 +4765,16 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C

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
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
- doubleeval (double) + voidclear_list () + doubleeval (double)

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

where
absolute time in samples

Returns parameter value

+ EventListevents () boolin_write_pass () InterpolationStyleinterpolation ()

query interpolation style of the automation data

Returns Interpolation Style

boolisnil () - LuaTable(double, ...)rt_safe_eval (double, bool&) + 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

- boolsameinstance (ControlList) voidset_interpolation (InterpolationStyle)

set the interpolation style of the automation data

is
interpolation style
voidthin (double) @@ -4249,7 +4790,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C -
Methods
boolisnil ()
boolsameinstance (ControlSet)

 Evoral:Event

C‡: Evoral::Event<long>

@@ -4276,7 +4816,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C Beatslength () unsigned charnote () unsigned charoff_velocity () - boolsameinstance (NotePtr) Beatstime () unsigned charvelocity () @@ -4326,7 +4865,24 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C - +
Methods
boolisnil ()
boolsameinstance (Sequence)
+

 LuaDialog:Dialog

+

C‡: LuaDialog::Dialog

+
+ + + + + +
Constructor
LuaDialog.Dialog (std::string, Lua-Function)
Methods
...run (--lua--)
+

 LuaDialog:Message

+

C‡: LuaDialog::Message

+
+ + + + +
Constructor
LuaDialog.Message (std::string, std::string, MessageType, ButtonType)
Methods
intrun ()

 LuaSignal:Set

C‡: std::bitset<47ul>

@@ -4394,7 +4950,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C doubleget_value () boolisnil () std::stringname () - boolsameinstance (Controllable)

Inherited from PBD:StatefulPtr

@@ -4420,6 +4975,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C
+ @@ -4510,7 +5066,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C
Constructor
PBD.IdVector ()
PBD.IdVector ()
Methods
LuaTableadd (LuaTable {ID})
IDat (unsigned long)
-
Methods
boolisnil ()
boolsameinstance (StatefulDestructible)

Inherited from PBD:StatefulPtr

@@ -4555,7 +5110,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C -
IDid ()
boolisnil ()
OwnedPropertyListproperties ()
boolsameinstance (Stateful)

 PBD:XMLNode

C‡: XMLNode

@@ -4676,6 +5230,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C + @@ -4741,6 +5296,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C
Constructor
Vamp.Plugin.FeatureList ()
Vamp.Plugin.FeatureList ()
Methods
LuaTableadd (LuaTable {Feature})
Featureat (unsigned long)
+ @@ -4815,6 +5371,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C
Constructor
Vamp.Plugin.OutputList ()
Vamp.Plugin.OutputList ()
Methods
LuaTableadd (LuaTable {OutputDescriptor})
OutputDescriptorat (unsigned long)
+ @@ -4913,7 +5470,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C
  • ARDOUR.PresentationInfo.Flag.MasterOut
  • ARDOUR.PresentationInfo.Flag.MonitorOut
  • ARDOUR.PresentationInfo.Flag.Auditioner
  • -
  • ARDOUR.PresentationInfo.Flag.Selected
  • ARDOUR.PresentationInfo.Flag.Hidden
  • ARDOUR.PresentationInfo.Flag.GroupOrderSet
  • ARDOUR.PresentationInfo.Flag.StatusMask
  • @@ -5140,6 +5696,30 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C
  • Cairo.WrapMode.Char
  • Cairo.WrapMode.WordChar
  • +

     LuaDialog.Message.MessageType

    + +

     LuaDialog.Message.ButtonType

    + +

     LuaDialog.Response

    +

     LuaSignal.LuaSignal

    +

     Selection.Operation

    +

     Editing.SnapType

    - + -
    Ardour 5.6-14-g7330357e1  -  Tue, 14 Feb 2017 15:03:20 +0100
    +
    Ardour 5.10  -  Thu, 15 Jun 2017 02:04:30 +0200
    Constructor
    Vamp.PluginBase.ParameterList ()
    Vamp.PluginBase.ParameterList ()
    Methods
    LuaTableadd (LuaTable {ParameterDescriptor})
    ParameterDescriptorat (unsigned long)