X-Git-Url: http://shamusworld.gotdns.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=include%2Fclass-reference.html;h=6d324b8cb7dc2dd6133ea8bf209ad8fa1dd2404e;hb=bdabd959ccc29a7eddeccfd7922425101b3f9ef7;hp=3bdba04d9689001a4092337994a9871908a5a02a;hpb=7be4f507991a0b87174a0e78831a4e7e9e96bcbe;p=ardour-manual
diff --git a/include/class-reference.html b/include/class-reference.html
index 3bdba04..6d324b8 100644
--- a/include/class-reference.html
+++ b/include/class-reference.html
@@ -32,10 +32,10 @@ Operations are performed on objects. One gets a reference to an object and then
e.g obj = Session:route_by_name("Audio") obj:set_name("Guitar")
.
-Lua automatically follows C++ class inheritance. e.g one can directly call all SessionObject and Route methods on Track object. However lua does not automatically promote objects. A Route object which just happens to be a Track needs to be explicily cast to a Track. Methods for casts are provided with each class. Note that the cast may fail and return a nil reference. +Lua automatically follows C++ class inheritance. e.g one can directly call all SessionObject and Route methods on Track object. However lua does not automatically promote objects. A Route object which just happens to be a Track needs to be explicitly cast to a Track. Methods for casts are provided with each class. Note that the cast may fail and return a nil reference.
-Likewise multiple inheritance is a non-trivial issue in lua. To avoid performance penalties involved with lookups, explicit casts are required in this case. One example is ARDOUR:SessionObject which is-a StatefulDestructible which inhertis from both Stateful and Destructible. +Likewise multiple inheritance is a non-trivial issue in lua. To avoid performance penalties involved with lookups, explicit casts are required in this case. One example is ARDOUR:SessionObject which is-a StatefulDestructible which inherits from both Stateful and Destructible.
Object lifetimes are managed by the Session. Most Objects cannot be directly created, but one asks the Session to create or destroy them. This is mainly due to realtime constrains: @@ -95,7 +95,7 @@ print (rv, ref[1], ref[2])
Libardour makes extensive use of reference counted boost::shared_ptr
to manage lifetimes.
-The Lua bindings provide a complete abstration of this. There are no pointers in lua.
+The Lua bindings provide a complete abstraction of this. There are no pointers in lua.
For example a ARDOUR:Route is a pointer in C++, but lua functions operate on it like it was a class instance.
@@ -115,12 +115,18 @@ This is not unlike a = nil a:test()
which results in en error "
From the lua side of things there is no distinction between weak and shared pointers. They behave identically. -Below they're inidicated in orange and have an arrow to indicate the pointer type. +Below they're indicated in orange and have an arrow to indicate the pointer type. Pointer Classes cannot be created in lua scripts. It always requires a call to C++ to create the Object and obtain a reference to it.
Methods | ||
---|---|---|
RCConfiguration | config () |
C‡: boost::shared_ptr< ARDOUR::Amp >, boost::weak_ptr< ARDOUR::Amp >
is-a: ARDOUR:Processor
@@ -130,7 +136,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to CSideChain | to_sidechain () | |
UnknownProcessor | to_unknownprocessor () |
Methods | ||||||
---|---|---|---|---|---|---|
std::string | name () | |||||
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). | ||||||
int | set_device_name (std::string) | |||||
Set the name of the device to be used | ||||||
int | set_driver (std::string) | |||||
Returns zero if the backend can successfully use Should not be used unless the backend returns true from requires_driver_selection()
| ||||||
Returns zero if the backend can successfully use Should not be used unless the backend returns true from requires_driver_selection()
| ||||||
int | set_input_device_name (std::string) | |||||
Set the name of the input device to be used if using separate input/output devices. use_separate_input_and_output_devices() | ||||||
int | set_output_device_name (std::string) | |||||
Methods | ||||||
void | apply_gain (float, long) | |||||
bool | check_silence (unsigned int, unsigned int&) | |||||
check buffer for silence
Returns true if all samples are zero | ||||||
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
| ||||||
silence buffer
|
C‡: ARDOUR::AudioEngine
@@ -261,7 +264,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to Cname | Full or short name of port |
---|
Returns Corresponding Port or 0.
Returns Corresponding Port or 0.
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) | |||||
long | find_next_transient (long, int) | |||||
void | lower_region (Region) | |||||
void | lower_region_to_bottom (Region) | |||||
unsigned int | n_regions () | |||||
RegionListPtr | region_list () | |||||
RegionListPtr | regions_at (long) | |||||
RegionListPtr | regions_touched (long, long) | |||||
Returns regions which have some part within this range. | ||||||
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) | |||||
AudioPlaylist | to_audioplaylist () | |||||
MidiPlaylist | to_midiplaylist () |
Methods | ||||
---|---|---|---|---|
std::string | name () |
Methods | ||
---|---|---|
bool | isnil () | |
bool | sameinstance (AudioPort) |
bool | connected () | |||
Returns true if this port is connected to anything | ||||
bool | connected_to (std::string) | |||
Returns true if this port is connected to o, otherwise false. | ||||
Returns true if this port is connected to o, otherwise false. | ||||
int | disconnect (std::string) | |||
int | disconnect_all () | |||
std::string | name () | |||
Returns the maximum (linear) amplitude of the region, or a -ve number if the Progress object reports that the process was cancelled. | ||||
double | rms (Progress) | |||
Returns the maximum (rms) signal power of the region, or a -1 if the Progress object reports that the process was cancelled. | ||||
bool | sameinstance (AudioRegion) | |||
float | scale_amplitude () | |||
LuaTable(int, ...) | separate_by_channel (RegionVector&) | |||
void | set_scale_amplitude (float) |
Set the region's sync point.
absolute_pos | Session time. |
---|
Set the region's sync point.
Returns Sync position in session time
Methods | ||
---|---|---|
std::string | name () | |
long | read (FloatArray, long, long, int) | |
long | readable_length () | |
long | readable_length () | |
bool | sameinstance (AudioSource) | |
bool | sameinstance (AudioSource) | |
float | sample_rate () | |
Cast | ||
Readable | to_readable () | |
bool | writable () | |
Cast | ||
AudioSource | to_audiosource () | |
FileSource | to_filesource () | |
MidiSource | to_midisource () |
Methods | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
std::string | name () |
Methods | ||
---|---|---|
bool | isnil () | |
bool | sameinstance (AudioTrack) |
Methods | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
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) | ||||||||||||
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) | ||||||||||||
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. | ||||||||||||
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 | set_name (std::string) | |||||||||||
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. | ||||||||||||
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, ChanCount) | |||||||||||
enable custom plugin-insert configuration
Returns true if successful | ||||||||||||
enable custom plugin-insert configuration
Returns true if successful | ||||||||||||
IO | input () | |||||||||||
Delivery | main_outs () | |||||||||||
the signal processorat at end of the processing chain which produces output | ||||||||||||
the signal processor at at end of the processing chain which produces output | ||||||||||||
bool | muted () | |||||||||||
ChanCount | n_inputs () | |||||||||||
ChanCount | n_outputs () | |||||||||||
PeakMeter | peak_meter () | |||||||||||
************************************************************* Pure interface begins here************************************************************* | ||||||||||||
int | remove_processor (Processor, ProcessorStreams, bool) | |||||||||||
remove plugin/processor
Returns 0 on success | ||||||||||||
remove plugin/processor
Returns 0 on success | ||||||||||||
int | remove_processors (ProcessorList, ProcessorStreams) | |||||||||||
bool | remove_sidechain (Processor) | |||||||||||
int | reorder_processors (ProcessorList, ProcessorStreams) | |||||||||||
int | replace_processor (Processor, Processor, ProcessorStreams) | |||||||||||
replace plugin/processor with another
Returns 0 on success | ||||||||||||
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 | ||||||||||||
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) | |||||||||||
Amp | trim () | |||||||||||
Cast | ||||||||||||
Automatable | to_automatable () | |||||||||||
Slavable | to_slavable () | |||||||||||
Track | to_track () |
Methods | ||
---|---|---|
std::string | name () | |
Methods | ||
AutomationControl | automation_control (Parameter, bool) | |
bool | isnil () | |
bool | sameinstance (Automatable) | |
Cast | ||
Slavable | to_slavable () |
C‡: boost::shared_ptr< ARDOUR::AutomatableSequence<Evoral::Beats> >, boost::weak_ptr< ARDOUR::AutomatableSequence<Evoral::Beats> >
@@ -689,7 +697,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to CMethods | ||
---|---|---|
bool | isnil () | |
bool | sameinstance (AutomatableSequence) | |
Cast | ||
Sequence | to_sequence () |
Methods | ||
---|---|---|
AutomationControl | automation_control (Parameter, bool) | |
Cast | ||
Slavable | to_slavable () |
C‡: boost::shared_ptr< ARDOUR::AutomationControl >, boost::weak_ptr< ARDOUR::AutomationControl >
@@ -707,20 +716,18 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to CGet the current effective `user' value based on automation state
Get and Set `internal' value
All derived classes must implement this.
Basic derived classes will ignore
group_override, | but more sophisticated children, notably those that proxy the value setting logic via an object that is aware of group relationships between this control and others, will find it useful. |
---|
Get and Set `internal' value
All derived classes must implement this.
Basic derived classes will ignore
C‡: boost::shared_ptr< ARDOUR::AutomationList >, boost::weak_ptr< ARDOUR::AutomationList >
+is-a: Evoral:ControlList
AutomationList is a stateful wrapper around Evoral::ControlList. It includes session-specifics (such as automation state), control logic (e.g. touch, signals) and acts as proxy to the underlying ControlList which holds the actual data.
XMLNode | get_state () | |
bool | isnil () | |
Command | memento_command (XMLNode, XMLNode) | |
bool | sameinstance (AutomationList) | |
bool | touch_enabled () | |
bool | touching () | |
bool | writing () | |
Stateful | to_stateful () | |
StatefulDestructible | to_statefuldestructible () |
Methods | ||
---|---|---|
void | add (double, double, bool, bool) | |
add automation events
| ||
void | clear (double, double) | |
remove all automation events between the given time range
| ||
void | clear_list () | |
double | eval (double) | |
query value at given time (takes a read-lock, not safe while writing automation)
Returns parameter value | ||
EventList | events () | |
bool | in_write_pass () | |
InterpolationStyle | interpolation () | |
query interpolation style of the automation data Returns Interpolation Style | ||
LuaTable(double, ...) | rt_safe_eval (double, bool&) | |
realtime safe version of eval, may fail if read-lock cannot be taken
Returns parameter value | ||
bool | set_interpolation (InterpolationStyle) | |
set the interpolation style of the automation data. This will fail when asking for Logarithmic scale and min,max crosses 0 or Exponential scale with min != 0.
Returns true if style change was successful | ||
void | thin (double) | |
Thin the number of events in this list. The thinning factor corresponds to the area of a triangle computed between three points in the list (time-difference * value-difference). If the area is large, it indicates significant non-linearity between the points. Time is measured in samples, value is usually normalized to 0..1. During automation recording we thin the recorded points using this value. If a point is sufficiently co-linear with its neighbours (as defined by the area of the triangle formed by three of them), we will not include it in the list. The larger the value, the more points are excluded, so this effectively measures the amount of thinning to be done.
| ||
void | truncate_end (double) | |
truncate the event list after the given time
| ||
void | truncate_start (double) | |
truncate the event list to the given time
|
C‡: std::vector<ARDOUR::AudioBackendInfo const* >
@@ -766,16 +798,28 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to CC‡: ARDOUR::BeatsFramesConverter
+ +Converter between quarter-note beats and frames. Takes distances in quarter-note beats or frames from some origin (supplied to the constructor in frames), and converts them to the opposite unit, taking tempo changes into account.
Constructor | ||
---|---|---|
ℂ | ARDOUR.BeatsFramesConverter (TempoMap, long) | |
Methods | ||
Beats | from (long) | |
Convert B time to A time (A from B) | ||
long | to (Beats) | |
Convert A time to B time (A to B) |
C‡: ARDOUR::BufferSet
-A set of buffers of various types.
These are mainly accessed from Session and passed around as scratch buffers (eg as parameters to run() methods) to do in-place signal processing.
There are two types of counts associated with a BufferSet - available, and the 'use count'. Available is the actual number of allocated buffers (and so is the maximum acceptable value for the use counts).
The use counts are how things determine the form of their input and inform others the form of their output (eg what they did to the BufferSet). Setting the use counts is realtime safe.
A set of buffers of various types.
These are mainly accessed from Session and passed around as scratch buffers (e.g. as parameters to run() methods) to do in-place signal processing.
There are two types of counts associated with a BufferSet - available, and the 'use count'. Available is the actual number of allocated buffers (and so is the maximum acceptable value for the use counts).
The use counts are how things determine the form of their input and inform others the form of their output (e.g. what they did to the BufferSet). Setting the use counts is realtime safe.
Methods | ||
---|---|---|
ChanCount | count () | |
AudioBuffer | get_audio (unsigned long) | |
MidiBuffer | get_midi (unsigned long) | |
bool | sameinstance (BufferSet) |
C‡: ARDOUR::ChanCount
@@ -784,10 +828,10 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to CConstructor | ||||||
---|---|---|---|---|---|---|
ℂ | ARDOUR.ChanCount (DataType, unsigned int) | |||||
Convenience constructor for making single-typed streams (mono, stereo, midi, etc)
| ||||||
Convenience constructor for making single-typed streams (mono, stereo, midi, etc)
| ||||||
Methods | ||||||
unsigned int | get (DataType) | |||||
query channel count for given type
Returns channel count for given type | ||||||
query channel count for given type
Returns channel count for given type | ||||||
unsigned int | n_audio () | |||||
query number of audio channels Returns number of audio channels | ||||||
unsigned int | n_midi () | |||||
void | reset () | |||||
zero count of all data types | ||||||
void | set (DataType, unsigned int) | |||||
set channel count for given type
| ||||||
set channel count for given type
|
C‡: ARDOUR::ChanMapping
@@ -809,12 +853,12 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to Cget buffer mapping for given data type and pin
from | numeric source id |
---|---|
type | data type |
Returns mapped buffer number (or ChanMapping::Invalid)
get 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
from | numeric source id |
---|---|
to | buffer |
type | data type |
set buffer mapping for given data type
C‡: std::list<boost::shared_ptr<ARDOUR::AutomationControl> >
@@ -862,15 +906,15 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to Cnon-linear power-scale meter deflection
power | signal power (dB) |
---|
Returns deflected value
non-linear power-scale meter deflection
Returns deflected value
non-linear power-scale meter deflection
coeff | signal value |
---|
Returns deflected value
non-linear power-scale meter deflection
Returns deflected value
lua wrapper to memset()
matrix multiply multiply every sample of `data' with the corresponding sample at `mult'.
data | multiplicand |
---|---|
mult | multiplicand |
n_samples | number of samples in data and mmult |
matrix multiply multiply every sample of `data' with the corresponding sample at `mult'.
Constructor | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
ℂ | ARDOUR.DSP.Biquad (double) | |||||||||
Instantiate Biquad Filter
| ||||||||||
Instantiate Biquad Filter
| ||||||||||
Methods | ||||||||||
void | compute (Type, double, double, double) | |||||||||
setup filter, compute coefficients
| ||||||||||
setup filter, compute coefficients
| ||||||||||
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) | ||||||||||
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) | |||||||||
process audio data
| ||||||||||
process audio data
|
C‡: ARDOUR::DSP::DspShm
@@ -903,17 +947,17 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C[re] allocate memory in host's memory space
s | size, total number of float or integer elements to store. |
---|
[re] allocate memory in host's memory space
atomically read integer at offset
This involves a memory barrier. This call is intended for buffers which are shared with another instance.
off | offset in shared memory region |
---|
Returns value at offset
atomically read integer at offset
This involves a memory barrier. This call is intended for buffers which are shared with another instance.
Returns value at offset
atomically set integer at offset
This involves a memory barrier. This call is intended for buffers which are shared with another instance.
off | offset in shared memory region |
---|---|
val | value to set |
atomically set integer at offset
This involves a memory barrier. This call is intended for buffers which are shared with another instance.
clear memory (set to zero)
access memory as float array
off | offset in shared memory region |
---|
Returns float[]
access memory as float array
Returns float[]
access memory as integer array
off | offset in shared memory region |
---|
Returns int_32_t[]
access memory as integer array
Returns int_32_t[]
C‡: ARDOUR::DSP::FFTSpectrum
@@ -926,7 +970,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to Cprocess current data in buffer
query
b | the frequency bin 0 .. window_size / 2 |
---|---|
norm | gain factor (set equal to for 1/f normalization) |
Returns signal power at given bin (in dBFS)
query
Returns signal power at given bin (in dBFS)
Constructor | ||||||||
---|---|---|---|---|---|---|---|---|
ℂ | ARDOUR.DSP.LowPass (double, float) | |||||||
instantiate a LPF
| ||||||||
instantiate a LPF
| ||||||||
Methods | ||||||||
void | ctrl (FloatArray, float, unsigned int) | |||||||
filter control data This is useful for parameter smoothing.
| ||||||||
filter control data This is useful for parameter smoothing.
| ||||||||
void | proc (FloatArray, unsigned int) | |||||||
process audio data
| ||||||||
process audio data
| ||||||||
void | reset () | |||||||
reset filter state | ||||||||
void | set_cutoff (float) | |||||||
update filter cut-off frequency
| ||||||||
update filter cut-off frequency
|
C‡: ARDOUR::DataType
@@ -973,7 +1017,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to CSideChain | to_sidechain () | |
UnknownProcessor | to_unknownprocessor () |
Methods | ||
---|---|---|
std::string | name () | |
unsigned long | size () | |
LuaTable | table () |
C‡: ARDOUR::DoubleBeatsFramesConverter
+ +Converter between quarter-note beats and frames. Takes distances in quarter-note beats or frames from some origin (supplied to the constructor in frames), and converts them to the opposite unit, taking tempo changes into account.
Constructor | ||
---|---|---|
ℂ | ARDOUR.DoubleBeatsFramesConverter (TempoMap, long) | |
Methods | ||
double | from (long) | |
Convert B time to A time (A from B) | ||
long | to (double) | |
Convert A time to B time (A to B) |
C‡: std::list<Evoral::ControlEvent* >
+ +Constructor | ||
---|---|---|
ℂ | ARDOUR.EventList () | |
Methods | ||
ControlEvent | back () | |
bool | empty () | |
ControlEvent | front () | |
LuaIter | iter () | |
void | reverse () | |
unsigned long | size () | |
LuaTable | table () |
C‡: boost::shared_ptr< ARDOUR::FileSource >, boost::weak_ptr< ARDOUR::FileSource >
+is-a: ARDOUR:Source
+ +A source associated with a file on disk somewhere
Methods | ||
---|---|---|
unsigned short | channel () | |
float | gain () | |
bool | isnil () | |
std::string | origin () | |
std::string | path () | |
std::string | take_id () | |
bool | within_session () |
Methods | ||
---|---|---|
std::string | ancestor_name () | |
bool | can_be_analysed () | |
bool | destructive () | |
bool | empty () | |
bool | has_been_analysed () | |
long | length (long) | |
long | natural_position () | |
long | timeline_position () | |
long | timestamp () | |
int | use_count () | |
bool | used () | |
bool | writable () | |
Cast | ||
AudioSource | to_audiosource () | |
FileSource | to_filesource () | |
MidiSource | to_midisource () |
Methods | ||
---|---|---|
std::string | name () | |
Cast | ||
Stateful | to_stateful () | |
StatefulDestructible | to_statefuldestructible () |
C‡: ARDOUR::FluidSynth
Constructor | ||||
---|---|---|---|---|
ℂ | ARDOUR.FluidSynth (float, int) | |||
instantiate a Synth
| ||||
instantiate a Synth
| ||||
Methods | ||||
bool | load_sf2 (std::string) | |||
bool | midi_event (unsigned char*, unsigned long) |
C‡: boost::shared_ptr< ARDOUR::GainControl >, boost::weak_ptr< ARDOUR::GainControl >
-is-a: ARDOUR:SlavableAutomationControl,
+is-a: ARDOUR:SlavableAutomationControl
A PBD::Controllable with associated automation data (AutomationList)
Methods | ||
---|---|---|
bool | isnil () | |
bool | sameinstance (GainControl) |
Methods | ||||
---|---|---|---|---|
void | add_master (AutomationControl, bool) | |||
void | add_master (AutomationControl) | |||
void | clear_masters () | |||
int | get_boolean_masters () | |||
double | get_masters_value () | |||
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
| ||||
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) | |||
void | stop_touch (double) | |||
bool | writable () | |||
Cast | ||||
Control | to_ctrl () | |||
SlavableAutomationControl | to_slavable () |
C‡: boost::shared_ptr< ARDOUR::IO >, boost::weak_ptr< ARDOUR::IO >
-is-a: ARDOUR:SessionObject
+is-a: ARDOUR:SessionObjectPtr
-A collection of ports (all input or all output) with connections.
An IO can contain ports of varying types, making routes/inserts/etc with varied combinations of types (eg MIDI and audio) possible.
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 (e.g. MIDI and audio) possible.
Methods | ||||||||
---|---|---|---|---|---|---|---|---|
bool | active () | |||||||
int | add_port (std::string, void*, DataType) | |||||||
Add a port.
| ||||||||
Add a port.
| ||||||||
AudioPort | audio (unsigned int) | |||||||
int | connect (Port, std::string, void*) | |||||||
int | disconnect (Port, std::string, void*) | |||||||
bool | physically_connected () | |||||||
Port | port_by_name (unsigned int) | |||||||
int | remove_port (Port, void*) | |||||||
bool | sameinstance (IO) |
Methods | ||
---|---|---|
std::string | name () | |
ChanCount | natural_input_streams () | |
ChanCount | natural_output_streams () | |
IO | output () | |
bool | sameinstance (IOProcessor) |
SideChain | to_sidechain () | |
UnknownProcessor | to_unknownprocessor () |
Methods | ||||||||
---|---|---|---|---|---|---|---|---|
std::string | name () | |||||||
int | move_to (long, unsigned int) | |||||||
std::string | name () | |||||||
int | set_end (long, bool, bool, unsigned int) | |||||||
Set end position.
| ||||||||
Set end position.
| ||||||||
int | set_length (long, long, bool, unsigned int) | |||||||
int | set_start (long, bool, bool, unsigned int) | |||||||
Set start position.
| ||||||||
Set start position.
| ||||||||
long | start () | |||||||
void | unlock () |
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.
frame | Frame to look for. |
---|---|
before | Filled in with the position of the last `mark' before `frame' (or max_framepos if none exists) |
after | Filled in with the position of the next `mark' after `frame' (or max_framepos if none exists) |
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.
A convenience function to expand RGBA parameters from an integer
convert a Canvas::Color (uint32_t 0xRRGGBBAA) into double RGBA values which can be passed as parameters to Cairo::Context::set_source_rgba
Example:
local r, g, b, a = ARDOUR.LuaAPI.color_to_rgba (0x88aa44ff) cairo_ctx:set_source_rgba (ARDOUR.LuaAPI.color_to_rgba (0x11336699)
Returns 4 parameters: red, green, blue, alpha (in range 0..1)
get a plugin control parameter value
which | control port to query (starting at 0, including ports of type input and output) |
---|---|
ok | boolean variable contains true or false after call returned. to be checked by caller before using value. |
proc | Plugin-Insert |
Returns value
get a plugin control parameter value
Returns value
get a plugin control parameter value
proc | Plugin-Processor |
---|---|
which | control port to set (starting at 0, including ports of type input and output)) |
ok | boolean variable contains true or false after call returned. to be checked by caller before using value. |
Returns value
get a plugin control parameter value
Returns value
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)
create a new Lua Processor (Plugin)
s | Session Handle |
---|---|
p | Identifier or Name of the Processor |
Returns Processor object (may be nil)
create a new Lua Processor (Plugin)
Returns Processor object (may be nil)
create a new Plugin Instance
s | Session Handle |
---|---|
id | Plugin Name, ID or URI |
type | Plugin Type |
Returns Processor or nil
create a new Plugin Instance
Returns Processor or nil
search a Plugin
id | Plugin Name, ID or URI |
---|---|
type | Plugin Type |
Returns PluginInfo or nil if not found
search a Plugin
Returns PluginInfo or nil if not found
A convenience function to get a Automation Lists and ParamaterDescriptor for a given plugin control.
This is equivalent to the following lua code
function (processor, param_id) local plugininsert = processor:to_insert () @@ -1307,13 +1418,13 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C return ac:alist(), ac:to_ctrl():list(), t[2] end
Example usage: get the third input parameter of first plugin on the given route (Ardour starts counting at zero).
local al, cl, pd = ARDOUR.LuaAPI.plugin_automation (route:nth_plugin (0), 3)
Returns 3 parameters: AutomationList, ControlList, ParamaterDescriptor
reset a processor to its default values (only works for plugins )
This is a wrapper which looks up the Processor by plugin-insert.
proc | Plugin-Insert |
---|
Returns true on success, false when the processor is not a plugin
reset a processor to its default values (only works for plugins )
This is a wrapper which looks up the Processor by plugin-insert.
Returns true on success, false when the processor is not a plugin
Generic conversion from audio sample count to timecode. (TimecodeType, sample-rate, sample-pos)
set a plugin control-input parameter value
This is a wrapper around set_processor_param which looks up the Processor by plugin-insert.
which | control-input to set (starting at 0) |
---|---|
proc | Plugin-Insert |
value | value to set |
Returns true on success, false on error or out-of-bounds value
set a plugin control-input parameter value
This is a wrapper around set_processor_param which looks up the Processor by plugin-insert.
Returns true on success, false on error or out-of-bounds value
set a plugin control-input parameter value
proc | Plugin-Processor |
---|---|
which | control-input to set (starting at 0) |
value | value to set |
Returns true on success, false on error or out-of-bounds value
set a plugin control-input parameter value
Returns true on success, false on error or out-of-bounds value
Generic conversion from timecode to audio sample count. (TimecodeType, sample-rate, hh, mm, ss, ff)
high-level abstraction to process a single channel of the given Readable.
If the plugin is not yet initialized, initialize() is called.
if is not nil, it is called with the immediate Vamp::Plugin::Features on every process call.
r | readable |
---|---|
channel | channel to process |
fn | lua callback function |
Returns 0 on success
high-level abstraction to process a single channel of the given Readable.
If the plugin is not yet initialized, initialize() is called.
if is not nil, it is called with the immediate Vamp::Plugin::Features on every process call.
Returns 0 on success
initialize the plugin for use with analyze().
This is equivalent to plugin():initialise (1, ssiz, bsiz) and prepares a plugin for analyze. (by preferred step and block sizes are used. if the plugin does not specify them or they're larger than 8K, both are set to 1024)
Manual initialization is only required to set plugin-parameters which depend on prior initialization of the plugin.
vamp:reset () vamp:initialize () @@ -1335,7 +1446,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to CStringVector list_plugins () Plugin plugin () - FeatureSet process (FloatArrayVector, RealTime) + process given array of audio-samples.
This is a lua-binding for vamp:plugin():process ()
d audio-data, the vector must match the configured channel count and hold a complete buffer for every channel as set during plugin():initialise() rt timestamp matching the provided buffer. Returns features extracted from that data (if the plugin is causal)
process given array of audio-samples.
This is a lua-binding for vamp:plugin():process ()
- d
- audio-data, the vector must match the configured channel count and hold a complete buffer for every channel as set during plugin():initialise()
- rt
- timestamp matching the provided buffer.
Returns features extracted from that data (if the plugin is causal)
void reset () @@ -1346,10 +1457,10 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C call plugin():reset() and clear intialization flag
Constructor | ||||
---|---|---|---|---|
ℂ | ARDOUR.LuaOSC.Address (std::string) | |||
Construct a new OSC transmitter object
| ||||
Construct a new OSC transmitter object
| ||||
Methods | ||||
... | send (--lua--) | |||
Transmit 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. | ||||
Transmit 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‡: boost::shared_ptr< ARDOUR::LuaProc >, boost::weak_ptr< ARDOUR::LuaProc >
@@ -1359,7 +1470,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to CMethods | ||
---|---|---|
bool | isnil () | |
bool | sameinstance (LuaProc) | |
DspShm | shmem () | |
LuaTableRef | table () |
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.
Clear (eg zero, or empty) buffer
Clear (e.g. zero, or empty) buffer
Start a new NoteDiff command.
This has no side-effects on the model or Session, the returned command can be held on to for as long as the caller wishes, or discarded without formality, until apply_command is called and ownership is taken.
Methods | ||
---|---|---|
AutomationControl | automation_control (Parameter, bool) | |
Cast | ||
Slavable | to_slavable () |
C‡: ARDOUR::MidiModel::DiffCommand
@@ -1533,7 +1647,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to CMethods | ||
---|---|---|
bool | isnil () | |
bool | sameinstance (MidiPlaylist) | |
void | set_note_mode (NoteMode) |
gap | from the beginning of the region to the next beginning |
---|
gap | from the beginning of the region to the next beginning |
---|---|
end | the first frame that does _not_ contain a duplicated frame |
start | Range start. |
---|---|
end | Range end. |
Returns regions which have some part within this range.
Returns regions which have some part within this range.
Methods | ||
---|---|---|
std::string | name () | |
MidiBuffer | get_midi_buffer (unsigned int) | |
bool | input_active () | |
bool | isnil () | |
bool | sameinstance (MidiPort) | |
void | set_input_active (bool) |
Returns true if this port is connected to anything
o | Port name |
---|
Returns true if this port is connected to o, otherwise false.
Returns true if this port is connected to o, otherwise false.
Set the region's sync point.
absolute_pos | Session time. |
---|
Set the region's sync point.
Returns Sync position in session time
Methods | ||
---|---|---|
std::string | name () | |
bool | isnil () | |
long | length (long) | |
MidiModel | model () | |
bool | sameinstance (MidiSource) |
bool | writable () | |
Cast | ||
---|---|---|
AudioSource | to_audiosource () | |
FileSource | to_filesource () | |
MidiSource | to_midisource () |
Methods | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
std::string | name () |
Methods | ||
---|---|---|
bool | isnil () | |
bool | sameinstance (MidiTrack) |
Methods | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
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) | ||||||||||||
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) | ||||||||||||
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. | ||||||||||||
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 | set_name (std::string) | |||||||||||
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. | ||||||||||||
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, ChanCount) | |||||||||||
enable custom plugin-insert configuration
Returns true if successful | ||||||||||||
enable custom plugin-insert configuration
Returns true if successful | ||||||||||||
IO | input () | |||||||||||
Delivery | main_outs () | |||||||||||
the signal processorat at end of the processing chain which produces output | ||||||||||||
PeakMeter | peak_meter () | |||||||||||
************************************************************* Pure interface begins here************************************************************* | ||||||||||||
int | remove_processor (Processor, ProcessorStreams, bool) | |||||||||||
remove plugin/processor
Returns 0 on success | ||||||||||||
remove plugin/processor
Returns 0 on success | ||||||||||||
int | remove_processors (ProcessorList, ProcessorStreams) | |||||||||||
bool | remove_sidechain (Processor) | |||||||||||
int | reorder_processors (ProcessorList, ProcessorStreams) | |||||||||||
int | replace_processor (Processor, Processor, ProcessorStreams) | |||||||||||
replace plugin/processor with another
Returns 0 on success | ||||||||||||
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 | ||||||||||||
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) | |||||||||||
Amp | trim () | |||||||||||
Cast | ||||||||||||
Automatable | to_automatable () | |||||||||||
Slavable | to_slavable () | |||||||||||
Track | to_track () |
Methods | ||
---|---|---|
std::string | name () | |
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) | |
SideChain | to_sidechain () | |
UnknownProcessor | to_unknownprocessor () |
Methods | ||
---|---|---|
std::string | name () |
C‡: boost::shared_ptr< ARDOUR::MuteControl >, boost::weak_ptr< ARDOUR::MuteControl >
-is-a: ARDOUR:SlavableAutomationControl,
+is-a: ARDOUR:SlavableAutomationControl
A PBD::Controllable with associated automation data (AutomationList)
bool | isnil () | |
bool | muted () | |
bool | muted_by_self () | |
bool | sameinstance (MuteControl) |
Methods | ||||
---|---|---|---|---|
void | add_master (AutomationControl, bool) | |||
void | add_master (AutomationControl) | |||
void | clear_masters () | |||
int | get_boolean_masters () | |||
double | get_masters_value () | |||
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
| ||||
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) | |||
void | stop_touch (double) | |||
bool | writable () | |||
Cast | ||||
Control | to_ctrl () | |||
SlavableAutomationControl | to_slavable () |
ID | id () | |
OwnedPropertyList | properties () |
C‡: std::list<boost::shared_ptr<Evoral::Note<Evoral::Beats> > > >
+ +Constructor | ||
---|---|---|
ℂ | ARDOUR.NotePtrList () | |
Methods | ||
LuaTable | add (LuaTable {Beats}) | |
NotePtr | back () | |
bool | empty () | |
NotePtr | front () | |
LuaIter | iter () | |
void | push_back (NotePtr) | |
void | reverse () | |
unsigned long | size () | |
LuaTable | table () | |
void | unique () |
C‡: PBD::OwnedPropertyList
is-a: ARDOUR:PropertyList
-A variant of PropertyList that does not delete its property list in its destructor. Objects with their own Properties store them in an OwnedPropertyList to avoid having them deleted at the wrong time.
Persistent Property List
A variant of PropertyList that does not delete its property list in its destructor. Objects with their own Properties store them in an OwnedPropertyList to avoid having them deleted at the wrong time.
This class object is only used indirectly as return-value and function-parameter. It provides no methods by itself.
C‡: boost::shared_ptr< ARDOUR::PannerShell >, boost::weak_ptr< ARDOUR::PannerShell >
-is-a: ARDOUR:SessionObject
+is-a: ARDOUR:SessionObjectPtr
Class to manage panning by instantiating and controlling an appropriate Panner object for a given in/out configuration.
Methods | ||
---|---|---|
bool | bypassed () | |
bool | isnil () | |
bool | sameinstance (PannerShell) | |
void | set_bypassed (bool) |
Methods | ||
---|---|---|
std::string | name () | |
Constructor | ||
ℂ | ARDOUR.ParameterDescriptor () | |
Methods | ||
std::string | midi_note_name (unsigned char) | |
std::string | midi_note_name (unsigned char, bool) | |
Data Members | ||
std::string | label | |
bool | logarithmic |
Constructor | ||
---|---|---|
ℂ | Evoral.ParameterDescriptor () | |
Data Members | ||
bool | logarithmic | |
True for log-scale parameters | ||
float | lower | |
Minimum value (in Hz, for frequencies) | ||
float | normal | |
bool | isnil () | |
float | meter_level (unsigned int, MeterType) | |
void | reset_max () | |
bool | sameinstance (PeakMeter) | |
void | set_type (MeterType) |
Methods | ||||||
---|---|---|---|---|---|---|
std::string | name () | |||||
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
| ||||
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) | |||
void | stop_touch (double) | |||
bool | writable () | |||
Cast | ||||
Control | to_ctrl () | |||
SlavableAutomationControl | to_slavable () |
C‡: boost::shared_ptr< ARDOUR::Playlist >, boost::weak_ptr< ARDOUR::Playlist >
-is-a: ARDOUR:SessionObject
+is-a: ARDOUR:SessionObjectPtr
A named object associated with a Session. Objects derived from this class are expected to be destroyed before the session calls drop_references().
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) | |||||
long | find_next_transient (long, int) | |||||
bool | isnil () | |||||
void | lower_region (Region) | |||||
void | lower_region_to_bottom (Region) | |||||
RegionListPtr | region_list () | |||||
RegionListPtr | regions_at (long) | |||||
RegionListPtr | regions_touched (long, long) | |||||
Returns regions which have some part within this range. | ||||||
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, MusicFrame) | |||||
Region | top_region_at (long) | |||||
AudioPlaylist | to_audioplaylist () | |||||
MidiPlaylist | to_midiplaylist () |
Methods | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
std::string | name () | |||||||||
char* | name () | |||||||||
LuaTable(unsigned int, ...) | nth_parameter (unsigned int, bool&) | |||||||||
unsigned int | parameter_count () | |||||||||
bool | parameter_is_audio (unsigned int) | |||||||||
bool | parameter_is_control (unsigned int) | |||||||||
bool | parameter_is_input (unsigned int) | |||||||||
bool | parameter_is_output (unsigned int) | |||||||||
std::string | parameter_label (unsigned int) | |||||||||
PresetRecord | preset_by_label (std::string) | |||||||||
PresetRecord | preset_by_uri (std::string) | |||||||||
bool | sameinstance (Plugin) | |||||||||
std::string | unique_id () | |||||||||
Cast | ||||||||||
LuaProc | to_luaproc () |
Methods | ||
---|---|---|
bool | isnil () | |
bool | sameinstance (PluginControl) |
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
| ||||
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) | |||
void | stop_touch (double) | |||
bool | writable () | |||
Cast | ||||
Control | to_ctrl () | |||
SlavableAutomationControl | to_slavable () |
PresetVector | get_presets (bool) | |
bool | is_instrument () | |
bool | isnil () | |
bool | sameinstance (PluginInfo) | |
Data Members | ||
---|---|---|
std::string | category | |
std::string | creator | |
ChanMapping | output_map (unsigned int) | |
Plugin | plugin (unsigned int) | |
bool | reset_parameters_to_default () | |
bool | sameinstance (PluginInsert) | |
void | set_input_map (unsigned int, ChanMapping) | |
void | set_output_map (unsigned int, ChanMapping) | |
bool | strict_io_configured () | |
SideChain | to_sidechain () | |
UnknownProcessor | to_unknownprocessor () |
Methods | ||||||
---|---|---|---|---|---|---|
std::string | name () | |||||
bool | connected () | |||||
Returns true if this port is connected to anything | ||||||
bool | connected_to (std::string) | |||||
Returns true if this port is connected to o, otherwise false. | ||||||
Returns true if this port is connected to o, otherwise false. | ||||||
int | disconnect (std::string) | |||||
int | disconnect_all () | |||||
bool | isnil () | |||||
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 | ||||||
void | get_physical_inputs (DataType, StringVector&, MidiPortFlags, MidiPortFlags) | |||||
void | get_physical_outputs (DataType, StringVector&, MidiPortFlags, MidiPortFlags) | |||||
Port | get_port_by_name (std::string) | |||||
Returns Corresponding Port or 0. | ||||||
Returns Corresponding Port or 0. | ||||||
LuaTable(int, ...) | get_ports (DataType, PortList&) | |||||
std::string | get_pretty_name_by_name (std::string) | |||||
ChanCount | n_physical_inputs () | |||||
bool | isnil () | |||||
unsigned long | num_ports (DataType) | |||||
Port | port (DataType, unsigned long) | |||||
nth port of type t, or nth port if t = NIL
| ||||||
nth port of type t, or nth port if t = NIL
| ||||||
bool | remove (Port) | |||||
bool | sameinstance (PortSet) |
C‡: ARDOUR::PresentationInfo
@@ -2467,8 +2594,10 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to CMethods | ||
---|---|---|
unsigned int | color () | |
Flag | flags () | |
unsigned int | order () | |
void | set_color (unsigned int) | |
bool | special (bool) |
C‡: boost::shared_ptr< ARDOUR::Processor >, boost::weak_ptr< ARDOUR::Processor >
-is-a: ARDOUR:SessionObject
+is-a: ARDOUR:SessionObjectPtr
A mixer strip element - plugin, send, meter, etc
ChanCount | input_streams () | |
bool | isnil () | |
ChanCount | output_streams () | |
bool | sameinstance (Processor) | |
Cast | ||
---|---|---|
Amp | to_amp () | |
Automatable | to_automatable () | |
SideChain | to_sidechain () | |
UnknownProcessor | to_unknownprocessor () |
Methods | ||
---|---|---|
std::string | name () |
Methods | ||
---|---|---|
AFLPosition | get_afl_position () | |
bool | get_all_safe () | |
bool | get_allow_special_bus_removal () | |
bool | get_ask_replace_instrument () | |
bool | get_ask_setup_instrument () | |
float | get_audio_capture_buffer_seconds () | |
float | get_audio_playback_buffer_seconds () | |
std::string | get_auditioner_output_left () | |
std::string | get_auditioner_output_right () | |
bool | get_auto_analyse_audio () | |
bool | get_auto_connect_standard_busses () | |
AutoReturnTarget | get_auto_return_target_list () | |
bool | get_automation_follows_regions () | |
float | get_automation_interval_msecs () | |
double | get_automation_thinning_factor () | |
BufferingPreset | get_buffering_preset () | |
std::string | get_click_emphasis_sound () | |
float | get_click_gain () | |
bool | get_click_record_only () | |
std::string | get_click_sound () | |
bool | get_clicking () | |
bool | get_copy_demo_sessions () | |
bool | get_create_xrun_marker () | |
FadeShape | get_default_fade_shape () | |
std::string | get_default_session_parent_dir () | |
DenormalModel | get_denormal_model () | |
bool | get_denormal_protection () | |
bool | get_disable_disarm_during_roll () | |
bool | get_discover_audio_units () | |
bool | get_discover_vst_on_start () | |
unsigned int | get_disk_choice_space_threshold () | |
std::string | get_donate_url () | |
EditMode | get_edit_mode () | |
bool | get_exclusive_solo () | |
float | get_export_preroll () | |
float | get_export_silence_threshold () | |
unsigned int | get_feedback_interval_ms () | |
bool | get_first_midi_bank_is_zero () | |
std::string | get_freesound_download_dir () | |
bool | get_hide_dummy_backend () | |
bool | get_hiding_groups_deactivates_groups () | |
int | get_history_depth () | |
int | get_initial_program_change () | |
AutoConnectOption | get_input_auto_connect () | |
int | get_inter_scene_gap_frames () | |
bool | get_latched_record_enable () | |
LayerModel | get_layer_model () | |
bool | get_link_send_and_route_panner () | |
std::string | get_linux_pingback_url () | |
ListenPosition | get_listen_position () | |
bool | get_locate_while_waiting_for_sync () | |
bool | get_loop_is_mode () | |
std::string | get_ltc_output_port () | |
float | get_ltc_output_volume () | |
bool | get_ltc_send_continuously () | |
std::string | get_ltc_source_port () | |
float | get_max_gain () | |
unsigned int | get_max_recent_sessions () | |
unsigned int | get_max_recent_templates () | |
float | get_meter_falloff () | |
MeterType | get_meter_type_bus () | |
MeterType | get_meter_type_master () | |
MeterType | get_meter_type_track () | |
std::string | get_midi_audition_synth_uri () | |
bool | get_midi_feedback () | |
bool | get_midi_input_follows_selection () | |
float | get_midi_readahead () | |
float | get_midi_track_buffer_seconds () | |
unsigned int | get_minimum_disk_read_bytes () | |
unsigned int | get_minimum_disk_write_bytes () | |
bool | get_mmc_control () | |
int | get_mmc_receive_device_id () | |
int | get_mmc_send_device_id () | |
std::string | get_monitor_bus_preferred_bundle () | |
MonitorModel | get_monitoring_model () | |
int | get_mtc_qf_speed_tolerance () | |
bool | get_mute_affects_control_outs () | |
bool | get_mute_affects_main_outs () | |
bool | get_mute_affects_post_fader () | |
bool | get_mute_affects_pre_fader () | |
bool | get_new_plugins_active () | |
unsigned int | get_osc_port () | |
std::string | get_osx_pingback_url () | |
AutoConnectOption | get_output_auto_connect () | |
unsigned int | get_periodic_safety_backup_interval () | |
bool | get_periodic_safety_backups () | |
PFLPosition | get_pfl_position () | |
std::string | get_plugin_path_lxvst () | |
std::string | get_plugin_path_vst () | |
bool | get_plugins_stop_with_transport () | |
long | get_postroll () | |
long | get_preroll () | |
float | get_preroll_seconds () | |
int | get_processor_usage () | |
bool | get_quieten_at_speed () | |
long | get_range_location_minimum () | |
std::string | get_reference_manual_url () | |
bool | get_region_boundaries_from_onscreen_tracks () | |
bool | get_region_boundaries_from_selected_tracks () | |
RegionSelectionAfterSplit | get_region_selection_after_split () | |
bool | get_replicate_missing_region_channels () | |
float | get_rf_speed () | |
bool | get_save_history () | |
int | get_saved_history_depth () | |
bool | get_seamless_loop () | |
bool | get_send_ltc () | |
bool | get_send_midi_clock () | |
bool | get_send_mmc () | |
bool | get_send_mtc () | |
bool | get_show_solo_mutes () | |
bool | get_show_video_export_info () | |
bool | get_show_video_server_dialog () | |
ShuttleBehaviour | get_shuttle_behaviour () | |
float | get_shuttle_max_speed () | |
float | get_shuttle_speed_factor () | |
float | get_shuttle_speed_threshold () | |
ShuttleUnits | get_shuttle_units () | |
bool | get_skip_playback () | |
bool | get_solo_control_is_listen_control () | |
float | get_solo_mute_gain () | |
bool | get_solo_mute_override () | |
bool | get_stop_at_session_end () | |
bool | get_stop_recording_on_xrun () | |
bool | get_strict_io () | |
SyncSource | get_sync_source () | |
bool | get_tape_machine_mode () | |
bool | get_timecode_source_2997 () | |
bool | get_timecode_source_is_synced () | |
bool | get_timecode_sync_frame_rate () | |
bool | get_trace_midi_input () | |
bool | get_trace_midi_output () | |
TracksAutoNamingRule | get_tracks_auto_naming () | |
float | get_transient_sensitivity () | |
bool | get_try_autostart_engine () | |
std::string | get_tutorial_manual_url () | |
std::string | get_updates_url () | |
bool | get_use_click_emphasis () | |
bool | get_use_lxvst () | |
bool | get_use_macvst () | |
bool | get_use_monitor_bus () | |
bool | get_use_osc () | |
bool | get_use_overlap_equivalency () | |
bool | get_use_plugin_own_gui () | |
bool | get_use_tranzport () | |
bool | get_use_windows_vst () | |
bool | get_verbose_plugin_scan () | |
bool | get_verify_remove_last_capture () | |
bool | get_video_advanced_setup () | |
std::string | get_video_server_docroot () | |
std::string | get_video_server_url () | |
int | get_vst_scan_timeout () | |
std::string | get_windows_pingback_url () | |
bool | set_afl_position (AFLPosition) | |
bool | set_all_safe (bool) | |
bool | set_allow_special_bus_removal (bool) | |
bool | set_ask_replace_instrument (bool) | |
bool | set_ask_setup_instrument (bool) | |
bool | set_audio_capture_buffer_seconds (float) | |
bool | set_audio_playback_buffer_seconds (float) | |
bool | set_auditioner_output_left (std::string) | |
bool | set_auditioner_output_right (std::string) | |
bool | set_auto_analyse_audio (bool) | |
bool | set_auto_connect_standard_busses (bool) | |
bool | set_auto_return_target_list (AutoReturnTarget) | |
bool | set_automation_follows_regions (bool) | |
bool | set_automation_interval_msecs (float) | |
bool | set_automation_thinning_factor (double) | |
bool | set_buffering_preset (BufferingPreset) | |
bool | set_click_emphasis_sound (std::string) | |
bool | set_click_gain (float) | |
bool | set_click_record_only (bool) | |
bool | set_click_sound (std::string) | |
bool | set_clicking (bool) | |
bool | set_copy_demo_sessions (bool) | |
bool | set_create_xrun_marker (bool) | |
bool | set_default_fade_shape (FadeShape) | |
bool | set_default_session_parent_dir (std::string) | |
bool | set_denormal_model (DenormalModel) | |
bool | set_denormal_protection (bool) | |
bool | set_disable_disarm_during_roll (bool) | |
bool | set_discover_audio_units (bool) | |
bool | set_discover_vst_on_start (bool) | |
bool | set_disk_choice_space_threshold (unsigned int) | |
bool | set_donate_url (std::string) | |
bool | set_edit_mode (EditMode) | |
bool | set_exclusive_solo (bool) | |
bool | set_export_preroll (float) | |
bool | set_export_silence_threshold (float) | |
bool | set_feedback_interval_ms (unsigned int) | |
bool | set_first_midi_bank_is_zero (bool) | |
bool | set_freesound_download_dir (std::string) | |
bool | set_hide_dummy_backend (bool) | |
bool | set_hiding_groups_deactivates_groups (bool) | |
bool | set_history_depth (int) | |
bool | set_initial_program_change (int) | |
bool | set_input_auto_connect (AutoConnectOption) | |
bool | set_inter_scene_gap_frames (int) | |
bool | set_latched_record_enable (bool) | |
bool | set_layer_model (LayerModel) | |
bool | set_link_send_and_route_panner (bool) | |
bool | set_linux_pingback_url (std::string) | |
bool | set_listen_position (ListenPosition) | |
bool | set_locate_while_waiting_for_sync (bool) | |
bool | set_loop_is_mode (bool) | |
bool | set_ltc_output_port (std::string) | |
bool | set_ltc_output_volume (float) | |
bool | set_ltc_send_continuously (bool) | |
bool | set_ltc_source_port (std::string) | |
bool | set_max_gain (float) | |
bool | set_max_recent_sessions (unsigned int) | |
bool | set_max_recent_templates (unsigned int) | |
bool | set_meter_falloff (float) | |
bool | set_meter_type_bus (MeterType) | |
bool | set_meter_type_master (MeterType) | |
bool | set_meter_type_track (MeterType) | |
bool | set_midi_audition_synth_uri (std::string) | |
bool | set_midi_feedback (bool) | |
bool | set_midi_input_follows_selection (bool) | |
bool | set_midi_readahead (float) | |
bool | set_midi_track_buffer_seconds (float) | |
bool | set_minimum_disk_read_bytes (unsigned int) | |
bool | set_minimum_disk_write_bytes (unsigned int) | |
bool | set_mmc_control (bool) | |
bool | set_mmc_receive_device_id (int) | |
bool | set_mmc_send_device_id (int) | |
bool | set_monitor_bus_preferred_bundle (std::string) | |
bool | set_monitoring_model (MonitorModel) | |
bool | set_mtc_qf_speed_tolerance (int) | |
bool | set_mute_affects_control_outs (bool) | |
bool | set_mute_affects_main_outs (bool) | |
bool | set_mute_affects_post_fader (bool) | |
bool | set_mute_affects_pre_fader (bool) | |
bool | set_new_plugins_active (bool) | |
bool | set_osc_port (unsigned int) | |
bool | set_osx_pingback_url (std::string) | |
bool | set_output_auto_connect (AutoConnectOption) | |
bool | set_periodic_safety_backup_interval (unsigned int) | |
bool | set_periodic_safety_backups (bool) | |
bool | set_pfl_position (PFLPosition) | |
bool | set_plugin_path_lxvst (std::string) | |
bool | set_plugin_path_vst (std::string) | |
bool | set_plugins_stop_with_transport (bool) | |
bool | set_postroll (long) | |
bool | set_preroll (long) | |
bool | set_preroll_seconds (float) | |
bool | set_processor_usage (int) | |
bool | set_quieten_at_speed (bool) | |
bool | set_range_location_minimum (long) | |
bool | set_reference_manual_url (std::string) | |
bool | set_region_boundaries_from_onscreen_tracks (bool) | |
bool | set_region_boundaries_from_selected_tracks (bool) | |
bool | set_region_selection_after_split (RegionSelectionAfterSplit) | |
bool | set_replicate_missing_region_channels (bool) | |
bool | set_rf_speed (float) | |
bool | set_save_history (bool) | |
bool | set_saved_history_depth (int) | |
bool | set_seamless_loop (bool) | |
bool | set_send_ltc (bool) | |
bool | set_send_midi_clock (bool) | |
bool | set_send_mmc (bool) | |
bool | set_send_mtc (bool) | |
bool | set_show_solo_mutes (bool) | |
bool | set_show_video_export_info (bool) | |
bool | set_show_video_server_dialog (bool) | |
bool | set_shuttle_behaviour (ShuttleBehaviour) | |
bool | set_shuttle_max_speed (float) | |
bool | set_shuttle_speed_factor (float) | |
bool | set_shuttle_speed_threshold (float) | |
bool | set_shuttle_units (ShuttleUnits) | |
bool | set_skip_playback (bool) | |
bool | set_solo_control_is_listen_control (bool) | |
bool | set_solo_mute_gain (float) | |
bool | set_solo_mute_override (bool) | |
bool | set_stop_at_session_end (bool) | |
bool | set_stop_recording_on_xrun (bool) | |
bool | set_strict_io (bool) | |
bool | set_sync_source (SyncSource) | |
bool | set_tape_machine_mode (bool) | |
bool | set_timecode_source_2997 (bool) | |
bool | set_timecode_source_is_synced (bool) | |
bool | set_timecode_sync_frame_rate (bool) | |
bool | set_trace_midi_input (bool) | |
bool | set_trace_midi_output (bool) | |
bool | set_tracks_auto_naming (TracksAutoNamingRule) | |
bool | set_transient_sensitivity (float) | |
bool | set_try_autostart_engine (bool) | |
bool | set_tutorial_manual_url (std::string) | |
bool | set_updates_url (std::string) | |
bool | set_use_click_emphasis (bool) | |
bool | set_use_lxvst (bool) | |
bool | set_use_macvst (bool) | |
bool | set_use_monitor_bus (bool) | |
bool | set_use_osc (bool) | |
bool | set_use_overlap_equivalency (bool) | |
bool | set_use_plugin_own_gui (bool) | |
bool | set_use_tranzport (bool) | |
bool | set_use_windows_vst (bool) | |
bool | set_verbose_plugin_scan (bool) | |
bool | set_verify_remove_last_capture (bool) | |
bool | set_video_advanced_setup (bool) | |
bool | set_video_server_docroot (std::string) | |
bool | set_video_server_url (std::string) | |
bool | set_vst_scan_timeout (int) | |
bool | set_windows_pingback_url (std::string) | |
Properties | ||
ARDOUR.AFLPosition | afl_position | |
bool | all_safe | |
bool | allow_special_bus_removal | |
bool | ask_replace_instrument | |
bool | ask_setup_instrument | |
float | audio_capture_buffer_seconds | |
float | audio_playback_buffer_seconds | |
std::string | auditioner_output_left | |
std::string | auditioner_output_right | |
bool | auto_analyse_audio | |
bool | auto_connect_standard_busses | |
ARDOUR.AutoReturnTarget | auto_return_target_list | |
bool | automation_follows_regions | |
float | automation_interval_msecs | |
double | automation_thinning_factor | |
ARDOUR.BufferingPreset | buffering_preset | |
std::string | click_emphasis_sound | |
float | click_gain | |
bool | click_record_only | |
std::string | click_sound | |
bool | clicking | |
bool | copy_demo_sessions | |
bool | create_xrun_marker | |
ARDOUR.FadeShape | default_fade_shape | |
std::string | default_session_parent_dir | |
ARDOUR.DenormalModel | denormal_model | |
bool | denormal_protection | |
bool | disable_disarm_during_roll | |
bool | discover_audio_units | |
bool | discover_vst_on_start | |
unsigned int | disk_choice_space_threshold | |
std::string | donate_url | |
ARDOUR.EditMode | edit_mode | |
bool | exclusive_solo | |
float | export_preroll | |
float | export_silence_threshold | |
unsigned int | feedback_interval_ms | |
bool | first_midi_bank_is_zero | |
std::string | freesound_download_dir | |
bool | hide_dummy_backend | |
bool | hiding_groups_deactivates_groups | |
int | history_depth | |
int | initial_program_change | |
ARDOUR.AutoConnectOption | input_auto_connect | |
int | inter_scene_gap_frames | |
bool | latched_record_enable | |
ARDOUR.LayerModel | layer_model | |
bool | link_send_and_route_panner | |
std::string | linux_pingback_url | |
ARDOUR.ListenPosition | listen_position | |
bool | locate_while_waiting_for_sync | |
bool | loop_is_mode | |
std::string | ltc_output_port | |
float | ltc_output_volume | |
bool | ltc_send_continuously | |
std::string | ltc_source_port | |
float | max_gain | |
unsigned int | max_recent_sessions | |
unsigned int | max_recent_templates | |
float | meter_falloff | |
ARDOUR.MeterType | meter_type_bus | |
ARDOUR.MeterType | meter_type_master | |
ARDOUR.MeterType | meter_type_track | |
std::string | midi_audition_synth_uri | |
bool | midi_feedback | |
bool | midi_input_follows_selection | |
float | midi_readahead | |
float | midi_track_buffer_seconds | |
unsigned int | minimum_disk_read_bytes | |
unsigned int | minimum_disk_write_bytes | |
bool | mmc_control | |
int | mmc_receive_device_id | |
int | mmc_send_device_id | |
std::string | monitor_bus_preferred_bundle | |
ARDOUR.MonitorModel | monitoring_model | |
int | mtc_qf_speed_tolerance | |
bool | mute_affects_control_outs | |
bool | mute_affects_main_outs | |
bool | mute_affects_post_fader | |
bool | mute_affects_pre_fader | |
bool | new_plugins_active | |
unsigned int | osc_port | |
std::string | osx_pingback_url | |
ARDOUR.AutoConnectOption | output_auto_connect | |
unsigned int | periodic_safety_backup_interval | |
bool | periodic_safety_backups | |
ARDOUR.PFLPosition | pfl_position | |
std::string | plugin_path_lxvst | |
std::string | plugin_path_vst | |
bool | plugins_stop_with_transport | |
long | postroll | |
long | preroll | |
float | preroll_seconds | |
int | processor_usage | |
bool | quieten_at_speed | |
long | range_location_minimum | |
std::string | reference_manual_url | |
bool | region_boundaries_from_onscreen_tracks | |
bool | region_boundaries_from_selected_tracks | |
ARDOUR.RegionSelectionAfterSplit | region_selection_after_split | |
bool | replicate_missing_region_channels | |
float | rf_speed | |
bool | save_history | |
int | saved_history_depth | |
bool | seamless_loop | |
bool | send_ltc | |
bool | send_midi_clock | |
bool | send_mmc | |
bool | send_mtc | |
bool | show_solo_mutes | |
bool | show_video_export_info | |
bool | show_video_server_dialog | |
ARDOUR.ShuttleBehaviour | shuttle_behaviour | |
float | shuttle_max_speed | |
float | shuttle_speed_factor | |
float | shuttle_speed_threshold | |
ARDOUR.ShuttleUnits | shuttle_units | |
bool | skip_playback | |
bool | solo_control_is_listen_control | |
float | solo_mute_gain | |
bool | solo_mute_override | |
bool | stop_at_session_end | |
bool | stop_recording_on_xrun | |
bool | strict_io | |
ARDOUR.SyncSource | sync_source | |
bool | tape_machine_mode | |
bool | timecode_source_2997 | |
bool | timecode_source_is_synced | |
bool | timecode_sync_frame_rate | |
bool | trace_midi_input | |
bool | trace_midi_output | |
ARDOUR.TracksAutoNamingRule | tracks_auto_naming | |
float | transient_sensitivity | |
bool | try_autostart_engine | |
std::string | tutorial_manual_url | |
std::string | updates_url | |
bool | use_click_emphasis | |
bool | use_lxvst | |
bool | use_macvst | |
bool | use_monitor_bus | |
bool | use_osc | |
bool | use_overlap_equivalency | |
bool | use_plugin_own_gui | |
bool | use_tranzport | |
bool | use_windows_vst | |
bool | verbose_plugin_scan | |
bool | verify_remove_last_capture | |
bool | video_advanced_setup | |
std::string | video_server_docroot | |
std::string | video_server_url | |
int | vst_scan_timeout | |
std::string | windows_pingback_url |
Methods | ||
---|---|---|
void | clear_changes () | |
Forget about any changes to this object's properties | ||
ID | id () | |
OwnedPropertyList | properties () |
C‡: boost::shared_ptr< ARDOUR::ReadOnlyControl >, boost::weak_ptr< ARDOUR::ReadOnlyControl >
+is-a: PBD:StatefulDestructiblePtr
+ +Methods | ||
---|---|---|
ParameterDescriptor | desc () | |
std::string | describe_parameter () | |
double | get_parameter () | |
bool | isnil () |
Methods | ||
---|---|---|
void | clear_changes () | |
Forget about any changes to this object's properties | ||
ID | id () | |
OwnedPropertyList | properties () |
C‡: boost::shared_ptr< ARDOUR::Readable >, boost::weak_ptr< ARDOUR::Readable >
@@ -2617,11 +3237,10 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to CC‡: boost::shared_ptr< ARDOUR::Region >, boost::weak_ptr< ARDOUR::Region >
-is-a: ARDOUR:SessionObject
+is-a: ARDOUR:SessionObjectPtr
A named object associated with a Session. Objects derived from this class are expected to be destroyed before the session calls drop_references().
bool | can_move () | |||
bool | captured () | |||
void | clear_sync_position () | |||
Control | control (Parameter, bool) | |||
bool | covers (long) | |||
void | cut_end (long, int) | |||
void | cut_front (long, int) | |||
DataType | data_type () | |||
bool | external () | |||
bool | has_transients () | |||
bool | hidden () | |||
bool | import () | |||
bool | is_compound () | |||
double | quarter_note () | |||
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_position_locked (bool) | |||
void | set_start (long) | |||
void | set_sync_position (long) | |||
Set the region's sync point.
| ||||
Set the region's sync point.
| ||||
void | set_video_locked (bool) | |||
float | shift () | |||
Source | source (unsigned int) | |||
LuaTable(long, ...) | sync_offset (int&) | |||
long | sync_position () | |||
Returns Sync position in session time | ||||
Int64List | transients () | |||
void | trim_end (long, int) | |||
void | trim_front (long, int) | |||
void | trim_to (long, long, int) | |||
MidiRegion | to_midiregion () | |||
Readable | to_readable () |
Methods | ||
---|---|---|
std::string | name () |
Methods | ||
---|---|---|
Region | clone_region (Region, bool, bool) | |
Region | region_by_id (ID) | |
RegionMap | regions () |
C‡: std::list<boost::shared_ptr<ARDOUR::Region> >
@@ -2737,6 +3360,38 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to CC‡: std::map<PBD::ID, boost::shared_ptr<ARDOUR::Region> > >
+ +Constructor | ||
---|---|---|
ℂ | ARDOUR.RegionMap () | |
Methods | ||
LuaTable | add (LuaTable {Region}) | |
... | at (--lua--) | |
void | clear () | |
unsigned long | count (ID) | |
bool | empty () | |
LuaIter | iter () | |
unsigned long | size () | |
LuaTable | table () |
C‡: std::vector<boost::shared_ptr<ARDOUR::Region> >
+ +Constructor | ||
---|---|---|
ℂ | ARDOUR.RegionVector () | |
ℂ | ARDOUR.RegionVector () | |
Methods | ||
LuaTable | add (LuaTable {Region}) | |
Region | at (unsigned long) | |
bool | empty () | |
LuaIter | iter () | |
void | push_back (Region) | |
unsigned long | size () | |
LuaTable | table () |
C‡: boost::shared_ptr< ARDOUR::Route >, boost::weak_ptr< ARDOUR::Route >
is-a: ARDOUR:Stripable
@@ -2746,12 +3401,12 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to CAdd a processor to a route such that it ends up with a given index into the visible processors.
index | Index to add the processor at, or -1 to add at the end of the list. |
---|
Returns 0 on success, non-0 on failure.
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.
enable custom plugin-insert configuration
proc | Processor to customize |
---|---|
count | number of plugin instances to use (if zero, reset to default) |
outs | output port customization |
sinks | input pins for variable-I/O plugins |
Returns true if successful
enable custom plugin-insert configuration
Returns true if successful
************************************************************* Pure interface begins here*************************************************************
remove plugin/processor
proc | processor to remove |
---|---|
err | error report (index where removal vailed, channel-count why it failed) may be nil |
need_process_lock | if locking is required (set to true, unless called from RT context with lock) |
Returns 0 on success
remove plugin/processor
Returns 0 on success
replace plugin/processor with another
old | processor to remove |
---|---|
sub | processor to substitute the old one with |
err | error report (index where removal vailed, channel-count why it failed) may be nil |
Returns 0 on success
replace plugin/processor with another
Returns 0 on success
reset plugin-insert configuration to default, disable customizations.
This is equivalent to calling
customize_plugin_insert (proc, 0, unused)
proc | Processor to reset |
---|
Returns true if successful
reset plugin-insert configuration to default, disable customizations.
This is equivalent to calling
customize_plugin_insert (proc, 0, unused)
Returns true if successful
Methods | ||
---|---|---|
std::string | name () |
C‡: ARDOUR::RouteGroup
+is-a: ARDOUR:SessionObject
A group identifier for routes.
RouteGroups permit to define properties which are shared among all Routes that use the given identifier.
A route can at most be in one group.
Methods | ||||
---|---|---|---|---|
int | add (Route) | |||
Add a route to a group. Adding a route which is already in the group is allowed; nothing will happen.
| ||||
Add a route to a group. Adding a route which is already in the group is allowed; nothing will happen.
| ||||
void | clear () | |||
void | destroy_subgroup () | |||
bool | empty () | |||
bool | is_solo () | |||
void | make_subgroup (bool, Placement) | |||
int | remove (Route) | |||
unsigned int | rgba () | |||
RouteListPtr | route_list () | |||
void | set_active (bool, void*) | |||
void | set_color (bool) | |||
void | set_mute (bool) | |||
void | set_recenable (bool) | |||
void | set_relative (bool, void*) | |||
void | set_rgba (unsigned int) | |||
set route-group color and notify UI about change | ||||
void | set_route_active (bool) | |||
void | set_select (bool) | |||
void | set_solo (bool) | |||
unsigned long | size () |
Methods | ||
---|---|---|
std::string | name () | |
Cast | ||
Stateful | to_stateful () |
C‡: std::list<ARDOUR::RouteGroup* >
@@ -2951,19 +3620,22 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to Ccreate an StatefulDiffCommand from the given object and add it to the stack.
This function must only be called after begin_reversible_command. Failing to do so may lead to a crash.
sfd | the object to diff |
---|
Returns the allocated StatefulDiffCommand (already added via add_command)
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)
begin collecting undo information
This call must always be followed by either begin_reversible_command() or commit_reversible_command()
cmd_name | human readable name for the undo operation |
---|
begin collecting undo information
This call must always be followed by either begin_reversible_command() or commit_reversible_command()
finalize an undo command and commit pending transactions
This must only be called after begin_reversible_command ()
cmd | (additional) command to add |
---|
finalize an undo command and commit pending transactions
This must only be called after begin_reversible_command ()
save session
snapshot_name | name of the session (use an empty string for the current name) |
---|---|
pending | save a 'recovery', not full state (default: false) |
switch_to_snapshot | switch to given snapshot after saving (default: false) |
template_only | save a session template (default: false) |
Returns zero on success
save session
Returns zero on success
C‡: ARDOUR::SessionObject
+ +A named object associated with a Session. Objects derived from this class are expected to be destroyed before the session calls drop_references().
Methods | ||
---|---|---|
std::string | name () | |
Cast | ||
Stateful | to_stateful () |
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 () | |
bool | sameinstance (SideChain) |
SideChain | to_sidechain () | |
UnknownProcessor | to_unknownprocessor () |
Methods | ||
---|---|---|
std::string | name () | |
Stateful | to_stateful () | |
StatefulDestructible | to_statefuldestructible () |
C‡: boost::shared_ptr< ARDOUR::Slavable >, boost::weak_ptr< ARDOUR::Slavable >
+ +Methods | ||
---|---|---|
void | assign (VCA) | |
bool | isnil () | |
void | unassign (VCA) |
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, bool) | |
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) |
Get the current effective `user' value based on automation state
Get and Set `internal' value
All derived classes must implement this.
Basic derived classes will ignore
group_override, | but more sophisticated children, notably those that proxy the value setting logic via an object that is aware of group relationships between this control and others, will find it useful. |
---|
Get and Set `internal' value
All derived classes must implement this.
Basic derived classes will ignore
C‡: boost::shared_ptr< ARDOUR::SoloControl >, boost::weak_ptr< ARDOUR::SoloControl >
-is-a: ARDOUR:SlavableAutomationControl,
+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, bool) | |||
void | add_master (AutomationControl) | |||
void | clear_masters () | |||
int | get_boolean_masters () | |||
double | get_masters_value () | |||
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
| ||||
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) | |||
void | stop_touch (double) | |||
bool | writable () | |||
Cast | ||||
Control | to_ctrl () | |||
SlavableAutomationControl | to_slavable () |
C‡: boost::shared_ptr< ARDOUR::SoloIsolateControl >, boost::weak_ptr< ARDOUR::SoloIsolateControl >
-is-a: ARDOUR:SlavableAutomationControl,
+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, bool) | |||
void | add_master (AutomationControl) | |||
void | clear_masters () | |||
int | get_boolean_masters () | |||
double | get_masters_value () | |||
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
| ||||
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) | |||
void | stop_touch (double) | |||
bool | writable () | |||
Cast | ||||
Control | to_ctrl () | |||
SlavableAutomationControl | to_slavable () |
C‡: boost::shared_ptr< ARDOUR::SoloSafeControl >, boost::weak_ptr< ARDOUR::SoloSafeControl >
-is-a: ARDOUR:SlavableAutomationControl,
+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, bool) | |||
void | add_master (AutomationControl) | |||
void | clear_masters () | |||
int | get_boolean_masters () | |||
double | get_masters_value () | |||
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
| ||||
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) | |||
void | stop_touch (double) | |||
bool | writable () | |||
Cast | ||||
Control | to_ctrl () | |||
SlavableAutomationControl | to_slavable () |
C‡: boost::shared_ptr< ARDOUR::Source >, boost::weak_ptr< ARDOUR::Source >
-is-a: ARDOUR:SessionObject
+is-a: ARDOUR:SessionObjectPtr
A named object associated with a Session. Objects derived from this class are expected to be destroyed before the session calls drop_references().
bool | isnil () | |
long | length (long) | |
long | natural_position () | |
bool | sameinstance (Source) | |
long | timeline_position () | |
long | timestamp () | |
int | use_count () | |
bool | writable () | |
Cast | ||
---|---|---|
AudioSource | to_audiosource () | |
FileSource | to_filesource () | |
MidiSource | to_midisource () |
Methods | ||
---|---|---|
std::string | name () |
C‡: boost::shared_ptr< ARDOUR::Stripable >, boost::weak_ptr< ARDOUR::Stripable >
-is-a: ARDOUR:SessionObject
+is-a: ARDOUR:SessionObjectPtr
A named object associated with a Session. Objects derived from this class are expected to be destroyed before the session calls drop_references().
AutomationControl | comp_makeup_control () | |
AutomationControl | comp_mode_control () | |
std::string | comp_mode_name (unsigned int) | |
AutomationControl | comp_redux_control () | |
ReadOnlyControl | comp_redux_control () | |
AutomationControl | comp_speed_control () | |
std::string | comp_speed_name (unsigned int) | |
AutomationControl | comp_threshold_control () | |
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) | |
AutomationControl | filter_enable_controllable (bool) | |
AutomationControl | filter_freq_controllable (bool) | |
AutomationControl | filter_slope_controllable (bool) | |
GainControl | gain_control () | |
bool | is_auditioner () | |
bool | is_hidden () | |
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) | |
GainControl | trim_control () | |
Cast | ||
---|---|---|
Route | to_route () | |
VCA | to_vca () |
Methods | ||
---|---|---|
std::string | name () | |
Stateful | to_stateful () | |
StatefulDestructible | to_statefuldestructible () |
C‡: std::list<boost::shared_ptr<ARDOUR::Stripable> >
+ +Constructor | ||
---|---|---|
ℂ | ARDOUR.StripableList () | |
Methods | ||
Stripable | back () | |
bool | empty () | |
Stripable | front () | |
LuaIter | iter () | |
void | reverse () | |
unsigned long | size () | |
LuaTable | table () |
C‡: ARDOUR::Tempo
Tempo, the speed at which musical time progresses (BPM).
Constructor | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
ℂ | ARDOUR.Tempo (double, double) | |||||||||||
| ||||||||||||
ℂ | ARDOUR.Tempo (double, double, double) | |||||||||||
Methods | ||||||||||||
double | frames_per_note_type (long) | |||||||||||
audio samples per note type. if you want an instantaneous value for this, use TempoMap::frames_per_quarter_note_at() instead.
| ||||||||||||
audio samples per note type. if you want an instantaneous value for this, use TempoMap::frames_per_quarter_note_at() instead.
| ||||||||||||
double | frames_per_quarter_note (long) | |||||||||||
audio samples per quarter note. if you want an instantaneous value for this, use TempoMap::frames_per_quarter_note_at() instead.
| ||||||||||||
audio samples per quarter note. if you want an instantaneous value for this, use TempoMap::frames_per_quarter_note_at() instead.
| ||||||||||||
double | note_type () | |||||||||||
double | note_types_per_minute () | |||||||||||
double | quarter_notes_per_minute () |
Methods | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
MeterSection | add_meter (Meter, double, BBT_TIME, long, PositionLockStyle) | |||||||||||
TempoSection | add_tempo (Tempo, double, long, Type, PositionLockStyle) | |||||||||||
MeterSection | add_meter (Meter, BBT_TIME, long, PositionLockStyle) | |||||||||||
TempoSection | add_tempo (Tempo, double, long, PositionLockStyle) | |||||||||||
BBT_TIME | bbt_at_frame (long) | |||||||||||
Returns the BBT time corresponding to the supplied frame position.
Returns the BBT time at the frame position . | ||||||||||||
double | exact_beat_at_frame (long, int) | |||||||||||
double | exact_qn_at_frame (long, int) | |||||||||||
Returns the BBT time corresponding to the supplied frame position.
Returns the BBT time at the frame position . | ||||||||||||
double | exact_beat_at_frame (long, int) | |||||||||||
double | exact_qn_at_frame (long, int) | |||||||||||
long | framepos_plus_qn (long, Beats) | |||||||||||
Add some (fractional) Beats to a session frame position, and return the result in frames. pos can be -ve, if required. | ||||||||||||
Beats | framewalk_to_qn (long, long) | |||||||||||
Count the number of beats that are equivalent to distance when going forward, starting at pos. | ||||||||||||
MeterSection | meter_section_at_beat (double) | |||||||||||
MeterSection | meter_section_at_frame (long) | |||||||||||
TempoSection | tempo_section_at_frame (long) |
Methods | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
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) | ||||||||||||
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) | ||||||||||||
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. | ||||||||||||
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 | sameinstance (Track) | |||||||||||
bool | set_name (std::string) | |||||||||||
Cast | ||||||||||||
AudioTrack | to_audio_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. | ||||||||||||
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, ChanCount) | |||||||||||
enable custom plugin-insert configuration
Returns true if successful | ||||||||||||
enable custom plugin-insert configuration
Returns true if successful | ||||||||||||
IO | input () | |||||||||||
Delivery | main_outs () | |||||||||||
the signal processorat at end of the processing chain which produces output | ||||||||||||
PeakMeter | peak_meter () | |||||||||||
************************************************************* Pure interface begins here************************************************************* | ||||||||||||
int | remove_processor (Processor, ProcessorStreams, bool) | |||||||||||
remove plugin/processor
Returns 0 on success | ||||||||||||
remove plugin/processor
Returns 0 on success | ||||||||||||
int | remove_processors (ProcessorList, ProcessorStreams) | |||||||||||
bool | remove_sidechain (Processor) | |||||||||||
int | reorder_processors (ProcessorList, ProcessorStreams) | |||||||||||
int | replace_processor (Processor, Processor, ProcessorStreams) | |||||||||||
replace plugin/processor with another
Returns 0 on success | ||||||||||||
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 | ||||||||||||
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) | |||||||||||
Amp | trim () | |||||||||||
Cast | ||||||||||||
Automatable | to_automatable () | |||||||||||
Slavable | to_slavable () | |||||||||||
Track | to_track () |
Methods | ||
---|---|---|
std::string | name () |
Methods | ||
---|---|---|
bool | isnil () | |
bool | sameinstance (UnknownProcessor) |
SideChain | to_sidechain () | |
UnknownProcessor | to_unknownprocessor () |
Methods | ||
---|---|---|
std::string | name () | |
Cast | ||
Stateful | to_stateful () | |
StatefulDestructible | to_statefuldestructible () |
C‡: boost::shared_ptr< ARDOUR::VCA >, boost::weak_ptr< ARDOUR::VCA >
+is-a: ARDOUR:Stripable
+ +A named object associated with a Session. Objects derived from this class are expected to be destroyed before the session calls drop_references().
Methods | ||
---|---|---|
std::string | full_name () | |
GainControl | gain_control () | |
bool | isnil () | |
MuteControl | mute_control () | |
int | number () | |
SoloControl | solo_control () |
Methods | ||
---|---|---|
AutomationControl | comp_enable_control () | |
AutomationControl | comp_makeup_control () | |
AutomationControl | comp_mode_control () | |
std::string | comp_mode_name (unsigned int) | |
ReadOnlyControl | 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_q_control (unsigned int) | |
AutomationControl | eq_shape_control (unsigned int) | |
AutomationControl | filter_enable_controllable (bool) | |
AutomationControl | filter_freq_controllable (bool) | |
AutomationControl | filter_slope_controllable (bool) | |
bool | is_auditioner () | |
bool | is_hidden () | |
bool | is_master () | |
bool | is_monitor () | |
bool | is_selected () | |
AutomationControl | master_send_enable_control () | |
MonitorProcessor | monitor_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) | |
SoloIsolateControl | solo_isolate_control () | |
SoloSafeControl | solo_safe_control () | |
GainControl | trim_control () | |
Cast | ||
Route | to_route () | |
VCA | to_vca () |
Methods | ||
---|---|---|
std::string | name () | |
Stateful | to_stateful () | |
StatefulDestructible | to_statefuldestructible () |
C‡: std::list<boost::shared_ptr<ARDOUR::VCA> >
+ +Constructor | ||
---|---|---|
ℂ | ARDOUR.VCAList () | |
Methods | ||
VCA | back () | |
bool | empty () | |
VCA | front () | |
LuaIter | iter () | |
void | reverse () | |
unsigned long | size () | |
LuaTable | table () |
C‡: ARDOUR::VCAManager
+is-a: PBD:StatefulDestructible
+ +Base class for objects with saveable and undoable state with destruction notification
Methods | ||
---|---|---|
int | create_vca (unsigned int, std::string) | |
unsigned long | n_vcas () | |
void | remove_vca (VCA) | |
VCA | vca_by_name (std::string) | |
VCA | vca_by_number (int) | |
VCAList | vcas () |
Methods | ||
---|---|---|
void | clear_changes () | |
Forget about any changes to this object's properties | ||
ID | id () | |
OwnedPropertyList | properties () |
C‡: std::list<boost::weak_ptr<ARDOUR::AudioSource> >
@@ -3852,6 +4666,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to CC‡: ArdourMarker
@@ -3892,21 +4707,21 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to CThis class contains just the public interface of the Editor class, in order to decouple it from the private implementation, so that callers of PublicEditor need not be recompiled if private methods or member variables change.
Methods | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
void | access_action (std::string, std::string) | |||||||||
void | access_action (std::string, std::string) | |||||||||
void | add_location_from_playhead_cursor () | |||||||||
TrackViewList | axis_views_from_routes (RouteListPtr) | |||||||||
void | center_screen (long) | |||||||||
void | clear_playlist (Playlist) | |||||||||
void | clear_playlists (TimeAxisView) | |||||||||
void | consider_auditioning (Region) | |||||||||
Possibly start the audition of a region. If
| ||||||||||
Possibly start the audition of a region. If
| ||||||||||
void | copy_playlists (TimeAxisView) | |||||||||
MouseMode | current_mouse_mode () | |||||||||
Returns The current mouse mode (gain, object, range, timefx etc.) (defined in editing_syms.h) | ||||||||||
long | current_page_samples () | |||||||||
void | deselect_all () | |||||||||
LuaTable(...) | do_embed (StringVector, ImportDisposition, ImportMode, long&, PluginInfo) | |||||||||
LuaTable(...) | do_import (StringVector, ImportDisposition, ImportMode, SrcQuality, MidiTrackNameSource, --MISSING (ARDOUR::MidiTempoMapDisposition)--, long&, PluginInfo) | |||||||||
LuaTable(...) | do_import (StringVector, ImportDisposition, ImportMode, SrcQuality, MidiTrackNameSource, MidiTempoMapDisposition, long&, PluginInfo) | |||||||||
Import existing media | ||||||||||
bool | dragging_playhead () | |||||||||
Returns true if the playhead is currently being dragged, otherwise false | ||||||||||
Open export dialog with current selection pre-selected | ||||||||||
LuaTable(Location, ...) | find_location_from_marker (ArdourMarker, bool&) | |||||||||
ArdourMarker | find_marker_from_location_id (ID, bool) | |||||||||
void | fit_selection () | |||||||||
bool | follow_playhead () | |||||||||
Returns true if the editor is following the playhead | ||||||||||
long | get_current_zoom () | |||||||||
LuaTable(long, ...) | get_nudge_distance (long, long&) | |||||||||
long | get_paste_offset (long, unsigned int, long) | |||||||||
LuaTable(...) | get_pointer_position (double&, double&) | |||||||||
RouteTimeAxisView | get_route_view_by_route_id (ID) | |||||||||
Selection | get_selection () | |||||||||
LuaTable(bool, ...) | get_selection_extents (long&, long&) | |||||||||
bool | get_smart_mode () | |||||||||
TrackViewList | get_track_views () | |||||||||
StripableTimeAxisView | get_stripable_time_axis_by_id (ID) | |||||||||
TrackViewList | get_track_views () | |||||||||
int | get_videotl_bar_height () | |||||||||
double | get_y_origin () | |||||||||
ZoomFocus | get_zoom_focus () | |||||||||
void | play_selection () | |||||||||
void | play_with_preroll () | |||||||||
void | redo (unsigned int) | |||||||||
Redo some transactions.
| ||||||||||
Redo some transactions.
| ||||||||||
RegionView | regionview_from_region (Region) | |||||||||
void | remove_last_capture () | |||||||||
void | remove_location_at_playhead_cursor () | |||||||||
void | select_all_tracks () | |||||||||
void | separate_region_from_selection () | |||||||||
void | set_follow_playhead (bool, bool) | |||||||||
Set whether the editor should follow the playhead.
| ||||||||||
Set whether the editor should follow the playhead.
| ||||||||||
void | set_loop_range (long, long, std::string) | |||||||||
void | set_mouse_mode (MouseMode, bool) | |||||||||
Set the mouse mode (gain, object, range, timefx etc.)
| ||||||||||
Set the mouse mode (gain, object, range, timefx etc.)
| ||||||||||
void | set_punch_range (long, long, std::string) | |||||||||
void | set_selection (SelectionList, Operation) | |||||||||
void | set_show_measures (bool) | |||||||||
void | set_snap_mode (SnapMode) | |||||||||
Set the snap mode.
| ||||||||||
Set the snap mode.
| ||||||||||
void | set_snap_threshold (double) | |||||||||
Set the snap threshold.
| ||||||||||
Set the snap threshold.
| ||||||||||
void | set_stationary_playhead (bool) | |||||||||
void | set_toggleaction (std::string, std::string, bool) | |||||||||
void | set_video_timeline_height (int) | |||||||||
void | set_visible_track_count (int) | |||||||||
void | set_zoom_focus (ZoomFocus) | |||||||||
bool | show_measures () | |||||||||
void | show_track_in_display (TimeAxisView, bool) | |||||||||
void | toggle_ruler_video (bool) | |||||||||
void | toggle_xjadeo_proc (int) | |||||||||
void | undo (unsigned int) | |||||||||
Undo some transactions.
| ||||||||||
Undo some transactions.
| ||||||||||
double | visible_canvas_height () |
Base class for objects with auto-disconnection. trackable must be inherited when objects shall automatically invalidate slots referring to them on destruction. A slot built from a member function of a trackable derived type installs a callback that is invoked when the trackable object is destroyed or overwritten.
add_destroy_notify_callback() and remove_destroy_notify_callback() can be used to manually install and remove callbacks when notification of the object dying is needed.
notify_callbacks() invokes and removes all previously installed callbacks and can therefore be used to disconnect from all signals.
Note that there is no virtual destructor. Don't use trackable* as pointer type for managing your data or the destructors of your derived types won't be called when deleting your objects.
signal
Cast | ||
---|---|---|
StripableTimeAxisView | to_stripabletimeaxisview () | |
TimeAxisView | to_timeaxisview () |
Clear everything from the Selection
check if all selections are empty
internal_selection | also check object internals (e.g midi notes, automation points), when false only check objects. |
---|
Returns true if nothing is selected.
check if all selections are empty
Returns true if nothing is selected.
C‡: StripableTimeAxisView
+is-a: ArdourUI:TimeAxisView
+ +Abstract base class for time-axis views (horizontal editor 'strips')
This class provides the basic LHS controls and display methods. This should be extended to create functional time-axis based views.
This class object is only used indirectly as return-value and function-parameter. It provides no methods by itself.
C‡: TimeAxisView
is-a: ArdourUI:AxisView
@@ -4198,7 +5023,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to CC‡: std::list<long >
+ +Constructor | ||
---|---|---|
ℂ | C.Int64List () | |
Methods | ||
LuaTable | add (LuaTable {long}) | |
long | back () | |
bool | empty () | |
long | front () | |
LuaIter | iter () | |
void | push_back (long) | |
void | reverse () | |
unsigned long | size () | |
LuaTable | table () | |
void | unique () |
C‡: int*
@@ -4268,7 +5109,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to Cxc | X position of the center of the arc |
---|---|
yc | Y position of the center of the arc |
radius | the radius of the arc |
angle1 | the start angle, in radians |
angle2 | the end angle, in radians |
Adds a circular arc of the given radius to the current path. The arc is centered at (xc, yc), begins at angle1 and proceeds in the direction of decreasing angles to end at angle2. If angle2 is greater than angle1 it will be progressively decreased by 2*M_PI until it is greater than angle1.
See arc() for more details. This function differs only in the direction of the arc between the two angles.
xc | X position of the center of the arc |
---|---|
yc | Y position of the center of the arc |
radius | the radius of the arc |
angle1 | the start angle, in radians |
angle2 | the end angle, in radians |
Adds a circular arc of the given radius to the current path. The arc is centered at (xc, yc), begins at angle1 and proceeds in the direction of decreasing angles to end at angle2. If angle2 is greater than angle1 it will be progressively decreased by 2*M_PI until it is greater than angle1.
See arc() for more details. This function differs only in the direction of the arc between the two angles.
Clears the current path. After this call there will be no current point.
Adds a line segment to the path from the current point to the beginning of the current subpath, (the most recent point passed to move_to()), and closes this subpath. After this call the current point will be at the joined endpoint of the sub-path.
The behavior of close_path() is distinct from simply calling line_to() with the equivalent coordinate in the case of stroking. When a closed subpath is stroked, there are no caps on the ends of the subpath. Instead, there is a line join connecting the final and initial segments of the subpath.
If there is no current point before the call to close_path(), this function will have no effect.
Adds a cubic Bezier spline to the path from the current point to position (x3, y3) in user-space coordinates, using (x1, y1) and (x2, y2) as the control points. After this call the current point will be (x3, y3).
If there is no current point before the call to curve_to() this function will behave as if preceded by a call to move_to(x1, y1).
x1 | the X coordinate of the first control point |
---|---|
y1 | the Y coordinate of the first control point |
x2 | the X coordinate of the second control point |
y2 | the Y coordinate of the second control point |
x3 | the X coordinate of the end of the curve |
y3 | the Y coordinate of the end of the curve |
Adds a cubic Bezier spline to the path from the current point to position (x3, y3) in user-space coordinates, using (x1, y1) and (x2, y2) as the control points. After this call the current point will be (x3, y3).
If there is no current point before the call to curve_to() this function will behave as if preceded by a call to move_to(x1, y1).
A drawing operator that fills the current path according to the current fill rule, (each sub-path is implicitly closed before being filled). After fill(), the current path will be cleared from the cairo context.
set_fill_rule()
fill_preserve()
A drawing operator that fills the current path according to the current fill rule, (each sub-path is implicitly closed before being filled). Unlike fill(), fill_preserve() preserves the path within the cairo Context.
set_fill_rule()
fill().
Adds a line to the path from the current point to position (x, y) in user-space coordinates. After this call the current point will be (x, y).
If there is no current point before the call to line_to() this function will behave as move_to(x, y).
x | the X coordinate of the end of the new line |
---|---|
y | the Y coordinate of the end of the new line |
Adds a line to the path from the current point to position (x, y) in user-space coordinates. After this call the current point will be (x, y).
If there is no current point before the call to line_to() this function will behave as move_to(x, y).
If the current subpath is not empty, begin a new subpath. After this call the current point will be (x, y).
x | the X coordinate of the new position |
---|---|
y | the Y coordinate of the new position |
If the current subpath is not empty, begin a new subpath. After this call the current point will be (x, y).
A drawing operator that paints the current source everywhere within the current clip region.
A drawing operator that paints the current source everywhere within the current clip region using a mask of constant alpha value alpha. The effect is similar to paint(), but the drawing is faded out using the alpha value.
alpha | an alpha value, between 0 (transparent) and 1 (opaque) |
---|
A drawing operator that paints the current source everywhere within the current clip region using a mask of constant alpha value alpha. The effect is similar to paint(), but the drawing is faded out using the alpha value.
Adds a closed-subpath rectangle of the given size to the current path at position (x, y) in user-space coordinates.
This function is logically equivalent to:
context->move_to(x, y); context->rel_line_to(width, 0); context->rel_line_to(0, height); context->rel_line_to(-width, 0); - context->close_path();
x | the X coordinate of the top left corner of the rectangle |
---|---|
y | the Y coordinate to the top left corner of the rectangle |
width | the width of the rectangle |
height | the height of the rectangle |
Relative-coordinate version of curve_to(). All offsets are relative to the current point. Adds a cubic Bezier spline to the path from the current point to a point offset from the current point by (dx3, dy3), using points offset by (dx1, dy1) and (dx2, dy2) as the control points. After this call the current point will be offset by (dx3, dy3).
Given a current point of (x, y),
rel_curve_to(dx1, dy1, dx2, dy2, dx3, dy3)
is logically equivalent to
curve_to(x + dx1, y + dy1, x + dx2, y + dy2, x + dx3, y + dy3).
It is an error to call this function with no current point. Doing so will cause this to shutdown with a status of CAIRO_STATUS_NO_CURRENT_POINT. Cairomm will then throw an exception.
dx1 | the X offset to the first control point |
---|---|
dy1 | the Y offset to the first control point |
dx2 | the X offset to the second control point |
dy2 | the Y offset to the second control point |
dx3 | the X offset to the end of the curve |
dy3 | the Y offset to the end of the curve |
Relative-coordinate version of curve_to(). All offsets are relative to the current point. Adds a cubic Bezier spline to the path from the current point to a point offset from the current point by (dx3, dy3), using points offset by (dx1, dy1) and (dx2, dy2) as the control points. After this call the current point will be offset by (dx3, dy3).
Given a current point of (x, y),
rel_curve_to(dx1, dy1, dx2, dy2, dx3, dy3)
is logically equivalent to
curve_to(x + dx1, y + dy1, x + dx2, y + dy2, x + dx3, y + dy3).
It is an error to call this function with no current point. Doing so will cause this to shutdown with a status of CAIRO_STATUS_NO_CURRENT_POINT. Cairomm will then throw an exception.
Relative-coordinate version of line_to(). Adds a line to the path from the current point to a point that is offset from the current point by (dx, dy) in user space. After this call the current point will be offset by (dx, dy).
Given a current point of (x, y),
rel_line_to(dx, dy)
is logically equivalent to
line_to(x + dx, y + dy).
It is an error to call this function with no current point. Doing so will cause this to shutdown with a status of CAIRO_STATUS_NO_CURRENT_POINT. Cairomm will then throw an exception.
dx | the X offset to the end of the new line |
---|---|
dy | the Y offset to the end of the new line |
Relative-coordinate version of line_to(). Adds a line to the path from the current point to a point that is offset from the current point by (dx, dy) in user space. After this call the current point will be offset by (dx, dy).
Given a current point of (x, y),
rel_line_to(dx, dy)
is logically equivalent to
line_to(x + dx, y + dy).
It is an error to call this function with no current point. Doing so will cause this to shutdown with a status of CAIRO_STATUS_NO_CURRENT_POINT. Cairomm will then throw an exception.
If the current subpath is not empty, begin a new subpath. After this call the current point will offset by (x, y).
Given a current point of (x, y),
rel_move_to(dx, dy)
is logically equivalent to
move_to(x + dx, y + dy)
It is an error to call this function with no current point. Doing so will cause this to shutdown with a status of CAIRO_STATUS_NO_CURRENT_POINT. Cairomm will then throw an exception.
dx | the X offset |
---|---|
dy | the Y offset |
If the current subpath is not empty, begin a new subpath. After this call the current point will offset by (x, y).
Given a current point of (x, y),
rel_move_to(dx, dy)
is logically equivalent to
move_to(x + dx, y + dy)
It is an error to call this function with no current point. Doing so will cause this to shutdown with a status of CAIRO_STATUS_NO_CURRENT_POINT. Cairomm will then throw an exception.
Reset the current clip region to its original, unrestricted state. That is, set the clip region to an infinitely large shape containing the target surface. Equivalently, if infinity is too hard to grasp, one can imagine the clip region being reset to the exact bounds of the target surface.
Note that code meant to be reusable should not call reset_clip() as it will cause results unexpected by higher-level code which calls clip(). Consider using save() and restore() around clip() as a more robust means of temporarily restricting the clip region.
Restores cr to the state saved by a preceding call to save() and removes that state from the stack of saved states.
save()
Modifies the current transformation matrix (CTM) by rotating the user-space axes by angle radians. The rotation of the axes takes places after any existing transformation of user space. The rotation direction for positive angles is from the positive X axis toward the positive Y axis.
angle | angle (in radians) by which the user-space axes will be rotated |
---|
Modifies the current transformation matrix (CTM) by rotating the user-space axes by angle radians. The rotation of the axes takes places after any existing transformation of user space. The rotation direction for positive angles is from the positive X axis toward the positive Y axis.
Makes a copy of the current state of the Context and saves it on an internal stack of saved states. When restore() is called, it will be restored to the saved state. Multiple calls to save() and restore() can be nested; each call to restore() restores the state from the matching paired save().
It isn't necessary to clear all saved states before a cairo_t is freed. Any saved states will be freed when the Context is destroyed.
restore()
Modifies the current transformation matrix (CTM) by scaling the X and Y user-space axes by sx and sy respectively. The scaling of the axes takes place after any existing transformation of user space.
sx | scale factor for the X dimension |
---|---|
sy | scale factor for the Y dimension |
Modifies the current transformation matrix (CTM) by scaling the X and Y user-space axes by sx and sy respectively. The scaling of the axes takes place after any existing transformation of user space.
Sets the dash pattern to be used by stroke(). A dash pattern is specified by dashes, an array of positive values. Each value provides the user-space length of altenate "on" and "off" portions of the stroke. The offset specifies an offset into the pattern at which the stroke begins.
Each "on" segment will have caps applied as if the segment were a separate sub-path. In particular, it is valid to use an "on" length of 0.0 with Cairo::LINE_CAP_ROUND or Cairo::LINE_CAP_SQUARE in order to distributed dots or squares along a path.
Note: The length values are in user-space units as evaluated at the time of stroking. This is not necessarily the same as the user space at the time of set_dash().
If dashes is empty dashing is disabled. If the size of dashes is 1, a symmetric pattern is assumed with alternating on and off portions of the size specified by the single value in dashes.
It is invalid for any value in dashes to be negative, or for all values to be 0. If this is the case, an exception will be thrown
dashes | an array specifying alternate lengths of on and off portions |
---|---|
offset | an offset into the dash pattern at which the stroke should start |
Sets the dash pattern to be used by stroke(). A dash pattern is specified by dashes, an array of positive values. Each value provides the user-space length of altenate "on" and "off" portions of the stroke. The offset specifies an offset into the pattern at which the stroke begins.
Each "on" segment will have caps applied as if the segment were a separate sub-path. In particular, it is valid to use an "on" length of 0.0 with Cairo::LINE_CAP_ROUND or Cairo::LINE_CAP_SQUARE in order to distributed dots or squares along a path.
Note: The length values are in user-space units as evaluated at the time of stroking. This is not necessarily the same as the user space at the time of set_dash().
If dashes is empty dashing is disabled. If the size of dashes is 1, a symmetric pattern is assumed with alternating on and off portions of the size specified by the single value in dashes.
It is invalid for any value in dashes to be negative, or for all values to be 0. If this is the case, an exception will be thrown
Sets the current font matrix to a scale by a factor of size, replacing any font matrix previously set with set_font_size() or set_font_matrix(). This results in a font size of size user space units. (More precisely, this matrix will result in the font's em-square being a by size square in user space.)
If text is drawn without a call to set_font_size(), (nor set_font_matrix() nor set_scaled_font()), the default font size is 10.0.
size | the new font size, in user space units) |
---|
Sets the current font matrix to a scale by a factor of size, replacing any font matrix previously set with set_font_size() or set_font_matrix(). This results in a font size of size user space units. (More precisely, this matrix will result in the font's em-square being a by size square in user space.)
If text is drawn without a call to set_font_size(), (nor set_font_matrix() nor set_scaled_font()), the default font size is 10.0.
Sets the current line cap style within the cairo Context. See LineCap for details about how the available line cap styles are drawn.
As with the other stroke parameters, the current line cap style is examined by stroke(), stroke_extents(), and stroke_to_path(), but does not have any effect during path construction.
The default line cap style is Cairo::LINE_CAP_BUTT.
line_cap | a line cap style, as a LineCap |
---|
Sets the current line cap style within the cairo Context. See LineCap for details about how the available line cap styles are drawn.
As with the other stroke parameters, the current line cap style is examined by stroke(), stroke_extents(), and stroke_to_path(), but does not have any effect during path construction.
The default line cap style is Cairo::LINE_CAP_BUTT.
Sets the current line join style within the cairo Context. See LineJoin for details about how the available line join styles are drawn.
As with the other stroke parameters, the current line join style is examined by stroke(), stroke_extents(), and stroke_to_path(), but does not have any effect during path construction.
The default line join style is Cairo::LINE_JOIN_MITER.
line_join | a line joint style, as a LineJoin |
---|
Sets the current line join style within the cairo Context. See LineJoin for details about how the available line join styles are drawn.
As with the other stroke parameters, the current line join style is examined by stroke(), stroke_extents(), and stroke_to_path(), but does not have any effect during path construction.
The default line join style is Cairo::LINE_JOIN_MITER.
Sets the current line width within the cairo Context. The line width specifies the diameter of a pen that is circular in user-space, (though device-space pen may be an ellipse in general due to scaling/shear/rotation of the CTM).
Note: When the description above refers to user space and CTM it refers to the user space and CTM in effect at the time of the stroking operation, not the user space and CTM in effect at the time of the call to set_line_width(). The simplest usage makes both of these spaces identical. That is, if there is no change to the CTM between a call to set_line_width() and the stroking operation, then one can just pass user-space values to set_line_width() and ignore this note.
As with the other stroke parameters, the current line cap style is examined by stroke(), stroke_extents(), and stroke_to_path(), but does not have any effect during path construction.
The default line width value is 2.0.
width | a line width, as a user-space value |
---|
Sets the current line width within the cairo Context. The line width specifies the diameter of a pen that is circular in user-space, (though device-space pen may be an ellipse in general due to scaling/shear/rotation of the CTM).
Note: When the description above refers to user space and CTM it refers to the user space and CTM in effect at the time of the stroking operation, not the user space and CTM in effect at the time of the call to set_line_width(). The simplest usage makes both of these spaces identical. That is, if there is no change to the CTM between a call to set_line_width() and the stroking operation, then one can just pass user-space values to set_line_width() and ignore this note.
As with the other stroke parameters, the current line cap style is examined by stroke(), stroke_extents(), and stroke_to_path(), but does not have any effect during path construction.
The default line width value is 2.0.
Sets the compositing operator to be used for all drawing operations. See Operator for details on the semantics of each available compositing operator.
op | a compositing operator, specified as a Operator |
---|
Sets the compositing operator to be used for all drawing operations. See Operator for details on the semantics of each available compositing operator.
Sets the source pattern within the Context to an opaque color. This opaque color will then be used for any subsequent drawing operation until a new source pattern is set.
The color components are floating point numbers in the range 0 to 1. If the values passed in are outside that range, they will be clamped.
set_source_rgba()
set_source()
red | red component of color |
---|---|
green | green component of color |
blue | blue component of color |
Sets the source pattern within the Context to an opaque color. This opaque color will then be used for any subsequent drawing operation until a new source pattern is set.
The color components are floating point numbers in the range 0 to 1. If the values passed in are outside that range, they will be clamped.
set_source_rgba()
set_source()
Sets the source pattern within the Context to a translucent color. This color will then be used for any subsequent drawing operation until a new source pattern is set.
The color and alpha components are floating point numbers in the range 0 to 1. If the values passed in are outside that range, they will be clamped.
set_source_rgb()
set_source()
red | red component of color |
---|---|
green | green component of color |
blue | blue component of color |
alpha | alpha component of color |
Sets the source pattern within the Context to a translucent color. This color will then be used for any subsequent drawing operation until a new source pattern is set.
The color and alpha components are floating point numbers in the range 0 to 1. If the values passed in are outside that range, they will be clamped.
set_source_rgb()
set_source()
A drawing operator that generates the shape from a string of UTF-8 characters, rendered according to the current font_face, font_size (font_matrix), and font_options.
This function first computes a set of glyphs for the string of text. The first glyph is placed so that its origin is at the current point. The origin of each subsequent glyph is offset from that of the previous glyph by the advance values of the previous glyph.
After this call the current point is moved to the origin of where the next glyph would be placed in this same progression. That is, the current point will be at the origin of the final glyph offset by its advance values. This allows for easy display of a single logical string with multiple calls to show_text().
Note: The show_text() function call is part of what the cairo designers call the "toy" text API. It is convenient for short demos and simple programs, but it is not expected to be adequate for serious text-using applications. See show_glyphs() for the "real" text display API in cairo.
utf8 | a string containing text encoded in UTF-8 |
---|
A drawing operator that generates the shape from a string of UTF-8 characters, rendered according to the current font_face, font_size (font_matrix), and font_options.
This function first computes a set of glyphs for the string of text. The first glyph is placed so that its origin is at the current point. The origin of each subsequent glyph is offset from that of the previous glyph by the advance values of the previous glyph.
After this call the current point is moved to the origin of where the next glyph would be placed in this same progression. That is, the current point will be at the origin of the final glyph offset by its advance values. This allows for easy display of a single logical string with multiple calls to show_text().
Note: The show_text() function call is part of what the cairo designers call the "toy" text API. It is convenient for short demos and simple programs, but it is not expected to be adequate for serious text-using applications. See show_glyphs() for the "real" text display API in cairo.
A drawing operator that strokes the current Path according to the current line width, line join, line cap, and dash settings. After stroke(), the current Path will be cleared from the cairo Context.
set_line_width()
set_line_join()
set_line_cap()
set_dash()
stroke_preserve().
Note: Degenerate segments and sub-paths are treated specially and provide a useful result. These can result in two different situations:
1. Zero-length "on" segments set in set_dash(). If the cap style is Cairo::LINE_CAP_ROUND or Cairo::LINE_CAP_SQUARE then these segments will be drawn as circular dots or squares respectively. In the case of Cairo::LINE_CAP_SQUARE, the orientation of the squares is determined by the direction of the underlying path.
2. A sub-path created by move_to() followed by either a close_path() or one or more calls to line_to() to the same coordinate as the move_to(). If the cap style is Cairo::LINE_CAP_ROUND then these sub-paths will be drawn as circular dots. Note that in the case of Cairo::LINE_CAP_SQUARE a degenerate sub-path will not be drawn at all, (since the correct orientation is indeterminate).
In no case will a cap style of Cairo::LINE_CAP_BUTT cause anything to be drawn in the case of either degenerate segments or sub-paths.
A drawing operator that strokes the current Path according to the current line width, line join, line cap, and dash settings. Unlike stroke(), stroke_preserve() preserves the Path within the cairo Context.
set_line_width()
set_line_join()
set_line_cap()
set_dash()
stroke_preserve().
Modifies the current transformation matrix (CTM) by translating the user-space origin by (tx, ty). This offset is interpreted as a user-space coordinate according to the CTM in place before the new call to translate. In other words, the translation of the user-space origin takes place after any existing transformation.
tx | amount to translate in the X direction |
---|---|
ty | amount to translate in the Y direction |
Modifies the current transformation matrix (CTM) by translating the user-space origin by (tx, ty). This offset is interpreted as a user-space coordinate according to the CTM in place before the new call to translate. In other words, the translation of the user-space origin takes place after any existing transformation.
This function disables a dash pattern that was set with set_dash()
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.
Sets the type of ellipsization being performed for layout. Depending on the ellipsization mode ellipsize text is removed from the start, middle, or end of text so they fit within the width and height of layout set with set_width() and set_height().
If the layout contains characters such as newlines that force it to be layed out in multiple paragraphs, then whether each paragraph is ellipsized separately or the entire layout is ellipsized as a whole depends on the set height of the layout. See set_height() for details.
ellipsize | The new ellipsization mode for layout. |
---|
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.
Sets the layout text and attribute list from marked-up text (see markup format). Replaces the current text and attribute list.
markup | Some marked-up text. |
---|
Sets the layout text and attribute list from marked-up text (see markup format). Replaces the current text and attribute list.
Set the text of the layout.
text | The text for the layout. |
---|
Set the text of the layout.
Sets the width to which the lines of the Pango::Layout should wrap or ellipsized. The default value is -1: no width set.
width | The desired width in Pango units, or -1 to indicate that no wrapping or ellipsization should be performed. |
---|
Sets the width to which the lines of the Pango::Layout should wrap or ellipsized. The default value is -1: no width set.
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.
wrap | The wrap mode. |
---|
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.
C‡: Evoral::ControlEvent
+ +A single event (time-stamped value) for a control
Data Members | ||
---|---|---|
double | value | |
double | when |
C‡: boost::shared_ptr< Evoral::ControlList >, boost::weak_ptr< Evoral::ControlList >
@@ -4470,26 +5318,27 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to CMethods | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
void | add (double, double, bool, bool) | |||||||||
add automation events
| ||||||||||
add automation events
| ||||||||||
void | clear (double, double) | |||||||||
remove all automation events between the given time range
| ||||||||||
double | eval (double) | |||||||||
query value at given time (takes a read-lock, not safe while writing automation)
Returns parameter value | ||||||||||
remove all automation events between the given time range
| ||||||||||
void | clear_list () | |||||||||
double | eval (double) | |||||||||
query value at given time (takes a read-lock, not safe while writing automation)
Returns parameter value | ||||||||||
EventList | events () | |||||||||
bool | in_write_pass () | |||||||||
InterpolationStyle | interpolation () | |||||||||
query interpolation style of the automation data Returns Interpolation Style | ||||||||||
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
| ||||||||||
LuaTable(double, ...) | rt_safe_eval (double, bool&) | |||||||||
realtime safe version of eval, may fail if read-lock cannot be taken
Returns parameter value | ||||||||||
bool | set_interpolation (InterpolationStyle) | |||||||||
set the interpolation style of the automation data. This will fail when asking for Logarithmic scale and min,max crosses 0 or Exponential scale with min != 0.
Returns true if style change was successful | ||||||||||
void | thin (double) | |||||||||
Thin the number of events in this list. The thinning factor corresponds to the area of a triangle computed between three points in the list (time-difference * value-difference). If the area is large, it indicates significant non-linearity between the points. Time is measured in samples, value is usually normalized to 0..1. During automation recording we thin the recorded points using this value. If a point is sufficiently co-linear with its neighbours (as defined by the area of the triangle formed by three of them), we will not include it in the list. The larger the value, the more points are excluded, so this effectively measures the amount of thinning to be done.
| ||||||||||
Thin the number of events in this list. The thinning factor corresponds to the area of a triangle computed between three points in the list (time-difference * value-difference). If the area is large, it indicates significant non-linearity between the points. Time is measured in samples, value is usually normalized to 0..1. During automation recording we thin the recorded points using this value. If a point is sufficiently co-linear with its neighbours (as defined by the area of the triangle formed by three of them), we will not include it in the list. The larger the value, the more points are excluded, so this effectively measures the amount of thinning to be done.
| ||||||||||
void | truncate_end (double) | |||||||||
truncate the event list after the given time
| ||||||||||
truncate the event list after the given time
| ||||||||||
void | truncate_start (double) | |||||||||
truncate the event list to the given time
| ||||||||||
truncate the event list to the given time
|
C‡: boost::shared_ptr< Evoral::ControlSet >, boost::weak_ptr< Evoral::ControlSet >
@@ -4497,7 +5346,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to CMethods | ||
---|---|---|
bool | isnil () | |
bool | sameinstance (ControlSet) |
C‡: Evoral::Event<long>
@@ -4524,7 +5372,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to CTrue for log-scale parameters
Minimum value (in Hz, for frequencies)
Methods | ||
---|---|---|
bool | isnil () | |
bool | sameinstance (Sequence) |
C‡: LuaDialog::Dialog
+ +Constructor | ||
---|---|---|
ℂ | LuaDialog.Dialog (std::string, Lua-Function) | |
Methods | ||
... | run (--lua--) |
C‡: LuaDialog::Message
+ +Constructor | ||
---|---|---|
ℂ | LuaDialog.Message (std::string, std::string, MessageType, ButtonType) | |
Methods | ||
int | run () |
C‡: std::bitset<47ul>
+C‡: std::bitset<48ul>
Constructor | ||
---|---|---|
ℂ | LuaSignal.Set () | |
Methods | ||
LuaTable | add (47ul) | |
bool | any () | |
unsigned long | count () | |
bool | none () | |
Set | reset () | |
Set | set (unsigned long, bool) | |
unsigned long | size () | |
LuaTable | add (48ul) | |
bool | any () | |
unsigned long | count () | |
bool | none () | |
Set | reset () | |
Set | set (unsigned long, bool) | |
unsigned long | size () | |
LuaTable | table () | |
bool | test (unsigned long) | |
bool | test (unsigned long) |
Methods | ||
---|---|---|
bool | isnil () | |
bool | sameinstance (StatefulDestructible) |
ID | id () | |
bool | isnil () | |
OwnedPropertyList | properties () | |
bool | sameinstance (Stateful) |
C‡: XMLNode
@@ -5094,6 +5957,13 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to CMethods | ||
---|---|---|
int | execute (std::string) | |
LuaTable | forkexec () |