X-Git-Url: http://shamusworld.gotdns.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=_manual%2F24_lua-scripting%2F02_class_reference.html;h=d5f530c5cc1d3a0c9beaff5f803196402431aa78;hb=7460a6641c2c3b4a51e3578492b3d73d6345305c;hp=0cde811307e3f3f5e2602011f8c4f3a2755ba1a8;hpb=9bca305233a422a852d093538be53ce3ad50d308;p=ardour-manual diff --git a/_manual/24_lua-scripting/02_class_reference.html b/_manual/24_lua-scripting/02_class_reference.html index 0cde811..d5f530c 100644 --- a/_manual/24_lua-scripting/02_class_reference.html +++ b/_manual/24_lua-scripting/02_class_reference.html @@ -5,7 +5,7 @@ title: Class Reference ---
-This documention is far from complete may be inaccurate and subject to change. +This documentation is far from complete may be inaccurate and subject to change.
@@ -130,25 +130,29 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to CC‡: boost::shared_ptr< ARDOUR::Amp >, boost::weak_ptr< ARDOUR::Amp >
is-a: ARDOUR:Processor
+Applies a declick operation to all audio inputs, passing the same number of audio outputs, and passing through any other types unchanged.
Methods | ||
---|---|---|
GainControl | gain_control () | |
bool | isnil () | |
bool | sameinstance (Amp) |
Methods | ||
---|---|---|
void | activate () | |
bool | active () | |
AutomationControl | automation_control (Parameter, bool) | |
Control | control (Parameter, bool) | |
void | deactivate () | |
std::string | display_name () | |
Cast | ||
Amp | to_amp () | |
Automatable | to_automatable () | |
PluginInsert | to_insert () | |
IOProcessor | to_ioprocessor () | |
MonitorProcessor | to_monitorprocessor () | |
PeakMeter | to_peakmeter () | |
SideChain | to_sidechain () | |
UnknownProcessor | to_unknownprocessor () |
Methods | ||
---|---|---|
unsigned int | buffer_size () | |
unsigned int | output_channels () | |
std::string | output_device_name () | |
unsigned int | period_size () | |
bool | sameinstance (AudioBackend) | |
float | sample_rate () | |
int | set_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
Returns true if all samples are zero | ||
FloatArray | data (long) | |
void | read_from (FloatArray, long, long, long) | |
bool | sameinstance (AudioBuffer) | |
void | silence (long, long) | |
silence buffer
|
C‡: ARDOUR::AudioEngine
+is-a: ARDOUR:PortManager
Methods | ||
---|---|---|
int | start (bool) | |
int | stop (bool) |
Methods | ||
---|---|---|
int | connect (std::string, std::string) | |
bool | connected (std::string) | |
int | disconnect (std::string, std::string) | |
int | disconnect_port (Port) | |
LuaTable(int, ...) | get_backend_ports (std::string, DataType, PortFlags, StringVector&) | |
LuaTable(int, ...) | get_connections (std::string, StringVector&) | |
void | get_physical_inputs (DataType, StringVector&) | |
void | get_physical_outputs (DataType, StringVector&) | |
Port | get_port_by_name (std::string) | |
Returns Corresponding Port or 0. | ||
LuaTable(int, ...) | get_ports (DataType, PortList&) | |
std::string | get_pretty_name_by_name (std::string) | |
ChanCount | n_physical_inputs () | |
ChanCount | n_physical_outputs () | |
bool | physically_connected (std::string) | |
PortEngine | port_engine () | |
bool | port_is_physical (std::string) |
C‡: boost::shared_ptr< ARDOUR::AudioPlaylist >, boost::weak_ptr< ARDOUR::AudioPlaylist >
+is-a: ARDOUR:Playlist
+ +A named object associated with a Session. Objects derived from this class are expected to be destroyed before the session calls drop_references().
Methods | ||
---|---|---|
bool | isnil () | |
long | read (FloatArray, FloatArray, FloatArray, long, long, unsigned int) | |
bool | sameinstance (AudioPlaylist) |
Methods | ||
---|---|---|
void | add_region (Region, long, float, bool, int) | |
Region | combine (RegionList) | |
unsigned int | count_regions_at (long) | |
Playlist | cut (AudioRangeList&, bool) | |
DataType | data_type () | |
void | duplicate (Region, long, long, float) | |
| ||
void | duplicate_range (AudioRange&, float) | |
void | duplicate_until (Region, long, long, long) | |
| ||
Region | find_next_region (long, RegionPoint, int) | |
long | find_next_region_boundary (long, int) | |
void | lower_region (Region) | |
void | lower_region_to_bottom (Region) | |
unsigned int | n_regions () | |
void | raise_region (Region) | |
void | raise_region_to_top (Region) | |
Region | region_by_id (ID) | |
RegionListPtr | region_list () | |
RegionListPtr | regions_at (long) | |
RegionListPtr | regions_touched (long, long) | |
Returns regions which have some part within this range. | ||
RegionListPtr | regions_with_end_within (Range) | |
RegionListPtr | regions_with_start_within (Range) | |
void | remove_region (Region) | |
void | split (long) | |
void | split_region (Region, long, int) | |
Region | top_region_at (long) | |
Region | top_unmuted_region_at (long) | |
void | uncombine (Region) | |
Cast | ||
AudioPlaylist | to_audioplaylist () |
Methods | ||
---|---|---|
std::string | name () | |
Cast | ||
Stateful | to_stateful () | |
StatefulDestructible | to_statefuldestructible () |
C‡: boost::shared_ptr< ARDOUR::AudioPort >, boost::weak_ptr< ARDOUR::AudioPort >
is-a: ARDOUR:Port
@@ -248,6 +332,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to CMethods | ||
---|---|---|
bool | isnil () | |
bool | sameinstance (AudioPort) |
Returns true if this Port receives input, otherwise false | ||
bool | sends_output () | |
Returns true if this Port sends output, otherwise false | ||
Cast | ||
---|---|---|
AudioPort | to_audioport () | |
MidiPort | to_midiport () |
C‡: ARDOUR::AudioRange
@@ -301,33 +389,36 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to CC‡: boost::shared_ptr< ARDOUR::AudioSource >, boost::weak_ptr< ARDOUR::AudioSource >
is-a: ARDOUR:Source
+A named object associated with a Session. Objects derived from this class are expected to be destroyed before the session calls drop_references().
Methods | ||
---|---|---|
bool | isnil () | |
unsigned int | n_channels () | |
long | readable_length () | |
bool | sameinstance (AudioSource) |
C‡: boost::shared_ptr< ARDOUR::AudioTrack >, boost::weak_ptr< ARDOUR::AudioTrack >
is-a: ARDOUR:Track
+A track is an route (bus) with a recordable diskstream and related objects relevant to tracking, playback and editing.
Specifically a track has regions and playlist objects.
Methods | ||
---|---|---|
bool | isnil () | |
bool | sameinstance (AudioTrack) |
Methods | ||
---|---|---|
Region | bounce (long, long, InterThreadInfo&, Processor, bool) | |
Region | bounce (InterThreadInfo&) | |
bounce track from session start to session end to new region
Returns a new audio region (or nil in case of error) | ||
Region | bounce_range (long, long, InterThreadInfo&, Processor, bool) | |
Bounce the given range to a new audio region.
Returns a new audio region (or nil in case of error) | ||
bool | bounceable (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.
Returns true if the track can be bounced, or false otherwise. | ||
bool | can_record () | |
Playlist | playlist () | |
bool | record_enabled () | |
bool | record_safe () | |
bool | set_name (std::string) | |
void | set_record_enabled (bool, GroupControlDisposition) | |
void | set_record_safe (bool, GroupControlDisposition) | |
Cast | ||
AudioTrack | to_audio_track () | |
MidiTrack | to_midi_track () | |
Methods | ||
bool | active () | |
int | add_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.
Returns 0 on success, non-0 on failure. | ||
bool | add_sidechain (Processor) | |
Amp | amp () | |
std::string | comment () | |
bool | customize_plugin_insert (Processor, unsigned int, ChanCount) | |
bool | customize_plugin_insert (Processor, unsigned int, ChanCount, ChanCount) | |
enable custom plugin-insert configuration
Returns true if successful | ||
Delivery | main_outs () | |
the signal processorat at end of the processing chain which produces output | ||
bool | muted () | |
ChanCount | n_inputs () | |
ChanCount | n_outputs () | |
Processor | nth_plugin (unsigned int) | |
Processor | nth_processor (unsigned int) | |
Processor | nth_send (unsigned int) | |
PeakMeter | peak_meter () | |
************************************************************* Pure interface begins here************************************************************* | ||
int | remove_processor (Processor, ProcessorStreams, bool) | |
remove plugin/processor
Returns 0 on success | ||
bool | remove_sidechain (Processor) | |
int | replace_processor (Processor, Processor, ProcessorStreams) | |
replace plugin/processor with another
Returns 0 on success | ||
bool | reset_plugin_insert (Processor) | |
reset plugin-insert configuration to default, disable customizations. This is equivalent to calling customize_plugin_insert (proc, 0, unused)
Returns true if successful | ||
void | set_active (bool, void*) | |
void | set_comment (std::string, void*) | |
void | set_meter_point (MeterPoint, bool) | |
bool | set_strict_io (bool) | |
bool | soloed () | |
bool | strict_io () | |
Cast | ||
Track | to_track () |
Methods | ||
---|---|---|
AutomationControl | comp_enable_control () | |
AutomationControl | comp_makeup_control () | |
AutomationControl | comp_mode_control () | |
std::string | comp_mode_name (unsigned int) | |
AutomationControl | comp_redux_control () | |
AutomationControl | comp_speed_control () | |
std::string | comp_speed_name (unsigned int) | |
AutomationControl | comp_threshold_control () | |
unsigned int | eq_band_cnt () | |
std::string | eq_band_name (unsigned int) | |
AutomationControl | eq_enable_control () | |
AutomationControl | eq_freq_control (unsigned int) | |
AutomationControl | eq_gain_control (unsigned int) | |
AutomationControl | eq_hpf_control () | |
AutomationControl | eq_q_control (unsigned int) | |
AutomationControl | eq_shape_control (unsigned int) | |
GainControl | gain_control () | |
bool | is_auditioner () | |
bool | is_hidden () | |
bool | is_master () | |
bool | is_monitor () | |
bool | is_selected () | |
AutomationControl | master_send_enable_control () | |
MonitorProcessor | monitor_control () | |
MuteControl | mute_control () | |
AutomationControl | pan_azimuth_control () | |
AutomationControl | pan_elevation_control () | |
AutomationControl | pan_frontback_control () | |
AutomationControl | pan_lfe_control () | |
AutomationControl | pan_width_control () | |
PhaseControl | phase_control () | |
PresentationInfo | presentation_info_ptr () | |
AutomationControl | rec_enable_control () | |
AutomationControl | rec_safe_control () | |
AutomationControl | send_enable_control (unsigned int) | |
AutomationControl | send_level_control (unsigned int) | |
std::string | send_name (unsigned int) | |
void | set_presentation_order (unsigned int, bool) | |
SoloControl | solo_control () | |
SoloIsolateControl | solo_isolate_control () | |
SoloSafeControl | solo_safe_control () | |
GainControl | trim_control () | |
Cast | ||
Route | to_route () |
Methods | ||
---|---|---|
Methods | ||
AutomationControl | automation_control (Parameter, bool) | |
bool | isnil () | |
bool | sameinstance (Automatable) |
C‡: boost::shared_ptr< ARDOUR::AutomationControl >, boost::weak_ptr< ARDOUR::AutomationControl >
is-a: PBD:Controllable
+A PBD::Controllable with associated automation data (AutomationList)
Methods | ||
---|---|---|
AutomationList | alist () | |
double | get_value () | |
Get the current effective `user' value based on automation state | ||
bool | isnil () | |
bool | sameinstance (AutomationControl) | |
void | set_automation_state (AutoState) | |
void | set_automation_style (AutoStyle) | |
void | set_value (double, GroupControlDisposition) | |
Methods | ||
void | clear_changes () | |
Forget about any changes to this object's properties | ||
ID | id () | |
OwnedPropertyList | properties () |
C‡: boost::shared_ptr< ARDOUR::AutomationList >, boost::weak_ptr< ARDOUR::AutomationList >
+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.
Methods | ||
---|---|---|
XMLNode | get_state () | |
bool | isnil () | |
Command | memento_command (XMLNode, XMLNode) | |
bool | sameinstance (AutomationList) | |
bool | touch_enabled () | |
bool | touching () | |
bool | writing () | |
Methods | ||
ChanCount | count () | |
AudioBuffer | get_audio (unsigned long) | |
MidiBuffer | get_midi (unsigned long) | |
bool | sameinstance (BufferSet) |
C‡: ARDOUR::ChanCount
@@ -497,8 +654,12 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to Cget buffer mapping for given data type and pin
Returns mapped buffer number (or ChanMapping::Invalid)
Test if this mapping is monotonic (useful to see if inplace processing is feasible)
Returns true if the map is a strict monotonic set
set buffer mapping for given data type
matrix multiply multiply every sample of `data' with the corresponding sample at `mult'.
calculate peaks
C‡: ARDOUR::DSP::BiQuad
+C‡: ARDOUR::DSP::Biquad
Biquad Filter
Constructor | ||
---|---|---|
ℂ | ARDOUR.DSP.Biquad (double) | |
Instantiate Biquad Filter
| ||
Methods | ||
void | compute (Type, double, double, double) | |
void | compute (Type, double, double, double) | |
setup filter, compute coefficients
| ||
void | reset () | |
void | configure (double, double, double, double, double) | |
setup filter, set coefficients directly | ||
float | dB_at_freq (float) | |
filter transfer function (filter response for spectrum visualization)
Returns gain at given frequency in dB (clamped to -120..+120) | ||
void | reset () | |
reset filter state | ||
void | run (FloatArray, unsigned int) | |
void | run (FloatArray, unsigned int) | |
process audio data
|
C/C++ Shared Memory
A convenience class representing a C array of float[] or int32_t[] data values. This is useful for lua scripts to perform DSP operations directly using C/C++ with CPU Hardware acceleration.
Access to this memory area is always 4 byte aligned. The data is interpreted either as float or as int.
This memory area can also be shared between different instances or the same lua plugin (DSP, GUI).
Since memory allocation is not realtime safe it should be allocated during dsp_init() or dsp_configure(). The memory is free()ed automatically when the lua instance is destroyed.
Constructor | ||
---|---|---|
ℂ | ARDOUR.DSP.DspShm (unsigned long) | |
Methods | ||
void | allocate (unsigned long) | |
[re] allocate memory in host's memory space
| ||
IntArray | to_int (unsigned long) | |
access memory as integer array
Returns int_32_t[] |
C‡: ARDOUR::DSP::FFTSpectrum
+ +Constructor | ||
---|---|---|
ℂ | ARDOUR.DSP.FFTSpectrum (unsigned int, double) | |
Methods | ||
void | execute () | |
process current data in buffer | ||
float | freq_at_bin (unsigned int) | |
float | power_at_bin (unsigned int, float) | |
query
Returns signal power at given bin (in dBFS) | ||
void | set_data_hann (FloatArray, unsigned int, unsigned int) |
C‡: ARDOUR::DSP::LowPass
@@ -587,11 +769,11 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to Cconvenience contructor for DataType::AUDIO
Returns DataType::AUDIO
convenience constructor for DataType::AUDIO with managed lifetime
Returns DataType::AUDIO
convenience contructor for DataType::MIDI
Returns DataType::MIDI
convenience constructor for DataType::MIDI with managed lifetime
Returns DataType::MIDI
convenience contructor for DataType::NIL
Returns DataType::NIL
convenience constructor for DataType::NIL with managed lifetime
Returns DataType::NIL
Inverse of the from-string constructor
C‡: boost::shared_ptr< ARDOUR::Delivery >, boost::weak_ptr< ARDOUR::Delivery >
is-a: ARDOUR:IOProcessor
+A mixer strip element (Processor) with 1 or 2 IO elements.
Methods | ||
---|---|---|
bool | isnil () | |
bool | sameinstance (Delivery) |
Methods | ||
---|---|---|
void | activate () | |
bool | active () | |
AutomationControl | automation_control (Parameter, bool) | |
Control | control (Parameter, bool) | |
void | deactivate () | |
std::string | display_name () | |
Cast | ||
Amp | to_amp () | |
Automatable | to_automatable () | |
PluginInsert | to_insert () | |
IOProcessor | to_ioprocessor () | |
MonitorProcessor | to_monitorprocessor () | |
PeakMeter | to_peakmeter () | |
SideChain | to_sidechain () | |
UnknownProcessor | to_unknownprocessor () |
unsigned long | size () | |
LuaTable | table () |
C‡: ARDOUR::FluidSynth
+ +Constructor | ||
---|---|---|
ℂ | ARDOUR.FluidSynth (float, int) | |
instantiate a Synth
| ||
Methods | ||
bool | load_sf2 (std::string) | |
bool | midi_event (unsigned char*, unsigned long) | |
void | panic () | |
unsigned int | program_count () | |
std::string | program_name (unsigned int) | |
bool | select_program (unsigned int, unsigned char) | |
bool | synth (FloatArray, FloatArray, unsigned int) |
C‡: boost::shared_ptr< ARDOUR::GainControl >, boost::weak_ptr< ARDOUR::GainControl >
-is-a: ARDOUR:AutomationControl
+is-a: ARDOUR:SlavableAutomationControl,
+A PBD::Controllable with associated automation data (AutomationList)
Methods | ||
---|---|---|
bool | isnil () | |
bool | sameinstance (GainControl) |
Methods | ||
---|---|---|
void | add_master (AutomationControl) | |
void | clear_masters () | |
int | get_boolean_masters () | |
double | get_masters_value () | |
void | remove_master (AutomationControl) | |
bool | slaved () | |
bool | slaved_to (AutomationControl) |
Methods | ||
---|---|---|
Methods | ||
void | clear_changes () | |
Forget about any changes to this object's properties | ||
ID | id () | |
OwnedPropertyList | properties () |
C‡: boost::shared_ptr< ARDOUR::IO >, boost::weak_ptr< ARDOUR::IO >
is-a: ARDOUR:SessionObject
+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.
Methods | ||
---|---|---|
bool | active () | |
bool | physically_connected () | |
Port | port_by_name (unsigned int) | |
int | remove_port (Port, void*) | |
bool | sameinstance (IO) |
Methods | ||
---|---|---|
IO | input () | |
ChanCount | natural_input_streams () | |
ChanCount | natural_output_streams () | |
IO | output () | |
bool | sameinstance (IOProcessor) |
Methods | ||
---|---|---|
void | activate () | |
bool | active () | |
AutomationControl | automation_control (Parameter, bool) | |
Control | control (Parameter, bool) | |
void | deactivate () | |
std::string | display_name () | |
Cast | ||
Amp | to_amp () | |
Automatable | to_automatable () | |
PluginInsert | to_insert () | |
IOProcessor | to_ioprocessor () | |
MonitorProcessor | to_monitorprocessor () | |
PeakMeter | to_peakmeter () | |
SideChain | to_sidechain () | |
UnknownProcessor | to_unknownprocessor () |
Constructor | ||
---|---|---|
ℂ | ARDOUR.InterThreadInfo () | |
Data Members | ||
bool | cancel | |
bool | done | |
float | progress |
C‡: ARDOUR::Locations
+C‡: ARDOUR::Location
is-a: PBD:StatefulDestructible
-Base class for objects with saveable and undoable state with destruction notification
Location on Timeline - abstract representation for Markers, Loop/Punch Ranges, CD-Markers etc.
Methods | ||
---|---|---|
Location | auto_loop_location () | |
Location | auto_punch_location () | |
long | end () | |
long | first_mark_after (long, bool) | |
long | first_mark_after (long, bool) | |
Flags | flags () | |
bool | is_auto_loop () | |
bool | is_auto_punch () | |
bool | is_cd_marker () | |
bool | is_hidden () | |
bool | is_mark () | |
bool | is_range_marker () | |
bool | is_session_range () | |
long | length () | |
void | lock () | |
bool | locked () | |
bool | matches (Flags) | |
int | move_to (long) | |
Location | session_range_location () | |
std::string | name () | |
int | set_end (long, bool, bool) | |
Set end position.
| ||
int | set_length (long, long, bool) | |
int | set_start (long, bool, bool) | |
Set start position.
| ||
long | start () | |
void | unlock () |
Methods | ||
---|---|---|
void | clear_changes () | |
Forget about any changes to this object's properties | ||
ID | id () | |
OwnedPropertyList | properties () |
C‡: ARDOUR::Locations
+is-a: PBD:StatefulDestructible
+ +A collection of session locations including unique dedicated locations (loop, punch, etc)
Methods | ||
---|---|---|
Location | auto_loop_location () | |
Location | auto_punch_location () | |
LuaTable(...) | find_all_between (long, long, LocationList&, Flags) | |
long | first_mark_after (long, bool) | |
Location | first_mark_at (long, long) | |
long | first_mark_before (long, bool) | |
LocationList | list () | |
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 frame. Note that if frame is exactly on a `mark', that mark will not be considered for returning as before/after.
| ||
void | remove (Location) | |
Location | session_range_location () |
Methods | ||
---|---|---|
void | clear_changes () | |
Forget about any changes to this object's properties | ||
ID | id () | |
OwnedPropertyList | properties () |
Methods | ||
---|---|---|
LuaTable | build_filename () | |
LuaTable(float, ...) | get_plugin_insert_param (PluginInsert, unsigned int, bool&) | |
get a plugin control parameter value
Returns value | ||
LuaTable(float, ...) | get_processor_param (Processor, unsigned int, bool&) | |
get a plugin control parameter value
Returns value | ||
LuaTable | hsla_to_rgba () | |
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) | ||
Processor | new_luaproc (Session, std::string) | |
create a new Lua Processor (Plugin)
Returns Processor object (may be nil) | ||
Processor | new_plugin (Session, std::string, PluginType, std::string) | |
set a plugin control-input parameter value
Returns true on success, false on error or out-of-bounds value | ||
void | usleep (unsigned long) |
C‡: ARDOUR::LuaAPI::Vamp
+ +Constructor | ||
---|---|---|
ℂ | ARDOUR.LuaAPI.Vamp (std::string, float) | |
Methods | ||
int | analyze (Readable, unsigned int, --MISSING (luabridge::LuaRef)--) | |
bool | initialize () | |
initialize the plugin for use with analyze(). This is equivalent to plugin():initialise (1, 8192, 8192) and prepares a plugin for analyze. Manual initialization is only required to set plugin-parameters which depend on prior initialization of the plugin. vamp:reset () + vamp:initialize () + vamp:plugin():setParameter (0, 1.5) + vamp:analyze (r, 0) | ||
Plugin | plugin () | |
void | reset () | |
call plugin():reset() and clear intialization flag |
C‡: ARDOUR::LuaOSC::Address
@@ -854,6 +1133,14 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to CTransmit an OSC message
Path (string) and type (string) must always be given. The number of following args must match the type. Supported types are:
'i': integer (lua number)
'f': float (lua number)
'd': double (lua number)
'h': 64bit integer (lua number)
's': string (lua string)
'c': character (lua string)
'T': boolean (lua bool) -- this is not implicily True, a lua true/false must be given
'F': boolean (lua bool) -- this is not implicily False, a lua true/false must be given
Returns boolean true if successful, false on error.
C‡: ARDOUR::LuaTableRef
+ +Methods | ||
---|---|---|
... | get (--lua--) | |
... | set (--lua--) |
C‡: ARDOUR::Meter
@@ -867,15 +1154,49 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to CC‡: ARDOUR::MeterSection
+is-a: ARDOUR:MetricSection
+ +A section of timeline with a certain Meter.
Methods | ||
---|---|---|
void | set_beat (double) | |
void | set_pulse (double) | |
Cast | ||
Meter | to_meter () |
Methods | ||
---|---|---|
double | pulse () |
C‡: ARDOUR::MetricSection
+ +A section of timeline with a certain Tempo or Meter.
Methods | ||
---|---|---|
double | pulse () | |
void | set_pulse (double) |
C‡: ARDOUR::MidiBuffer
Buffer containing 8-bit unsigned char (MIDI) data.
Methods | ||
---|---|---|
void | copy (MidiBuffer) | |
bool | empty () | |
bool | push_back (long, unsigned long, unsigned char*) | |
bool | push_event (MidiEvent) | |
void | resize (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. | ||
bool | sameinstance (MidiBuffer) | |
void | silence (long, long) | |
Clear (eg zero, or empty) buffer | ||
unsigned long | size () | |
... | table (--lua--) |
C‡: boost::shared_ptr< ARDOUR::MidiPort >, boost::weak_ptr< ARDOUR::MidiPort >
@@ -883,8 +1204,10 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to CMethods | ||
---|---|---|
MidiBuffer | get_midi_buffer (unsigned int) | |
bool | input_active () | |
bool | isnil () | |
bool | sameinstance (MidiPort) | |
void | set_input_active (bool) |
Returns true if this Port receives input, otherwise false
Returns true if this Port sends output, otherwise false
C‡: boost::shared_ptr< ARDOUR::MidiTrack >, boost::weak_ptr< ARDOUR::MidiTrack >
is-a: ARDOUR:Track
+A track is an route (bus) with a recordable diskstream and related objects relevant to tracking, playback and editing.
Specifically a track has regions and playlist objects.
Methods | ||
---|---|---|
bool | isnil () | |
bool | sameinstance (MidiTrack) |
Methods | ||
---|---|---|
Region | bounce (long, long, InterThreadInfo&, Processor, bool) | |
Region | bounce (InterThreadInfo&) | |
bounce track from session start to session end to new region
Returns a new audio region (or nil in case of error) | ||
Region | bounce_range (long, long, InterThreadInfo&, Processor, bool) | |
Bounce the given range to a new audio region.
Returns a new audio region (or nil in case of error) | ||
bool | bounceable (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.
Returns true if the track can be bounced, or false otherwise. | ||
bool | can_record () | |
Playlist | playlist () | |
bool | record_enabled () | |
bool | record_safe () | |
bool | set_name (std::string) | |
void | set_record_enabled (bool, GroupControlDisposition) | |
void | set_record_safe (bool, GroupControlDisposition) | |
Cast | ||
AudioTrack | to_audio_track () | |
MidiTrack | to_midi_track () | |
Methods | ||
bool | active () | |
int | add_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.
Returns 0 on success, non-0 on failure. | ||
bool | add_sidechain (Processor) | |
Amp | amp () | |
std::string | comment () | |
bool | customize_plugin_insert (Processor, unsigned int, ChanCount) | |
bool | customize_plugin_insert (Processor, unsigned int, ChanCount, ChanCount) | |
enable custom plugin-insert configuration
Returns true if successful | ||
Delivery | main_outs () | |
the signal processorat at end of the processing chain which produces output | ||
bool | muted () | |
ChanCount | n_inputs () | |
ChanCount | n_outputs () | |
Processor | nth_plugin (unsigned int) | |
Processor | nth_processor (unsigned int) | |
Processor | nth_send (unsigned int) | |
PeakMeter | peak_meter () | |
************************************************************* Pure interface begins here************************************************************* | ||
int | remove_processor (Processor, ProcessorStreams, bool) | |
remove plugin/processor
Returns 0 on success | ||
bool | remove_sidechain (Processor) | |
int | replace_processor (Processor, Processor, ProcessorStreams) | |
replace plugin/processor with another
Returns 0 on success | ||
bool | reset_plugin_insert (Processor) | |
reset plugin-insert configuration to default, disable customizations. This is equivalent to calling customize_plugin_insert (proc, 0, unused)
Returns true if successful | ||
void | set_active (bool, void*) | |
void | set_comment (std::string, void*) | |
void | set_meter_point (MeterPoint, bool) | |
bool | set_strict_io (bool) | |
bool | soloed () | |
bool | strict_io () | |
Cast | ||
Track | to_track () |
Methods | ||
---|---|---|
AutomationControl | comp_enable_control () | |
AutomationControl | comp_makeup_control () | |
AutomationControl | comp_mode_control () | |
std::string | comp_mode_name (unsigned int) | |
AutomationControl | comp_redux_control () | |
AutomationControl | comp_speed_control () | |
std::string | comp_speed_name (unsigned int) | |
AutomationControl | comp_threshold_control () | |
unsigned int | eq_band_cnt () | |
std::string | eq_band_name (unsigned int) | |
AutomationControl | eq_enable_control () | |
AutomationControl | eq_freq_control (unsigned int) | |
AutomationControl | eq_gain_control (unsigned int) | |
AutomationControl | eq_hpf_control () | |
AutomationControl | eq_q_control (unsigned int) | |
AutomationControl | eq_shape_control (unsigned int) | |
GainControl | gain_control () | |
bool | is_auditioner () | |
bool | is_hidden () | |
bool | is_master () | |
bool | is_monitor () | |
bool | is_selected () | |
AutomationControl | master_send_enable_control () | |
MonitorProcessor | monitor_control () | |
MuteControl | mute_control () | |
AutomationControl | pan_azimuth_control () | |
AutomationControl | pan_elevation_control () | |
AutomationControl | pan_frontback_control () | |
AutomationControl | pan_lfe_control () | |
AutomationControl | pan_width_control () | |
PhaseControl | phase_control () | |
PresentationInfo | presentation_info_ptr () | |
AutomationControl | rec_enable_control () | |
AutomationControl | rec_safe_control () | |
AutomationControl | send_enable_control (unsigned int) | |
AutomationControl | send_level_control (unsigned int) | |
std::string | send_name (unsigned int) | |
void | set_presentation_order (unsigned int, bool) | |
SoloControl | solo_control () | |
SoloIsolateControl | solo_isolate_control () | |
SoloSafeControl | solo_safe_control () | |
GainControl | trim_control () | |
Cast | ||
Route | to_route () |
Methods | ||
---|---|---|
LuaTable | table () | |
void | unique () |
C‡: boost::shared_ptr< ARDOUR::MonitorProcessor >, boost::weak_ptr< ARDOUR::MonitorProcessor >
+is-a: ARDOUR:Processor
+ +A mixer strip element - plugin, send, meter, etc
Methods | ||
---|---|---|
Controllable | channel_cut_control (unsigned int) | |
Controllable | channel_dim_control (unsigned int) | |
Controllable | channel_polarity_control (unsigned int) | |
Controllable | channel_solo_control (unsigned int) | |
bool | cut (unsigned int) | |
bool | cut_all () | |
Controllable | cut_control () | |
bool | dim_all () | |
Controllable | dim_control () | |
float | dim_level () | |
Controllable | dim_level_control () | |
bool | dimmed (unsigned int) | |
bool | inverted (unsigned int) | |
bool | isnil () | |
bool | monitor_active () | |
bool | mono () | |
Controllable | mono_control () | |
bool | sameinstance (MonitorProcessor) | |
void | set_cut (unsigned int, bool) | |
void | set_cut_all (bool) | |
void | set_dim (unsigned int, bool) | |
void | set_dim_all (bool) | |
void | set_mono (bool) | |
void | set_polarity (unsigned int, bool) | |
void | set_solo (unsigned int, bool) | |
Controllable | solo_boost_control () | |
float | solo_boost_level () | |
bool | soloed (unsigned int) |
Methods | ||
---|---|---|
void | activate () | |
bool | active () | |
void | deactivate () | |
std::string | display_name () | |
Cast | ||
Amp | to_amp () | |
Automatable | to_automatable () | |
PluginInsert | to_insert () | |
IOProcessor | to_ioprocessor () | |
MonitorProcessor | to_monitorprocessor () | |
PeakMeter | to_peakmeter () | |
SideChain | to_sidechain () | |
UnknownProcessor | to_unknownprocessor () |
Methods | ||
---|---|---|
std::string | name () | |
Cast | ||
Stateful | to_stateful () | |
StatefulDestructible | to_statefuldestructible () |
C‡: boost::shared_ptr< ARDOUR::MuteControl >, boost::weak_ptr< ARDOUR::MuteControl >
+is-a: ARDOUR:SlavableAutomationControl,
+ +A PBD::Controllable with associated automation data (AutomationList)
Methods | ||
---|---|---|
bool | isnil () | |
bool | muted () | |
bool | muted_by_self () | |
bool | sameinstance (MuteControl) |
Methods | ||
---|---|---|
void | add_master (AutomationControl) | |
void | clear_masters () | |
int | get_boolean_masters () | |
double | get_masters_value () | |
void | remove_master (AutomationControl) | |
bool | slaved () | |
bool | slaved_to (AutomationControl) |
Methods | ||
---|---|---|
AutomationList | alist () | |
AutoState | automation_state () | |
AutoStyle | automation_style () | |
double | get_value () | |
Get the current effective `user' value based on automation state | ||
void | set_automation_state (AutoState) | |
void | set_automation_style (AutoStyle) | |
void | set_value (double, GroupControlDisposition) | |
Get and Set `internal' value All derived classes must implement this. Basic derived classes will ignore
| ||
void | start_touch (double) | |
void | stop_touch (bool, double) | |
bool | writable () | |
Cast | ||
Control | to_ctrl () |
Methods | ||
---|---|---|
std::string | name () |
Methods | ||
---|---|---|
void | clear_changes () | |
Forget about any changes to this object's properties | ||
ID | id () | |
OwnedPropertyList | properties () |
C‡: PBD::OwnedPropertyList
is-a: ARDOUR:PropertyList
@@ -999,6 +1499,8 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to CConstructor | ||
---|---|---|
ℂ | ARDOUR.ParameterDescriptor () | |
Methods | ||
std::string | midi_note_name (unsigned char) | |
Data Members | ||
std::string | label | |
bool | logarithmic | |
bool | toggled | |
float | upper |
C‡: boost::shared_ptr< ARDOUR::PeakMeter >, boost::weak_ptr< ARDOUR::PeakMeter >
+is-a: ARDOUR:Processor
+ +Meters peaks on the input and stores them for access.
Methods | ||
---|---|---|
bool | isnil () | |
float | meter_level (unsigned int, MeterType) | |
void | reset_max () | |
bool | sameinstance (PeakMeter) | |
void | set_type (MeterType) |
Methods | ||
---|---|---|
void | activate () | |
bool | active () | |
void | deactivate () | |
std::string | display_name () | |
Cast | ||
Amp | to_amp () | |
Automatable | to_automatable () | |
PluginInsert | to_insert () | |
IOProcessor | to_ioprocessor () | |
MonitorProcessor | to_monitorprocessor () | |
PeakMeter | to_peakmeter () | |
SideChain | to_sidechain () | |
UnknownProcessor | to_unknownprocessor () |
Methods | ||
---|---|---|
std::string | name () | |
Cast | ||
Stateful | to_stateful () | |
StatefulDestructible | to_statefuldestructible () |
C‡: boost::shared_ptr< ARDOUR::PhaseControl >, boost::weak_ptr< ARDOUR::PhaseControl >
+is-a: ARDOUR:AutomationControl
+ +A PBD::Controllable with associated automation data (AutomationList)
Methods | ||
---|---|---|
bool | inverted (unsigned int) | |
bool | isnil () | |
bool | sameinstance (PhaseControl) | |
void | set_phase_invert (unsigned int, bool) | |
|
Methods | ||
---|---|---|
AutomationList | alist () | |
AutoState | automation_state () | |
AutoStyle | automation_style () | |
double | get_value () | |
Get the current effective `user' value based on automation state | ||
void | set_automation_state (AutoState) | |
void | set_automation_style (AutoStyle) | |
void | set_value (double, GroupControlDisposition) | |
Get and Set `internal' value All derived classes must implement this. Basic derived classes will ignore
| ||
void | start_touch (double) | |
void | stop_touch (bool, double) | |
bool | writable () | |
Cast | ||
Control | to_ctrl () |
Methods | ||
---|---|---|
std::string | name () |
Methods | ||
---|---|---|
void | clear_changes () | |
Forget about any changes to this object's properties | ||
ID | id () | |
OwnedPropertyList | properties () |
C‡: boost::shared_ptr< ARDOUR::Playlist >, boost::weak_ptr< ARDOUR::Playlist >
is-a: 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 | ||
---|---|---|
void | add_region (Region, long, float, bool) | |
void | add_region (Region, long, float, bool, int) | |
Region | combine (RegionList) | |
unsigned int | count_regions_at (long) | |
Playlist | cut (AudioRangeList&, bool) | |
DataType | data_type () | |
void | duplicate (Region, long, long, float) | |
| ||
void | duplicate_range (AudioRange&, float) | |
void | duplicate_until (Region, long, long, long) | |
| ||
Region | find_next_region (long, RegionPoint, int) | |
long | find_next_region_boundary (long, int) | |
bool | isnil () | |
void | raise_region (Region) | |
void | raise_region_to_top (Region) | |
Region | region_by_id (ID) | |
RegionListPtr | region_list () | |
RegionListPtr | regions_at (long) | |
RegionListPtr | regions_touched (long, long) | |
Returns regions which have some part within this range. | ||
RegionListPtr | regions_with_end_within (Range) | |
RegionListPtr | regions_with_start_within (Range) | |
void | remove_region (Region) | |
bool | sameinstance (Playlist) | |
void | split (long) | |
void | split_region (Region, long) | |
void | split_region (Region, long, int) | |
Region | top_region_at (long) | |
Region | top_unmuted_region_at (long) | |
void | uncombine (Region) | |
Cast | ||
AudioPlaylist | to_audioplaylist () |
Methods | ||
---|---|---|
std::string | get_docs () | |
PluginInfo | get_info () | |
LuaTable(int, ...) | get_parameter_descriptor (unsigned int, ParameterDescriptor&) | |
std::string | get_parameter_docs (unsigned int) | |
bool | isnil () | |
bool | parameter_is_input (unsigned int) | |
PresetRecord | preset_by_label (std::string) | |
PresetRecord | preset_by_uri (std::string) | |
bool | sameinstance (Plugin) |
Methods | ||
---|---|---|
void | clear_changes () | |
Forget about any changes to this object's properties | ||
ID | id () | |
OwnedPropertyList | properties () |
C‡: boost::shared_ptr< ARDOUR::PluginInsert::PluginControl >, boost::weak_ptr< ARDOUR::PluginInsert::PluginControl >
is-a: ARDOUR:AutomationControl
+A control that manipulates a plugin parameter (control port).
Methods | ||
---|---|---|
bool | isnil () | |
bool | sameinstance (PluginControl) |
Methods | ||
---|---|---|
void | clear_changes () | |
Forget about any changes to this object's properties | ||
ID | id () | |
OwnedPropertyList | properties () |
C‡: boost::shared_ptr< ARDOUR::PluginInsert >, boost::weak_ptr< ARDOUR::PluginInsert >
is-a: ARDOUR:Processor
+Plugin inserts: send data through a plugin
Methods | ||
---|---|---|
void | activate () | |
bool | isnil () | |
ChanMapping | output_map (unsigned int) | |
Plugin | plugin (unsigned int) | |
bool | sameinstance (PluginInsert) | |
void | set_input_map (unsigned int, ChanMapping) | |
void | set_output_map (unsigned int, ChanMapping) | |
IO | sidechain_input () | |
bool | strict_io_configured () |
Methods | ||
---|---|---|
bool | active () | |
AutomationControl | automation_control (Parameter, bool) | |
Control | control (Parameter, bool) | |
std::string | display_name () | |
Cast | ||
Amp | to_amp () | |
Automatable | to_automatable () | |
PluginInsert | to_insert () | |
IOProcessor | to_ioprocessor () | |
MonitorProcessor | to_monitorprocessor () | |
PeakMeter | to_peakmeter () | |
SideChain | to_sidechain () | |
UnknownProcessor | to_unknownprocessor () |
Returns Port human readable name | ||
bool | receives_input () | |
Returns true if this Port receives input, otherwise false | ||
bool | sameinstance (Port) | |
bool | sends_output () | |
Returns true if this Port sends output, otherwise false | ||
Cast | ||
---|---|---|
AudioPort | to_audioport () | |
MidiPort | to_midiport () |
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.
+C‡: std::list<boost::shared_ptr<ARDOUR::Port> >
+ +Constructor | ||
---|---|---|
ℂ | ARDOUR.PortList () | |
Methods | ||
bool | empty () | |
LuaIter | iter () | |
void | reverse () | |
unsigned long | size () | |
LuaTable | table () |
C‡: ARDOUR::PortManager
+ +Methods | ||
---|---|---|
int | connect (std::string, std::string) | |
bool | connected (std::string) | |
int | disconnect (std::string, std::string) | |
int | disconnect_port (Port) | |
LuaTable(int, ...) | get_backend_ports (std::string, DataType, PortFlags, StringVector&) | |
LuaTable(int, ...) | get_connections (std::string, StringVector&) | |
void | get_physical_inputs (DataType, StringVector&) | |
void | get_physical_outputs (DataType, StringVector&) | |
Port | get_port_by_name (std::string) | |
Returns Corresponding Port or 0. | ||
LuaTable(int, ...) | get_ports (DataType, PortList&) | |
std::string | get_pretty_name_by_name (std::string) | |
ChanCount | n_physical_inputs () | |
ChanCount | n_physical_outputs () | |
bool | physically_connected (std::string) | |
PortEngine | port_engine () | |
bool | port_is_physical (std::string) |
C‡: boost::shared_ptr< ARDOUR::PortSet >, boost::weak_ptr< ARDOUR::PortSet >
+An ordered list of Ports, possibly of various types.
This allows access to all the ports as a list, ignoring type, or accessing the nth port of a given type. Note that port(n) and nth_audio_port(n) may NOT return the same port.
Each port is held twice; once in a per-type vector of vectors (_ports) and once in a vector of all port (_all_ports). This is to speed up the fairly common case of iterating over all ports.
Methods | ||
---|---|---|
void | add (Port) | |
Port | port (DataType, unsigned long) | |
nth port of type t, or nth port if t = NIL
| ||
bool | remove (Port) | |
bool | sameinstance (PortSet) |
C‡: ARDOUR::Plugin::PresetRecord
+C‡: ARDOUR::PresentationInfo
+is-a: PBD:Stateful
+ +Base class for objects with saveable and undoable state
Methods | ||
---|---|---|
unsigned int | color () | |
unsigned int | order () | |
void | set_color (unsigned int) |
Methods | ||
---|---|---|
void | clear_changes () | |
Forget about any changes to this object's properties | ||
ID | id () | |
OwnedPropertyList | properties () |
C‡: ARDOUR::Plugin::PresetRecord
Constructor | ||
---|---|---|
ℂ | ARDOUR.PresetRecord () | |
Data Members | ||
std::string | label | |
std::string | uri | |
bool | user | |
bool | valid |
C‡: std::vector<ARDOUR::Plugin::PresetRecord >
+ +Constructor | ||
---|---|---|
ℂ | ARDOUR.PresetVector () | |
Methods | ||
LuaTable | add (LuaTable {PresetRecord}) | |
PresetRecord | at (unsigned long) | |
bool | empty () | |
LuaIter | iter () | |
void | push_back (PresetRecord) | |
unsigned long | size () | |
LuaTable | table () |
C‡: boost::shared_ptr< ARDOUR::Processor >, boost::weak_ptr< ARDOUR::Processor >
is-a: ARDOUR:SessionObject
+A mixer strip element - plugin, send, meter, etc
Methods | ||
---|---|---|
void | activate () | |
bool | active () | |
AutomationControl | automation_control (Parameter, bool) | |
Control | control (Parameter, bool) | |
void | deactivate () | |
std::string | display_name () | |
bool | isnil () | |
bool | sameinstance (Processor) | |
Cast | ||
Amp | to_amp () | |
Automatable | to_automatable () | |
PluginInsert | to_insert () | |
IOProcessor | to_ioprocessor () | |
MonitorProcessor | to_monitorprocessor () | |
PeakMeter | to_peakmeter () | |
SideChain | to_sidechain () | |
UnknownProcessor | to_unknownprocessor () |
Stateful | to_stateful () | |
StatefulDestructible | to_statefuldestructible () |
C‡: std::vector<boost::shared_ptr<ARDOUR::Processor> >
+ +Constructor | ||
---|---|---|
ℂ | ARDOUR.ProcessorVector () | |
Methods | ||
LuaTable | add (LuaTable {Processor}) | |
Processor | at (unsigned long) | |
bool | empty () | |
LuaIter | iter () | |
void | push_back (Processor) | |
unsigned long | size () | |
LuaTable | table () |
C‡: PBD::PropertyDescriptor<bool>
@@ -1272,10 +1989,22 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to CA list of properties, mapped using their ID
This class object is only used indirectly as return-value and function-parameter. It provides no methods by itself.
+C‡: boost::shared_ptr< ARDOUR::Readable >, boost::weak_ptr< ARDOUR::Readable >
+ +Methods | ||
---|---|---|
bool | isnil () | |
unsigned int | n_channels () | |
long | read (FloatArray, long, long, int) | |
long | readable_length () | |
bool | sameinstance (Readable) |
C‡: boost::shared_ptr< ARDOUR::Region >, boost::weak_ptr< ARDOUR::Region >
is-a: 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 | ||
---|---|---|
bool | at_natural_position () | |
bool | captured () | |
void | clear_sync_position () | |
bool | covers (long) | |
void | cut_end (long) | |
void | cut_front (long) | |
void | cut_end (long, int) | |
void | cut_front (long, int) | |
DataType | data_type () | |
bool | external () | |
bool | hidden () | |
bool | locked () | |
void | lower () | |
void | lower_to_bottom () | |
void | move_start (long) | |
void | move_start (long, int) | |
void | move_to_natural_position () | |
bool | muted () | |
void | nudge_position (long) | |
bool | position_locked () | |
void | raise () | |
void | raise_to_top () | |
bool | sameinstance (Region) | |
void | set_hidden (bool) | |
void | set_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. | ||
void | set_length (long) | |
void | set_length (long, int) | |
void | set_locked (bool) | |
void | set_muted (bool) | |
void | set_opaque (bool) | |
void | set_position (long) | |
void | set_position (long, int) | |
void | set_position_locked (bool) | |
void | set_start (long) | |
void | set_sync_position (long) | |
LuaTable(long, ...) | sync_offset (int&) | |
long | sync_position () | |
Returns Sync position in session time | ||
void | trim_end (long) | |
| ||
void | trim_front (long) | |
void | trim_to (long, long) | |
bool | valid_transients () | |
void | trim_end (long, int) | |
void | trim_front (long, int) | |
void | trim_to (long, long, int) | |
bool | video_locked () | |
bool | whole_file () | |
Cast | ||
Readable | to_readable () |
C‡: boost::shared_ptr< ARDOUR::Route >, boost::weak_ptr< ARDOUR::Route >
-is-a: ARDOUR:SessionObject
+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 | ||
---|---|---|
bool | active () | |
int | add_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.
Returns 0 on success, non-0 on failure. | ||
bool | add_sidechain (Processor) | |
Amp | amp () | |
std::string | comment () | |
bool | customize_plugin_insert (Processor, unsigned int, ChanCount) | |
bool | customize_plugin_insert (Processor, unsigned int, ChanCount, ChanCount) | |
enable custom plugin-insert configuration
Returns true if successful | ||
bool | isnil () | |
Delivery | main_outs () | |
the signal processorat at end of the processing chain which produces output | ||
ChanCount | n_inputs () | |
ChanCount | n_outputs () | |
Processor | nth_plugin (unsigned int) | |
Processor | nth_processor (unsigned int) | |
Processor | nth_send (unsigned int) | |
PeakMeter | peak_meter () | |
************************************************************* Pure interface begins here************************************************************* | ||
int | remove_processor (Processor, ProcessorStreams, bool) | |
remove plugin/processor
Returns 0 on success | ||
bool | remove_sidechain (Processor) | |
int | replace_processor (Processor, Processor, ProcessorStreams) | |
replace plugin/processor with another
Returns 0 on success | ||
bool | reset_plugin_insert (Processor) | |
reset plugin-insert configuration to default, disable customizations. This is equivalent to calling customize_plugin_insert (proc, 0, unused)
Returns true if successful | ||
bool | sameinstance (Route) | |
void | set_active (bool, void*) | |
void | set_comment (std::string, void*) | |
void | set_meter_point (MeterPoint, bool) | |
bool | set_name (std::string) | |
bool | set_strict_io (bool) | |
bool | soloed () | |
Cast | ||
Track | to_track () |
Methods | ||
---|---|---|
AutomationControl | comp_enable_control () | |
AutomationControl | comp_makeup_control () | |
AutomationControl | comp_mode_control () | |
std::string | comp_mode_name (unsigned int) | |
AutomationControl | comp_redux_control () | |
AutomationControl | comp_speed_control () | |
std::string | comp_speed_name (unsigned int) | |
AutomationControl | comp_threshold_control () | |
unsigned int | eq_band_cnt () | |
std::string | eq_band_name (unsigned int) | |
AutomationControl | eq_enable_control () | |
AutomationControl | eq_freq_control (unsigned int) | |
AutomationControl | eq_gain_control (unsigned int) | |
AutomationControl | eq_hpf_control () | |
AutomationControl | eq_q_control (unsigned int) | |
AutomationControl | eq_shape_control (unsigned int) | |
GainControl | gain_control () | |
bool | is_auditioner () | |
bool | is_hidden () | |
bool | is_master () | |
bool | is_monitor () | |
bool | is_selected () | |
AutomationControl | master_send_enable_control () | |
MonitorProcessor | monitor_control () | |
MuteControl | mute_control () | |
AutomationControl | pan_azimuth_control () | |
AutomationControl | pan_elevation_control () | |
AutomationControl | pan_frontback_control () | |
AutomationControl | pan_lfe_control () | |
AutomationControl | pan_width_control () | |
PhaseControl | phase_control () | |
PresentationInfo | presentation_info_ptr () | |
AutomationControl | rec_enable_control () | |
AutomationControl | rec_safe_control () | |
AutomationControl | send_enable_control (unsigned int) | |
AutomationControl | send_level_control (unsigned int) | |
std::string | send_name (unsigned int) | |
void | set_presentation_order (unsigned int, bool) | |
SoloControl | solo_control () | |
SoloIsolateControl | solo_isolate_control () | |
SoloSafeControl | solo_safe_control () | |
GainControl | trim_control () | |
Cast | ||
Route | to_route () |
Methods | ||
---|---|---|
Constructor | ||
ℂ | ARDOUR.Route.ProcessorStreams () |
C‡: ARDOUR::RouteGroup
+ +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.
This class object is only used indirectly as return-value and function-parameter. It provides no methods by itself.
C‡: std::list<boost::shared_ptr<ARDOUR::Route> >
@@ -1464,39 +2259,57 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to CMethods | ||
---|---|---|
void | abort_reversible_command () | |
abort an open undo command This must only be called after begin_reversible_command () | ||
bool | actively_recording () | |
void | add_command (Command) | |
StatefulDiffCommand | add_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.
Returns the allocated StatefulDiffCommand (already added via add_command) | ||
void | begin_reversible_command (std::string) | |
begin collecting undo information This call must always be followed by either begin_reversible_command() or commit_reversible_command()
| ||
SessionConfiguration | cfg () | |
void | commit_reversible_command (Command) | |
finalize an undo command and commit pending transactions This must only be called after begin_reversible_command ()
| ||
Controllable | controllable_by_id (ID) | |
long | current_end_frame () | |
long | current_start_frame () | |
void | disable_record (bool, bool) | |
AudioEngine | engine () | |
long | frame_rate () | |
"actual" sample rate of session, set by current audioengine rate, pullup/down etc. | ||
double | frames_per_timecode_frame () | |
unsigned int | get_block_size () | |
bool | get_play_loop () | |
Route | get_remote_nth_route (unsigned int) | |
Stripable | get_remote_nth_stripable (unsigned int, Flag) | |
RouteListPtr | get_routes () | |
BufferSet | get_scratch_buffers (ChanCount, bool) | |
BufferSet | get_silent_buffers (ChanCount) | |
RouteListPtr | get_tracks () | |
void | goto_end () | |
void | goto_start () | |
void | goto_start (bool) | |
long | last_transport_start () | |
Location | locations () | |
Locations | locations () | |
Route | master_out () | |
void | maybe_enable_record () | |
Route | monitor_out () | |
std::string | name () | |
RouteList | new_route_from_template (unsigned int, std::string, std::string, PlaylistDisposition) | |
create a new track or bus from a template (XML path)
Returns list of newly created routes | ||
RouteList | new_audio_route (int, int, RouteGroup, unsigned int, std::string, Flag, unsigned int) | |
AudioTrackList | new_audio_track (int, int, RouteGroup, unsigned int, std::string, unsigned int, TrackMode) | |
RouteList | new_midi_route (RouteGroup, unsigned int, std::string, PluginInfo, PresetRecord, Flag, unsigned int) | |
MidiTrackList | new_midi_track (ChanCount, ChanCount, PluginInfo, PresetRecord, RouteGroup, unsigned int, std::string, unsigned int, TrackMode) | |
RouteList | new_route_from_template (unsigned int, unsigned int, std::string, std::string, PlaylistDisposition) | |
long | nominal_frame_rate () | |
"native" sample rate of session, regardless of current audioengine rate, pullup/down etc | ||
std::string | path () | |
Processor | processor_by_id (ID) | |
RecordState | record_status () | |
void | request_locate (long, bool) | |
void | request_play_loop (bool, bool) | |
void | request_stop (bool, bool) | |
void | request_transport_speed (double, bool) | |
Route | route_by_id (ID) | |
Route | route_by_name (std::string) | |
Route | route_by_remote_id (unsigned int) | |
Route | route_by_id (ID) | |
Route | route_by_name (std::string) | |
Route | route_by_selected_count (unsigned int) | |
int | save_state (std::string, bool, bool, bool) | |
save session
Returns zero on success | ||
void | scripts_changed () | |
bool | timecode_drop_frames () | |
long | timecode_frames_per_hour () | |
double | timecode_frames_per_second () | |
Track | track_by_diskstream_id (ID) | |
Track | track_by_diskstream_id (ID) | |
long | transport_frame () | |
bool | transport_rolling () | |
double | transport_speed () | |
StringList | unknown_processors () | |
long | worst_input_latency () | |
long | worst_output_latency () | |
long | worst_playback_latency () | |
long | worst_track_latency () |
C‡: ARDOUR::SessionConfiguration
+is-a: PBD:Configuration
+ +Base class for objects with saveable and undoable state
Methods | ||
---|---|---|
std::string | get_audio_search_path () | |
bool | get_auto_input () | |
bool | get_auto_play () | |
bool | get_auto_return () | |
unsigned int | get_destructive_xfade_msecs () | |
bool | get_external_sync () | |
bool | get_glue_new_markers_to_bars_and_beats () | |
bool | get_glue_new_regions_to_bars_and_beats () | |
InsertMergePolicy | get_insert_merge_policy () | |
bool | get_jack_time_master () | |
unsigned int | get_meterbridge_label_height () | |
bool | get_midi_copy_is_fork () | |
std::string | get_midi_search_path () | |
SampleFormat | get_native_file_data_format () | |
HeaderFormat | get_native_file_header_format () | |
bool | get_punch_in () | |
bool | get_punch_out () | |
std::string | get_raid_path () | |
bool | get_realtime_export () | |
bool | get_show_busses_on_meterbridge () | |
bool | get_show_group_tabs () | |
bool | get_show_master_on_meterbridge () | |
bool | get_show_midi_on_meterbridge () | |
bool | get_show_monitor_on_meterbridge () | |
bool | get_show_mute_on_meterbridge () | |
bool | get_show_name_on_meterbridge () | |
bool | get_show_rec_on_meterbridge () | |
bool | get_show_region_fades () | |
bool | get_show_solo_on_meterbridge () | |
bool | get_show_summary () | |
std::string | get_slave_timecode_offset () | |
unsigned int | get_subframes_per_frame () | |
std::string | get_take_name () | |
TimecodeFormat | get_timecode_format () | |
std::string | get_timecode_generator_offset () | |
long | get_timecode_offset () | |
bool | get_timecode_offset_negative () | |
bool | get_track_name_number () | |
bool | get_track_name_take () | |
bool | get_use_monitor_fades () | |
bool | get_use_region_fades () | |
bool | get_use_transport_fades () | |
bool | get_use_video_file_fps () | |
bool | get_use_video_sync () | |
float | get_video_pullup () | |
bool | get_videotimeline_pullup () | |
double | get_wave_amplitude_zoom () | |
unsigned short | get_wave_zoom_factor () | |
bool | set_audio_search_path (std::string) | |
bool | set_auto_input (bool) | |
bool | set_auto_play (bool) | |
bool | set_auto_return (bool) | |
bool | set_destructive_xfade_msecs (unsigned int) | |
bool | set_external_sync (bool) | |
bool | set_glue_new_markers_to_bars_and_beats (bool) | |
bool | set_glue_new_regions_to_bars_and_beats (bool) | |
bool | set_insert_merge_policy (InsertMergePolicy) | |
bool | set_jack_time_master (bool) | |
bool | set_meterbridge_label_height (unsigned int) | |
bool | set_midi_copy_is_fork (bool) | |
bool | set_midi_search_path (std::string) | |
bool | set_native_file_data_format (SampleFormat) | |
bool | set_native_file_header_format (HeaderFormat) | |
bool | set_punch_in (bool) | |
bool | set_punch_out (bool) | |
bool | set_raid_path (std::string) | |
bool | set_realtime_export (bool) | |
bool | set_show_busses_on_meterbridge (bool) | |
bool | set_show_group_tabs (bool) | |
bool | set_show_master_on_meterbridge (bool) | |
bool | set_show_midi_on_meterbridge (bool) | |
bool | set_show_monitor_on_meterbridge (bool) | |
bool | set_show_mute_on_meterbridge (bool) | |
bool | set_show_name_on_meterbridge (bool) | |
bool | set_show_rec_on_meterbridge (bool) | |
bool | set_show_region_fades (bool) | |
bool | set_show_solo_on_meterbridge (bool) | |
bool | set_show_summary (bool) | |
bool | set_slave_timecode_offset (std::string) | |
bool | set_subframes_per_frame (unsigned int) | |
bool | set_take_name (std::string) | |
bool | set_timecode_format (TimecodeFormat) | |
bool | set_timecode_generator_offset (std::string) | |
bool | set_timecode_offset (long) | |
bool | set_timecode_offset_negative (bool) | |
bool | set_track_name_number (bool) | |
bool | set_track_name_take (bool) | |
bool | set_use_monitor_fades (bool) | |
bool | set_use_region_fades (bool) | |
bool | set_use_transport_fades (bool) | |
bool | set_use_video_file_fps (bool) | |
bool | set_use_video_sync (bool) | |
bool | set_video_pullup (float) | |
bool | set_videotimeline_pullup (bool) | |
bool | set_wave_amplitude_zoom (double) | |
bool | set_wave_zoom_factor (unsigned short) | |
Properties | ||
std::string | audio_search_path | |
bool | auto_input | |
bool | auto_play | |
bool | auto_return | |
unsigned int | destructive_xfade_msecs | |
bool | external_sync | |
bool | glue_new_markers_to_bars_and_beats | |
bool | glue_new_regions_to_bars_and_beats | |
ARDOUR.InsertMergePolicy | insert_merge_policy | |
bool | jack_time_master | |
unsigned int | meterbridge_label_height | |
bool | midi_copy_is_fork | |
std::string | midi_search_path | |
ARDOUR.SampleFormat | native_file_data_format | |
ARDOUR.HeaderFormat | native_file_header_format | |
bool | punch_in | |
bool | punch_out | |
std::string | raid_path | |
bool | realtime_export | |
bool | show_busses_on_meterbridge | |
bool | show_group_tabs | |
bool | show_master_on_meterbridge | |
bool | show_midi_on_meterbridge | |
bool | show_monitor_on_meterbridge | |
bool | show_mute_on_meterbridge | |
bool | show_name_on_meterbridge | |
bool | show_rec_on_meterbridge | |
bool | show_region_fades | |
bool | show_solo_on_meterbridge | |
bool | show_summary | |
std::string | slave_timecode_offset | |
unsigned int | subframes_per_frame | |
std::string | take_name | |
Timecode.TimecodeFormat | timecode_format | |
std::string | timecode_generator_offset | |
long | timecode_offset | |
bool | timecode_offset_negative | |
bool | track_name_number | |
bool | track_name_take | |
bool | use_monitor_fades | |
bool | use_region_fades | |
bool | use_transport_fades | |
bool | use_video_file_fps | |
bool | use_video_sync | |
float | video_pullup | |
bool | videotimeline_pullup | |
double | wave_amplitude_zoom | |
unsigned short | wave_zoom_factor |
Methods | ||
---|---|---|
void | clear_changes () | |
Forget about any changes to this object's properties | ||
ID | id () | |
OwnedPropertyList | properties () |
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().
Methods | ||
---|---|---|
bool | isnil () | |
std::string | name () | |
bool | sameinstance (SessionObject) | |
Cast | ||
Stateful | to_stateful () | |
StatefulDestructible | to_statefuldestructible () |
Methods | ||
---|---|---|
bool | isnil () | |
bool | sameinstance (SideChain) |
Methods | ||
---|---|---|
void | activate () | |
bool | active () | |
AutomationControl | automation_control (Parameter, bool) | |
Control | control (Parameter, bool) | |
void | deactivate () | |
std::string | display_name () | |
Cast | ||
Amp | to_amp () | |
Automatable | to_automatable () | |
PluginInsert | to_insert () | |
IOProcessor | to_ioprocessor () | |
MonitorProcessor | to_monitorprocessor () | |
PeakMeter | to_peakmeter () | |
SideChain | to_sidechain () | |
UnknownProcessor | to_unknownprocessor () |
Stateful | to_stateful () | |
StatefulDestructible | to_statefuldestructible () |
C‡: boost::shared_ptr< ARDOUR::SlavableAutomationControl >, boost::weak_ptr< ARDOUR::SlavableAutomationControl >
+is-a: ARDOUR:AutomationControl
+ +A PBD::Controllable with associated automation data (AutomationList)
Methods | ||
---|---|---|
void | add_master (AutomationControl) | |
void | clear_masters () | |
int | get_boolean_masters () | |
double | get_masters_value () | |
bool | isnil () | |
void | remove_master (AutomationControl) | |
bool | sameinstance (SlavableAutomationControl,) | |
bool | slaved () | |
bool | slaved_to (AutomationControl) |
Methods | ||
---|---|---|
AutomationList | alist () | |
AutoState | automation_state () | |
AutoStyle | automation_style () | |
double | get_value () | |
Get the current effective `user' value based on automation state | ||
void | set_automation_state (AutoState) | |
void | set_automation_style (AutoStyle) | |
void | set_value (double, GroupControlDisposition) | |
Get and Set `internal' value All derived classes must implement this. Basic derived classes will ignore
| ||
void | start_touch (double) | |
void | stop_touch (bool, double) | |
bool | writable () | |
Cast | ||
Control | to_ctrl () |
Methods | ||
---|---|---|
std::string | name () |
Methods | ||
---|---|---|
void | clear_changes () | |
Forget about any changes to this object's properties | ||
ID | id () | |
OwnedPropertyList | properties () |
C‡: boost::shared_ptr< ARDOUR::SoloControl >, boost::weak_ptr< ARDOUR::SoloControl >
+is-a: ARDOUR:SlavableAutomationControl,
+ +A PBD::Controllable with associated automation data (AutomationList)
Methods | ||
---|---|---|
bool | can_solo () | |
bool | isnil () | |
bool | sameinstance (SoloControl) | |
bool | self_soloed () | |
bool | soloed () |
Methods | ||
---|---|---|
void | add_master (AutomationControl) | |
void | clear_masters () | |
int | get_boolean_masters () | |
double | get_masters_value () | |
void | remove_master (AutomationControl) | |
bool | slaved () | |
bool | slaved_to (AutomationControl) |
Methods | ||
---|---|---|
AutomationList | alist () | |
AutoState | automation_state () | |
AutoStyle | automation_style () | |
double | get_value () | |
Get the current effective `user' value based on automation state | ||
void | set_automation_state (AutoState) | |
void | set_automation_style (AutoStyle) | |
void | set_value (double, GroupControlDisposition) | |
Get and Set `internal' value All derived classes must implement this. Basic derived classes will ignore
| ||
void | start_touch (double) | |
void | stop_touch (bool, double) | |
bool | writable () | |
Cast | ||
Control | to_ctrl () |
Methods | ||
---|---|---|
std::string | name () |
Methods | ||
---|---|---|
void | clear_changes () | |
Forget about any changes to this object's properties | ||
ID | id () | |
OwnedPropertyList | properties () |
C‡: boost::shared_ptr< ARDOUR::SoloIsolateControl >, boost::weak_ptr< ARDOUR::SoloIsolateControl >
+is-a: ARDOUR:SlavableAutomationControl,
+ +A PBD::Controllable with associated automation data (AutomationList)
Methods | ||
---|---|---|
bool | isnil () | |
bool | sameinstance (SoloIsolateControl) | |
bool | self_solo_isolated () | |
bool | solo_isolated () |
Methods | ||
---|---|---|
void | add_master (AutomationControl) | |
void | clear_masters () | |
int | get_boolean_masters () | |
double | get_masters_value () | |
void | remove_master (AutomationControl) | |
bool | slaved () | |
bool | slaved_to (AutomationControl) |
Methods | ||
---|---|---|
AutomationList | alist () | |
AutoState | automation_state () | |
AutoStyle | automation_style () | |
double | get_value () | |
Get the current effective `user' value based on automation state | ||
void | set_automation_state (AutoState) | |
void | set_automation_style (AutoStyle) | |
void | set_value (double, GroupControlDisposition) | |
Get and Set `internal' value All derived classes must implement this. Basic derived classes will ignore
| ||
void | start_touch (double) | |
void | stop_touch (bool, double) | |
bool | writable () | |
Cast | ||
Control | to_ctrl () |
Methods | ||
---|---|---|
std::string | name () |
Methods | ||
---|---|---|
void | clear_changes () | |
Forget about any changes to this object's properties | ||
ID | id () | |
OwnedPropertyList | properties () |
C‡: boost::shared_ptr< ARDOUR::SoloSafeControl >, boost::weak_ptr< ARDOUR::SoloSafeControl >
+is-a: ARDOUR:SlavableAutomationControl,
+ +A PBD::Controllable with associated automation data (AutomationList)
Methods | ||
---|---|---|
bool | isnil () | |
bool | sameinstance (SoloSafeControl) | |
bool | solo_safe () |
Methods | ||
---|---|---|
void | add_master (AutomationControl) | |
void | clear_masters () | |
int | get_boolean_masters () | |
double | get_masters_value () | |
void | remove_master (AutomationControl) | |
bool | slaved () | |
bool | slaved_to (AutomationControl) |
Methods | ||
---|---|---|
AutomationList | alist () | |
AutoState | automation_state () | |
AutoStyle | automation_style () | |
double | get_value () | |
Get the current effective `user' value based on automation state | ||
void | set_automation_state (AutoState) | |
void | set_automation_style (AutoStyle) | |
void | set_value (double, GroupControlDisposition) | |
Get and Set `internal' value All derived classes must implement this. Basic derived classes will ignore
| ||
void | start_touch (double) | |
void | stop_touch (bool, double) | |
bool | writable () | |
Cast | ||
Control | to_ctrl () |
Methods | ||
---|---|---|
std::string | name () |
Methods | ||
---|---|---|
void | clear_changes () | |
Forget about any changes to this object's properties | ||
ID | id () | |
OwnedPropertyList | properties () |
C‡: boost::shared_ptr< ARDOUR::Source >, boost::weak_ptr< ARDOUR::Source >
+A named object associated with a Session. Objects derived from this class are expected to be destroyed before the session calls drop_references().
Methods | ||
---|---|---|
bool | isnil () | |
bool | sameinstance (Source) |
C‡: boost::shared_ptr< ARDOUR::Stripable >, boost::weak_ptr< ARDOUR::Stripable >
+is-a: 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 | ||
---|---|---|
AutomationControl | comp_enable_control () | |
AutomationControl | comp_makeup_control () | |
AutomationControl | comp_mode_control () | |
std::string | comp_mode_name (unsigned int) | |
AutomationControl | comp_redux_control () | |
AutomationControl | comp_speed_control () | |
std::string | comp_speed_name (unsigned int) | |
AutomationControl | comp_threshold_control () | |
unsigned int | eq_band_cnt () | |
std::string | eq_band_name (unsigned int) | |
AutomationControl | eq_enable_control () | |
AutomationControl | eq_freq_control (unsigned int) | |
AutomationControl | eq_gain_control (unsigned int) | |
AutomationControl | eq_hpf_control () | |
AutomationControl | eq_q_control (unsigned int) | |
AutomationControl | eq_shape_control (unsigned int) | |
GainControl | gain_control () | |
bool | is_auditioner () | |
bool | is_hidden () | |
bool | is_master () | |
bool | is_monitor () | |
bool | is_selected () | |
bool | isnil () | |
AutomationControl | master_send_enable_control () | |
MonitorProcessor | monitor_control () | |
MuteControl | mute_control () | |
AutomationControl | pan_azimuth_control () | |
AutomationControl | pan_elevation_control () | |
AutomationControl | pan_frontback_control () | |
AutomationControl | pan_lfe_control () | |
AutomationControl | pan_width_control () | |
PhaseControl | phase_control () | |
PresentationInfo | presentation_info_ptr () | |
AutomationControl | rec_enable_control () | |
AutomationControl | rec_safe_control () | |
bool | sameinstance (Stripable) | |
AutomationControl | send_enable_control (unsigned int) | |
AutomationControl | send_level_control (unsigned int) | |
std::string | send_name (unsigned int) | |
void | set_presentation_order (unsigned int, bool) | |
SoloControl | solo_control () | |
SoloIsolateControl | solo_isolate_control () | |
SoloSafeControl | solo_safe_control () | |
GainControl | trim_control () | |
Cast | ||
Route | to_route () |
Methods | ||
---|---|---|
std::string | name () | |
Cast | ||
Stateful | to_stateful () | |
StatefulDestructible | to_statefuldestructible () |
C‡: ARDOUR::Tempo
@@ -1590,26 +2848,45 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to CTempo Map - mapping of timecode to musical time. convert audio-samples, sample-rate to Bar/Beat/Tick, Meter/Tempo
Methods | ||
---|---|---|
void | add_meter (Meter, BBT_TIME) | |
void | add_tempo (Tempo, BBT_TIME) | |
MeterSection | add_meter (Meter, double, BBT_TIME, long, PositionLockStyle) | |
TempoSection | add_tempo (Tempo, double, long, Type, PositionLockStyle) | |
MeterSection | meter_section_at_beat (double) | |
MeterSection | meter_section_at_frame (long) | |
TempoSection | tempo_section_at_frame (long) |
C‡: ARDOUR::TempoSection
+is-a: ARDOUR:MetricSection
+ +A section of timeline with a certain Tempo.
Methods | ||
---|---|---|
double | c_func () |
Methods | ||
---|---|---|
double | pulse () | |
void | set_pulse (double) |
C‡: boost::shared_ptr< ARDOUR::Track >, boost::weak_ptr< ARDOUR::Track >
is-a: ARDOUR:Route
+A track is an route (bus) with a recordable diskstream and related objects relevant to tracking, playback and editing.
Specifically a track has regions and playlist objects.
Methods | ||
---|---|---|
Region | bounce (long, long, InterThreadInfo&, Processor, bool) | |
Region | bounce (InterThreadInfo&) | |
bounce track from session start to session end to new region
Returns a new audio region (or nil in case of error) | ||
Region | bounce_range (long, long, InterThreadInfo&, Processor, bool) | |
Bounce the given range to a new audio region.
Returns a new audio region (or nil in case of error) | ||
bool | bounceable (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.
Returns true if the track can be bounced, or false otherwise. | ||
bool | can_record () | |
bool | isnil () | |
Playlist | playlist () | |
bool | record_enabled () | |
bool | record_safe () | |
bool | sameinstance (Track) | |
bool | set_name (std::string) | |
void | set_record_enabled (bool, GroupControlDisposition) | |
void | set_record_safe (bool, GroupControlDisposition) | |
Cast | ||
AudioTrack | to_audio_track () | |
MidiTrack | to_midi_track () | |
Methods | ||
bool | active () | |
int | add_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.
Returns 0 on success, non-0 on failure. | ||
bool | add_sidechain (Processor) | |
Amp | amp () | |
std::string | comment () | |
bool | customize_plugin_insert (Processor, unsigned int, ChanCount) | |
bool | customize_plugin_insert (Processor, unsigned int, ChanCount, ChanCount) | |
enable custom plugin-insert configuration
Returns true if successful | ||
Delivery | main_outs () | |
the signal processorat at end of the processing chain which produces output | ||
bool | muted () | |
ChanCount | n_inputs () | |
ChanCount | n_outputs () | |
Processor | nth_plugin (unsigned int) | |
Processor | nth_processor (unsigned int) | |
Processor | nth_send (unsigned int) | |
PeakMeter | peak_meter () | |
************************************************************* Pure interface begins here************************************************************* | ||
int | remove_processor (Processor, ProcessorStreams, bool) | |
remove plugin/processor
Returns 0 on success | ||
bool | remove_sidechain (Processor) | |
int | replace_processor (Processor, Processor, ProcessorStreams) | |
replace plugin/processor with another
Returns 0 on success | ||
bool | reset_plugin_insert (Processor) | |
reset plugin-insert configuration to default, disable customizations. This is equivalent to calling customize_plugin_insert (proc, 0, unused)
Returns true if successful | ||
void | set_active (bool, void*) | |
void | set_comment (std::string, void*) | |
void | set_meter_point (MeterPoint, bool) | |
bool | set_strict_io (bool) | |
bool | soloed () | |
bool | strict_io () | |
Cast | ||
Track | to_track () |
Methods | ||
---|---|---|
AutomationControl | comp_enable_control () | |
AutomationControl | comp_makeup_control () | |
AutomationControl | comp_mode_control () | |
std::string | comp_mode_name (unsigned int) | |
AutomationControl | comp_redux_control () | |
AutomationControl | comp_speed_control () | |
std::string | comp_speed_name (unsigned int) | |
AutomationControl | comp_threshold_control () | |
unsigned int | eq_band_cnt () | |
std::string | eq_band_name (unsigned int) | |
AutomationControl | eq_enable_control () | |
AutomationControl | eq_freq_control (unsigned int) | |
AutomationControl | eq_gain_control (unsigned int) | |
AutomationControl | eq_hpf_control () | |
AutomationControl | eq_q_control (unsigned int) | |
AutomationControl | eq_shape_control (unsigned int) | |
GainControl | gain_control () | |
bool | is_auditioner () | |
bool | is_hidden () | |
bool | is_master () | |
bool | is_monitor () | |
bool | is_selected () | |
AutomationControl | master_send_enable_control () | |
MonitorProcessor | monitor_control () | |
MuteControl | mute_control () | |
AutomationControl | pan_azimuth_control () | |
AutomationControl | pan_elevation_control () | |
AutomationControl | pan_frontback_control () | |
AutomationControl | pan_lfe_control () | |
AutomationControl | pan_width_control () | |
PhaseControl | phase_control () | |
PresentationInfo | presentation_info_ptr () | |
AutomationControl | rec_enable_control () | |
AutomationControl | rec_safe_control () | |
AutomationControl | send_enable_control (unsigned int) | |
AutomationControl | send_level_control (unsigned int) | |
std::string | send_name (unsigned int) | |
void | set_presentation_order (unsigned int, bool) | |
SoloControl | solo_control () | |
SoloIsolateControl | solo_isolate_control () | |
SoloSafeControl | solo_safe_control () | |
GainControl | trim_control () | |
Cast | ||
Route | to_route () |
Methods | ||
---|---|---|
std::string | name () | |
Cast | ||
Stateful | to_stateful () | |
StatefulDestructible | to_statefuldestructible () |
C‡: boost::shared_ptr< ARDOUR::UnknownProcessor >, boost::weak_ptr< ARDOUR::UnknownProcessor >
+is-a: ARDOUR:Processor
+ +A stub Processor that can be used in place of a `real' one that cannot be created for some reason; usually because it requires a plugin which is not present. UnknownProcessors are special-cased in a few places, notably in route configuration and signal processing, so that on encountering them configuration or processing stops.
When a Processor is missing from a Route, the following processors cannot be configured, as the missing Processor's output port configuration is unknown.
The main utility of the UnknownProcessor is that it allows state to be preserved, so that, for example, loading and re-saving a session on a machine without a particular plugin will not corrupt the session.
Methods | ||
---|---|---|
bool | isnil () | |
bool | sameinstance (UnknownProcessor) |
Methods | ||
---|---|---|
void | activate () | |
bool | active () | |
void | deactivate () | |
std::string | display_name () | |
Cast | ||
Amp | to_amp () | |
Automatable | to_automatable () | |
PluginInsert | to_insert () | |
IOProcessor | to_ioprocessor () | |
MonitorProcessor | to_monitorprocessor () | |
PeakMeter | to_peakmeter () | |
SideChain | to_sidechain () | |
UnknownProcessor | to_unknownprocessor () |
Methods | ||
---|---|---|
unsigned long | size () | |
LuaTable | table () |
Methods | ||
---|---|---|
std::string | http_get (std::string) | |
ProcessorVector | processor_selection (--MISSING (lua_State*)--) |
C‡: ArdourMarker
@@ -1899,6 +3276,17 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to CC‡: unsigned char*
+ +Methods | ||
---|---|---|
LuaMetaTable | array () | |
LuaTable | get_table () | |
unsigned char* | offset (unsigned int) | |
bool | sameinstance (unsigned char*) | |
void | set_table (LuaTable {unsigned char}) |
C‡: std::vector<double >
@@ -1921,8 +3309,25 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to CC‡: std::vector<float >
+ +Constructor | ||
---|---|---|
ℂ | C.FloatVector () | |
Methods | ||
LuaTable | add (LuaTable {float}) | |
float | at (unsigned long) | |
bool | empty () | |
LuaIter | iter () | |
void | push_back (float) | |
unsigned long | size () | |
LuaTable | table () |
C‡: int*
@@ -1930,6 +3335,8 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to CThis function disables a dash pattern that was set with set_dash()
C‡: LuaCairo::ImageSurface
+ +wrap RefPtr< Cairo::ImageSurface >
Image surfaces provide the ability to render to memory buffers either allocated by cairo or by the calling code. The supported image formats are those defined in Cairo::Format.
Constructor | ||
---|---|---|
ℂ | Cairo.ImageSurface (Format, int, int) | |
Methods | ||
Context | context () | |
Returns a context object to perform operations on the surface | ||
int | get_height () | |
Gets the height of the ImageSurface in pixels | ||
int | get_stride () | |
Returns the stride of the image surface in bytes (or 0 if surface is not an image surface). The stride is the distance in bytes from the beginning of one row of the image data to the beginning of the next row. | ||
int | get_width () | |
Gets the width of the ImageSurface in pixels | ||
void | set_as_source (Context, int, int) |
C‡: LuaCairo::PangoLayout
+ +Constructor | ||
---|---|---|
ℂ | Cairo.PangoLayout (Context, std::string) | |
Methods | ||
EllipsizeMode | get_ellipsize () | |
Gets the type of ellipsization being performed for layout. See set_ellipsize() Use is_ellipsized() to query whether any paragraphs were actually ellipsized. Returns The current ellipsization mode for layout. | ||
... | get_pixel_size (--lua--) | |
Determines the logical width and height of a Pango::Layout in device units. | ||
std::string | get_text () | |
Gets the text in the layout. The returned text should not be freed or modified. Returns The text in the layout. | ||
WrapMode | get_wrap () | |
Gets the wrap mode for the layout. Use is_wrapped() to query whether any paragraphs were actually wrapped. Returns Active wrap mode. | ||
bool | is_ellipsized () | |
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. | ||
bool | is_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. | ||
void | set_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.
| ||
void | set_markup (std::string) | |
Sets the layout text and attribute list from marked-up text (see markup format). Replaces the current text and attribute list.
| ||
void | set_text (std::string) | |
Set the text of the layout.
| ||
void | set_width (int) | |
Sets the width to which the lines of the Pango::Layout should wrap or ellipsized. The default value is -1: no width set.
| ||
void | set_wrap (WrapMode) | |
Sets the wrap mode; the wrap mode only has effect if a width is set on the layout with set_width(). To turn off wrapping, set the width to -1.
| ||
void | show_in_cairo_context (Context) |
C‡: Evoral::Beats
@@ -2060,14 +3516,17 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to CC‡: boost::shared_ptr< Evoral::Control >, boost::weak_ptr< Evoral::Control >
+Base class representing some kind of (automatable) control; a fader's gain, for example, or a compressor plugin's threshold.
The class knows the Evoral::Parameter that it is controlling, and has a list of values for automation.
Methods | ||
---|---|---|
bool | isnil () | |
ControlList | list () | |
bool | sameinstance (Control) |
C‡: boost::shared_ptr< Evoral::ControlList >, boost::weak_ptr< Evoral::ControlList >
+A list (sequence) of time-stamped values for a control
Methods | ||
---|---|---|
void | add (double, double, bool, bool) | |
bool | isnil () | |
LuaTable(double, ...) | rt_safe_eval (double, bool&) | |
realtime safe version of eval, may fail if read-lock cannot be taken
Returns parameter value | ||
bool | sameinstance (ControlList) | |
void | set_interpolation (InterpolationStyle) | |
set the interpolation style of the automation data
| ||
void | thin (double) |
Methods | ||
---|---|---|
bool | isnil () | |
bool | sameinstance (ControlSet) |
C‡: Evoral::Event<long>
@@ -2107,6 +3568,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to CC‡: Evoral::MIDIEvent<long>
@@ -2115,8 +3577,8 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to CMethods | ||
---|---|---|
unsigned char | channel () | |
unsigned char | set_channel () | |
unsigned char | set_type () | |
void | set_channel (unsigned char) | |
void | set_type (unsigned char) | |
unsigned char | type () |
C‡: Evoral::Parameter
@@ -2179,11 +3642,18 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to CMethods | ||
---|---|---|
bool | open_uri (std::string) | |
bool | open_uri (std::string) |
C‡: Command
is-a: PBD:StatefulDestructible
-Base class for objects with saveable and undoable state with destruction notification
Base class for Undo/Redo commands and changesets
Methods | ||
---|---|---|
std::string | name () | |
Methods | ||
void | clear_changes () | |
Forget about any changes to this object's properties | ||
ID | id () | |
OwnedPropertyList | properties () |
C‡: PBD::Configuration
+is-a: PBD:Stateful
+ +Base class for objects with saveable and undoable state
This class object is only used indirectly as return-value and function-parameter. It provides no methods by itself.
+Methods | ||
---|---|---|
void | clear_changes () | |
Forget about any changes to this object's properties | ||
ID | id () | |
OwnedPropertyList | properties () |
C‡: boost::shared_ptr< PBD::Controllable >, boost::weak_ptr< PBD::Controllable >
is-a: PBD:StatefulDestructiblePtr
+This is a pure virtual class to represent a scalar control.
Note that it contains no storage/state for the controllable thing that it represents. Derived classes must provide set_value()/get_value() methods, which will involve (somehow) an actual location to store the value.
In essence, this is an interface, not a class.
Without overriding upper() and lower(), a derived class will function as a control whose value can range between 0 and 1.0.
Methods | ||
---|---|---|
double | get_value () | |
bool | isnil () | |
std::string | name () | |
bool | sameinstance (Controllable) |
Methods | ||
---|---|---|
void | clear_changes () | |
Forget about any changes to this object's properties | ||
ID | id () | |
OwnedPropertyList | properties () |
C‡: PBD::ID
+a unique ID to identify objects numerically
Constructor | ||
---|---|---|
ℂ | PBD.ID (std::string) | |
Methods | ||
std::string | to_s () |
C‡: std::vector<PBD::ID >
+ +Constructor | ||
---|---|---|
ℂ | PBD.IdVector () | |
Methods | ||
LuaTable | add (LuaTable {ID}) | |
ID | at (unsigned long) | |
bool | empty () | |
LuaIter | iter () | |
void | push_back (ID) | |
unsigned long | size () | |
LuaTable | table () |
C‡: PBD::RingBufferNPT<unsigned char>
+ +Constructor | ||
---|---|---|
ℂ | PBD.RingBuffer8 (unsigned long) | |
Methods | ||
void | increment_read_ptr (unsigned long) | |
void | increment_write_ptr (unsigned long) | |
unsigned long | read (unsigned char*, unsigned long) | |
unsigned long | read_space () | |
void | reset () | |
unsigned long | write (unsigned char*, unsigned long) | |
unsigned long | write_one (unsigned char) | |
unsigned long | write_space () |
C‡: PBD::RingBufferNPT<float>
+ +Constructor | ||
---|---|---|
ℂ | PBD.RingBufferF (unsigned long) | |
Methods | ||
void | increment_read_ptr (unsigned long) | |
void | increment_write_ptr (unsigned long) | |
unsigned long | read (FloatArray, unsigned long) | |
unsigned long | read_space () | |
void | reset () | |
unsigned long | write (FloatArray, unsigned long) | |
unsigned long | write_one (float) | |
unsigned long | write_space () |
C‡: PBD::RingBufferNPT<int>
+ +Constructor | ||
---|---|---|
ℂ | PBD.RingBufferI (unsigned long) | |
Methods | ||
void | increment_read_ptr (unsigned long) | |
void | increment_write_ptr (unsigned long) | |
unsigned long | read (IntArray, unsigned long) | |
unsigned long | read_space () | |
void | reset () | |
unsigned long | write (IntArray, unsigned long) | |
unsigned long | write_one (int) | |
unsigned long | write_space () |
C‡: PBD::Stateful
@@ -2230,6 +3782,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to CForget about any changes to this object's properties
Forget about any changes to this object's properties
C‡: boost::shared_ptr< PBD::StatefulDestructible >, boost::weak_ptr< PBD::StatefulDestructible >
is-a: PBD:StatefulPtr
+Base class for objects with saveable and undoable state with destruction notification
Methods | ||
---|---|---|
bool | isnil () | |
bool | sameinstance (StatefulDestructible) |
Methods | ||
---|---|---|
void | clear_changes () | |
Forget about any changes to this object's properties | ||
ID | id () | |
OwnedPropertyList | properties () |
Forget about any changes to this object's properties
C‡: boost::shared_ptr< PBD::Stateful >, boost::weak_ptr< PBD::Stateful >
+Base class for objects with saveable and undoable state
Methods | ||
---|---|---|
void | clear_changes () | |
Forget about any changes to this object's properties | ||
ID | id () | |
bool | isnil () | |
OwnedPropertyList | properties () | |
bool | sameinstance (Stateful) |
C‡: XMLNode
@@ -2308,6 +3869,170 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to CC‡: _VampPlugin::Vamp::Plugin
+is-a: Vamp:PluginBase
+ +Methods | ||
---|---|---|
FeatureSet | getRemainingFeatures () | |
FeatureSet | process (--MISSING (float**)--, RealTime) |
Methods | ||
---|---|---|
std::string | getCopyright () | |
std::string | getCurrentProgram () | |
std::string | getDescription () | |
std::string | getIdentifier () | |
std::string | getMaker () | |
std::string | getName () | |
float | getParameter (std::string) | |
ParameterList | getParameterDescriptors () | |
int | getPluginVersion () | |
StringVector | getPrograms () | |
std::string | getType () | |
void | selectProgram (std::string) | |
void | setParameter (std::string, float) |
C‡: _VampPlugin::Vamp::Plugin::Feature
+ +Data Members | ||
---|---|---|
Vamp:RealTime | duration | |
bool | hasDuration | |
bool | hasTimestamp | |
std::string | label | |
Vamp:RealTime | timestamp | |
C:FloatVector | values |
C‡: std::vector<_VampPlugin::Vamp::Plugin::Feature >
+ +Constructor | ||
---|---|---|
ℂ | Vamp.Plugin.FeatureList () | |
Methods | ||
LuaTable | add (LuaTable {Feature}) | |
Feature | at (unsigned long) | |
bool | empty () | |
LuaIter | iter () | |
void | push_back (Feature) | |
unsigned long | size () | |
LuaTable | table () |
C‡: std::map<int, std::vector<_VampPlugin::Vamp::Plugin::Feature > > > >
+ +Constructor | ||
---|---|---|
ℂ | Vamp.Plugin.FeatureSet () | |
Methods | ||
LuaTable | add (LuaTable {Feature}) | |
void | clear () | |
unsigned long | count (int) | |
bool | empty () | |
LuaIter | iter () | |
unsigned long | size () | |
LuaTable | table () |
C‡: _VampPlugin::Vamp::Plugin::OutputDescriptor
+ +Data Members | ||
---|---|---|
unsigned long | binCount | |
C:StringVector | binNames | |
std::string | description | |
bool | hasDuration | |
bool | hasFixedBinCount | |
bool | hasKnownExtents | |
std::string | identifier | |
bool | isQuantized | |
float | maxValue | |
float | minValue | |
float | quantizeStep | |
float | sampleRate | |
_VampPlugin.Vamp.Plugin.OutputDescriptor.SampleType | sampleType | |
std::string | unit |
C‡: std::vector<_VampPlugin::Vamp::Plugin::OutputDescriptor >
+ +Constructor | ||
---|---|---|
ℂ | Vamp.Plugin.OutputList () | |
Methods | ||
LuaTable | add (LuaTable {OutputDescriptor}) | |
OutputDescriptor | at (unsigned long) | |
bool | empty () | |
LuaIter | iter () | |
void | push_back (OutputDescriptor) | |
unsigned long | size () | |
LuaTable | table () |
C‡: _VampPlugin::Vamp::PluginBase
+ +Methods | ||
---|---|---|
std::string | getCopyright () | |
std::string | getCurrentProgram () | |
std::string | getDescription () | |
std::string | getIdentifier () | |
std::string | getMaker () | |
std::string | getName () | |
float | getParameter (std::string) | |
ParameterList | getParameterDescriptors () | |
int | getPluginVersion () | |
StringVector | getPrograms () | |
std::string | getType () | |
void | selectProgram (std::string) | |
void | setParameter (std::string, float) |
C‡: _VampPlugin::Vamp::PluginBase::ParameterDescriptor
+ +Data Members | ||
---|---|---|
float | defaultValue | |
std::string | description | |
std::string | identifier | |
bool | isQuantized | |
float | maxValue | |
float | minValue | |
std::string | name | |
float | quantizeStep | |
std::string | unit | |
C:StringVector | valueNames |
C‡: std::vector<_VampPlugin::Vamp::PluginBase::ParameterDescriptor >
+ +Constructor | ||
---|---|---|
ℂ | Vamp.PluginBase.ParameterList () | |
Methods | ||
LuaTable | add (LuaTable {ParameterDescriptor}) | |
ParameterDescriptor | at (unsigned long) | |
bool | empty () | |
LuaIter | iter () | |
void | push_back (ParameterDescriptor) | |
unsigned long | size () | |
LuaTable | table () |
C‡: _VampPlugin::Vamp::RealTime
+ +Constructor | ||
---|---|---|
ℂ | Vamp.RealTime (int, int) | |
Methods | ||
int | msec () | |
std::string | toString () | |
int | usec () |