diff --git a/include/class-reference.html b/include/class-reference.html index 3bdba04..d1bf9c4 100644 --- a/include/class-reference.html +++ b/include/class-reference.html @@ -130,7 +130,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C Methods GainControlgain_control () boolisnil () - boolsameinstance (Amp)

Inherited from ARDOUR:Processor

@@ -190,14 +189,13 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C - - + @@ -224,12 +222,11 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C - + - - +
unsigned intoutput_channels ()
std::stringoutput_device_name ()
unsigned intperiod_size ()
boolsameinstance (AudioBackend)
floatsample_rate ()
intset_buffer_size (unsigned int)

Set the buffer size to be used.

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

intset_device_name (std::string)

Set the name of the device to be used

intset_driver (std::string)

Returns zero if the backend can successfully use

Should not be used unless the backend returns true from requires_driver_selection()

name as the driver, non-zero otherwise.

Returns zero if the backend can successfully use

Should not be used unless the backend returns true from requires_driver_selection()

name
as the driver, non-zero otherwise.
intset_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()

intset_output_device_name (std::string)
Methods
voidapply_gain (float, long)
boolcheck_silence (unsigned int, unsigned int&)

check buffer for silence

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

Returns true if all samples are zero

check buffer for silence

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

Returns true if all samples are zero

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

silence buffer

len number of samples to clear
offset start offset

silence buffer

len
number of samples to clear
offset
start offset

 ARDOUR:AudioEngine

C‡: ARDOUR::AudioEngine

@@ -261,7 +258,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C voidget_physical_inputs (DataType, StringVector&, MidiPortFlags, MidiPortFlags) voidget_physical_outputs (DataType, StringVector&, MidiPortFlags, MidiPortFlags) Portget_port_by_name (std::string) -
name Full or short name of port

Returns Corresponding Port or 0.

+
name
Full or short name of port

Returns Corresponding Port or 0.

LuaTable(int, ...)get_ports (DataType, PortList&) std::stringget_pretty_name_by_name (std::string) ChanCountn_physical_inputs () @@ -279,7 +276,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C Methods boolisnil () longread (FloatArray, FloatArray, FloatArray, long, long, unsigned int) - boolsameinstance (AudioPlaylist)

Inherited from ARDOUR:Playlist

@@ -291,10 +287,10 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C - + - + @@ -306,7 +302,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C - + @@ -334,7 +330,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C
Playlistcut (AudioRangeList&, bool)
DataTypedata_type ()
voidduplicate (Region, long, long, float)
gap from the beginning of the region to the next beginning
gap
from the beginning of the region to the next beginning
voidduplicate_range (AudioRange&, float)
voidduplicate_until (Region, long, long, long)
gap from the beginning of the region to the next beginning
end the first frame that does _not_ contain a duplicated frame
gap
from the beginning of the region to the next beginning
end
the first frame that does _not_ contain a duplicated frame
Regionfind_next_region (long, RegionPoint, int)
longfind_next_region_boundary (long, int)
voidlower_region (Region)
RegionListPtrregion_list ()
RegionListPtrregions_at (long)
RegionListPtrregions_touched (long, long)
start Range start.
end Range end.

Returns regions which have some part within this range.

start
Range start.
end
Range end.

Returns regions which have some part within this range.

RegionListPtrregions_with_end_within (Range)
RegionListPtrregions_with_start_within (Range)
voidremove_region (Region)
-
Methods
boolisnil ()
boolsameinstance (AudioPort)

Inherited from ARDOUR:Port

@@ -343,7 +338,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C - + @@ -400,7 +395,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C -
boolconnected ()

Returns true if this port is connected to anything

boolconnected_to (std::string)
o Port name

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

o
Port name

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

intdisconnect (std::string)
intdisconnect_all ()
std::stringname ()

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

doublerms (Progress)

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

boolsameinstance (AudioRegion)
floatscale_amplitude ()
voidset_scale_amplitude (float)
@@ -450,7 +444,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C voidset_position_locked (bool) voidset_start (long) voidset_sync_position (long) -

Set the region's sync point.

absolute_pos Session time.
+

Set the region's sync point.

absolute_pos
Session time.
voidset_video_locked (bool) floatshift () Sourcesource (unsigned int) @@ -495,8 +489,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C longread (FloatArray, long, long, int) longreadable_length () longreadable_length () - boolsameinstance (AudioSource) - boolsameinstance (AudioSource) floatsample_rate () Cast Readableto_readable () @@ -534,17 +526,16 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C -
Methods
boolisnil ()
boolsameinstance (AudioTrack)

Inherited from ARDOUR:Track

- + - + - + @@ -557,12 +548,12 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C - + - + @@ -577,14 +568,14 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C - + - + - + @@ -680,7 +671,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C -
Methods
Regionbounce (InterThreadInfo&)

bounce track from session start to session end to new region

itt asynchronous progress report and cancel

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

bounce track from session start to session end to new region

itt
asynchronous progress report and cancel

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

Regionbounce_range (long, long, InterThreadInfo&, Processor, bool)

Bounce the given range to a new audio region.

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

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

Bounce the given range to a new audio region.

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

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

boolbounceable (Processor, bool)

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

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

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

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

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

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

boolcan_record ()
Playlistplaylist ()
boolset_name (std::string)
Methods
boolactive ()
intadd_processor_by_index (Processor, int, ProcessorStreams, bool)

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

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

Returns 0 on success, non-0 on failure.

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

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

Returns 0 on success, non-0 on failure.

booladd_sidechain (Processor)
Ampamp ()
std::stringcomment ()
boolcustomize_plugin_insert (Processor, unsigned int, ChanCount, ChanCount)

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

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

IOinput ()
Deliverymain_outs ()

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

PeakMeterpeak_meter ()

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

intremove_processor (Processor, ProcessorStreams, bool)

remove plugin/processor

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

Returns 0 on success

remove plugin/processor

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

Returns 0 on success

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

replace plugin/processor with another

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

Returns 0 on success

replace plugin/processor with another

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

Returns 0 on success

boolreset_plugin_insert (Processor)

reset plugin-insert configuration to default, disable customizations.

This is equivalent to calling

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

Returns true if successful

reset plugin-insert configuration to default, disable customizations.

This is equivalent to calling

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

Returns true if successful

voidset_active (bool, void*)
voidset_comment (std::string, void*)
voidset_meter_point (MeterPoint, bool)
Methods
AutomationControlautomation_control (Parameter, bool)
boolisnil ()
boolsameinstance (Automatable)

 ARDOUR:AutomatableSequence

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

@@ -689,7 +679,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C -
Methods
boolisnil ()
boolsameinstance (AutomatableSequence)
Cast
Sequenceto_sequence ()
@@ -711,11 +700,10 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C doubleget_value ()

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

boolisnil () - boolsameinstance (AutomationControl) voidset_automation_state (AutoState) voidset_automation_style (AutoStyle) voidset_value (double, GroupControlDisposition) -

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

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.
voidstart_touch (double) voidstop_touch (bool, double) boolwritable () @@ -744,7 +732,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C XMLNodeget_state () boolisnil () Commandmemento_command (XMLNode, XMLNode) - boolsameinstance (AutomationList) booltouch_enabled () booltouching () boolwriting () @@ -775,7 +762,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C ChanCountcount () AudioBufferget_audio (unsigned long) MidiBufferget_midi (unsigned long) - boolsameinstance (BufferSet)

 ARDOUR:ChanCount

C‡: ARDOUR::ChanCount

@@ -784,10 +770,10 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C - + - + @@ -797,7 +783,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C - +
Constructor
ARDOUR.ChanCount (DataType, unsigned int)

Convenience constructor for making single-typed streams (mono, stereo, midi, etc)

type data type
count number of channels

Convenience constructor for making single-typed streams (mono, stereo, midi, etc)

type
data type
count
number of channels
Methods
unsigned intget (DataType)

query channel count for given type

type data type

Returns channel count for given type

query channel count for given type

type
data type

Returns channel count for given type

unsigned intn_audio ()

query number of audio channels

Returns number of audio channels

unsigned intn_midi ()
voidreset ()

zero count of all data types

voidset (DataType, unsigned int)

set channel count for given type

count number of channels
type data type

set channel count for given type

count
number of channels
type
data type

 ARDOUR:ChanMapping

C‡: ARDOUR::ChanMapping

@@ -809,12 +795,12 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C Methods ChanCountcount () unsigned intget (DataType, unsigned int) -

get 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

from
numeric source id
type
data type

Returns mapped buffer number (or ChanMapping::Invalid)

boolis_monotonic ()

Test if this mapping is monotonic (useful to see if inplace processing is feasible)

Returns true if the map is a strict monotonic set

unsigned intn_total () voidset (DataType, unsigned int, unsigned int) -

set buffer mapping for given data type

from numeric source id
to buffer
type data type
+

set buffer mapping for given data type

from
numeric source id
to
buffer
type
data type

 ARDOUR:ControlList

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

@@ -862,15 +848,15 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C floatfast_coefficient_to_dB (float) voidfind_peaks (FloatArray, unsigned int, FloatArray, FloatArray) floatlog_meter (float) -

non-linear power-scale meter deflection

power signal power (dB)

Returns deflected value

+

non-linear power-scale meter deflection

power
signal power (dB)

Returns deflected value

floatlog_meter_coeff (float) -

non-linear power-scale meter deflection

coeff signal value

Returns deflected value

+

non-linear power-scale meter deflection

coeff
signal value

Returns deflected value

voidmemset (FloatArray, float, unsigned int)

lua wrapper to memset()

voidmix_buffers_no_gain (FloatArray, FloatArray, unsigned int) voidmix_buffers_with_gain (FloatArray, FloatArray, unsigned int, float) voidmmult (FloatArray, FloatArray, unsigned int) -

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

data
multiplicand
mult
multiplicand
n_samples
number of samples in data and mmult
LuaTable(...)peaks (FloatArray, float&, float&, unsigned int) voidprocess_map (BufferSet, ChanMapping, ChanMapping, unsigned int, long, DataType) @@ -881,18 +867,18 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C - + - + - + - +
Constructor
ARDOUR.DSP.Biquad (double)

Instantiate Biquad Filter

samplerate Samplerate

Instantiate Biquad Filter

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

setup filter, compute coefficients

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

setup filter, compute coefficients

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

setup filter, set coefficients directly

floatdB_at_freq (float)

filter transfer function (filter response for spectrum visualization)

freq frequency

Returns gain at given frequency in dB (clamped to -120..+120)

filter transfer function (filter response for spectrum visualization)

freq
frequency

Returns gain at given frequency in dB (clamped to -120..+120)

voidreset ()

reset filter state

voidrun (FloatArray, unsigned int)

process audio data

data pointer to audio-data
n_samples number of samples to process

process audio data

data
pointer to audio-data
n_samples
number of samples to process

 ARDOUR:DSP:DspShm

C‡: ARDOUR::DSP::DspShm

@@ -903,17 +889,17 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C ℂARDOUR.DSP.DspShm (unsigned long) Methods voidallocate (unsigned long) -

[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

s
size, total number of float or integer elements to store.
intatomic_get_int (unsigned long) -

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.

off
offset in shared memory region

Returns value at offset

voidatomic_set_int (unsigned long, int) -

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.

off
offset in shared memory region
val
value to set
voidclear ()

clear memory (set to zero)

FloatArrayto_float (unsigned long) -

access memory as float array

off offset in shared memory region

Returns float[]

+

access memory as float array

off
offset in shared memory region

Returns float[]

IntArrayto_int (unsigned long) -

access memory as integer array

off offset in shared memory region

Returns int_32_t[]

+

access memory as integer array

off
offset in shared memory region

Returns int_32_t[]

 ARDOUR:DSP:FFTSpectrum

C‡: ARDOUR::DSP::FFTSpectrum

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

process current data in buffer

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

query

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

Returns signal power at given bin (in dBFS)

+

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)

voidset_data_hann (FloatArray, unsigned int, unsigned int)

 ARDOUR:DSP:LowPass

@@ -936,16 +922,16 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C - + - + - + - +
Constructor
ARDOUR.DSP.LowPass (double, float)

instantiate a LPF

samplerate samplerate
freq cut-off frequency

instantiate a LPF

samplerate
samplerate
freq
cut-off frequency
Methods
voidctrl (FloatArray, float, unsigned int)

filter control data

This is useful for parameter smoothing.

data pointer to control-data array
val target value
array length

filter control data

This is useful for parameter smoothing.

data
pointer to control-data array
val
target value
array
length
voidproc (FloatArray, unsigned int)

process audio data

data pointer to audio-data
n_samples number of samples to process

process audio data

data
pointer to audio-data
n_samples
number of samples to process
voidreset ()

reset filter state

voidset_cutoff (float)

update filter cut-off frequency

freq cut-off frequency

update filter cut-off frequency

freq
cut-off frequency

 ARDOUR:DataType

C‡: ARDOUR::DataType

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

Inherited from ARDOUR:IOProcessor

@@ -1044,7 +1029,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C
- + @@ -1062,7 +1047,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C
Constructor
ARDOUR.FluidSynth (float, int)

instantiate a Synth

samplerate samplerate

instantiate a Synth

samplerate
samplerate
Methods
boolload_sf2 (std::string)
boolmidi_event (unsigned char*, unsigned long)
-
Methods
boolisnil ()
boolsameinstance (GainControl)

Inherited from ARDOUR:SlavableAutomationControl,

@@ -1086,7 +1070,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C - + @@ -1115,7 +1099,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C - + @@ -1128,7 +1112,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C -
voidset_automation_state (AutoState)
voidset_automation_style (AutoStyle)
voidset_value (double, GroupControlDisposition)

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

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.
voidstart_touch (double)
voidstop_touch (bool, double)
boolwritable ()
Methods
boolactive ()
intadd_port (std::string, void*, DataType)

Add a port.

destination Name of port to connect new port to.
src Source for emitted ConfigurationChanged signal.
type Data type of port. Default value (NIL) will use this IO's default type.

Add a port.

destination
Name of port to connect new port to.
src
Source for emitted ConfigurationChanged signal.
type
Data type of port. Default value (NIL) will use this IO's default type.
AudioPortaudio (unsigned int)
intconnect (Port, std::string, void*)
intdisconnect (Port, std::string, void*)
boolphysically_connected ()
Portport_by_name (unsigned int)
intremove_port (Port, void*)
boolsameinstance (IO)

Inherited from ARDOUR:SessionObject

@@ -1150,7 +1133,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C -
ChanCountnatural_input_streams ()
ChanCountnatural_output_streams ()
IOoutput ()
boolsameinstance (IOProcessor)

Inherited from ARDOUR:Processor

@@ -1215,10 +1197,10 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C - + - +
intmove_to (long, unsigned int)
std::stringname ()
intset_end (long, bool, bool, unsigned int)

Set end position.

force true to force setting, even if the given new end is before the current start.
allow_beat_recompute True to recompute BEAT end time from the new given end time.
s New end.

Set end position.

force
true to force setting, even if the given new end is before the current start.
allow_beat_recompute
True to recompute BEAT end time from the new given end time.
s
New end.
intset_length (long, long, bool, unsigned int)
intset_start (long, bool, bool, unsigned int)

Set start position.

s New start.
force true to force setting, even if the given new start is after the current end.
allow_beat_recompute True to recompute BEAT start time from the new given start time.

Set start position.

s
New start.
force
true to force setting, even if the given new start is after the current end.
allow_beat_recompute
True to recompute BEAT start time from the new given start time.
longstart ()
voidunlock ()
@@ -1260,7 +1242,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C longfirst_mark_before (long, bool) LocationListlist () LuaTable(...)marks_either_side (long, long&, long&) -

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

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.

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)
voidremove (Location) Locationsession_range_location () @@ -1282,19 +1264,19 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C

A convenience function to expand RGBA parameters from an integer

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

Example:

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

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

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

get a plugin control parameter value

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

Returns value

+

get a plugin control parameter value

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

Returns value

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

get a plugin control parameter value

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

Returns value

+

get a plugin control parameter value

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

Returns value

...hsla_to_rgba (--lua--)

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

Example:

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

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

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

create a new Lua Processor (Plugin)

s Session Handle
p Identifier or Name of the Processor

Returns Processor object (may be nil)

+

create a new Lua Processor (Plugin)

s
Session Handle
p
Identifier or Name of the Processor

Returns Processor object (may be nil)

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

create a new Plugin Instance

s Session Handle
id Plugin Name, ID or URI
type Plugin Type

Returns Processor or nil

+

create a new Plugin Instance

s
Session Handle
id
Plugin Name, ID or URI
type
Plugin Type

Returns Processor or nil

PluginInfonew_plugin_info (std::string, PluginType) -

search a Plugin

id Plugin Name, ID or URI
type Plugin Type

Returns PluginInfo or nil if not found

+

search a Plugin

id
Plugin Name, ID or URI
type
Plugin Type

Returns PluginInfo or nil if not found

Processornil_proc () ...plugin_automation (--lua--)

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

This is equivalent to the following lua code

 function (processor, param_id)
@@ -1307,13 +1289,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

boolreset_processor_to_default (Processor) -

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.

proc
Plugin-Insert

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

...sample_to_timecode (--lua--)

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

boolset_plugin_insert_param (PluginInsert, unsigned int, float) -

set a plugin control-input parameter value

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

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.

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

boolset_processor_param (Processor, unsigned int, float) -

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

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

...timecode_to_sample (--lua--)

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

voidusleep (unsigned long) @@ -1326,7 +1308,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C ℂARDOUR.LuaAPI.Vamp (std::string, float) Methods intanalyze (Readable, unsigned int, Lua-Function) -

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.

r
readable
channel
channel to process
fn
lua callback function

Returns 0 on success

boolinitialize ()

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 +1317,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C
  StringVectorlist_plugins ()
  Pluginplugin ()
  FeatureSetprocess (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)

voidreset ()

call plugin():reset() and clear intialization flag

@@ -1346,10 +1328,10 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C - + - +
Constructor
ARDOUR.LuaOSC.Address (std::string)

Construct a new OSC transmitter object

uri the destination uri e.g. "osc.udp://localhost:7890"

Construct a new OSC transmitter object

uri
the destination uri e.g. "osc.udp://localhost:7890"
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

lua: lua arguments: path, types, ...

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

lua:
lua arguments: path, types, ...

Returns boolean true if successful, false on error.

 ARDOUR:LuaProc

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

@@ -1359,7 +1341,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C -
Methods
boolisnil ()
boolsameinstance (LuaProc)
DspShmshmem ()
LuaTableReftable ()
@@ -1452,7 +1433,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C boolpush_event (Event) voidresize (unsigned long)

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

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

- boolsameinstance (MidiBuffer) voidsilence (long, long)

Clear (eg zero, or empty) buffer

unsigned longsize () @@ -1469,7 +1449,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C boolisnil () NoteDiffCommandnew_note_diff_command (std::string)

Start a new NoteDiff command.

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

- boolsameinstance (MidiModel)

Inherited from ARDOUR:AutomatableSequence

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

Inherited from ARDOUR:Playlist

@@ -1546,10 +1524,10 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C Playlistcut (AudioRangeList&, bool) DataTypedata_type () voidduplicate (Region, long, long, float) -
gap from the beginning of the region to the next beginning
+
gap
from the beginning of the region to the next beginning
voidduplicate_range (AudioRange&, float) voidduplicate_until (Region, long, long, long) -
gap from the beginning of the region to the next beginning
end the first frame that does _not_ contain a duplicated frame
+
gap
from the beginning of the region to the next beginning
end
the first frame that does _not_ contain a duplicated frame
Regionfind_next_region (long, RegionPoint, int) longfind_next_region_boundary (long, int) voidlower_region (Region) @@ -1561,7 +1539,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C RegionListPtrregion_list () RegionListPtrregions_at (long) RegionListPtrregions_touched (long, long) -
start Range start.
end Range end.

Returns regions which have some part within this range.

+
start
Range start.
end
Range end.

Returns regions which have some part within this range.

RegionListPtrregions_with_end_within (Range) RegionListPtrregions_with_start_within (Range) voidremove_region (Region) @@ -1591,7 +1569,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C MidiBufferget_midi_buffer (unsigned int) boolinput_active () boolisnil () - boolsameinstance (MidiPort) voidset_input_active (bool)

Inherited from ARDOUR:Port

@@ -1601,7 +1578,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C boolconnected ()

Returns true if this port is connected to anything

boolconnected_to (std::string) -
o Port name

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

+
o
Port name

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

intdisconnect (std::string) intdisconnect_all () std::stringname () @@ -1629,7 +1606,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C doublelength_beats () MidiSourcemidi_source (unsigned int) MidiModelmodel () - boolsameinstance (MidiRegion) doublestart_beats ()

Inherited from ARDOUR:Region

@@ -1678,7 +1654,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C voidset_position_locked (bool) voidset_start (long) voidset_sync_position (long) -

Set the region's sync point.

absolute_pos Session time.
+

Set the region's sync point.

absolute_pos
Session time.
voidset_video_locked (bool) floatshift () Sourcesource (unsigned int) @@ -1717,7 +1693,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C boolisnil () longlength (long) MidiModelmodel () - boolsameinstance (MidiSource)

Inherited from ARDOUR:Source

@@ -1752,17 +1727,16 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C
-
Methods
boolisnil ()
boolsameinstance (MidiTrack)

Inherited from ARDOUR:Track

- + - + - + @@ -1775,12 +1749,12 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C - + - + @@ -1795,14 +1769,14 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C - + - + - + @@ -1914,7 +1888,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C - @@ -1978,7 +1951,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C -
Methods
Regionbounce (InterThreadInfo&)

bounce track from session start to session end to new region

itt asynchronous progress report and cancel

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

bounce track from session start to session end to new region

itt
asynchronous progress report and cancel

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

Regionbounce_range (long, long, InterThreadInfo&, Processor, bool)

Bounce the given range to a new audio region.

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

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

Bounce the given range to a new audio region.

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

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

boolbounceable (Processor, bool)

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

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

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

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

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

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

boolcan_record ()
Playlistplaylist ()
boolset_name (std::string)
Methods
boolactive ()
intadd_processor_by_index (Processor, int, ProcessorStreams, bool)

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

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

Returns 0 on success, non-0 on failure.

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

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

Returns 0 on success, non-0 on failure.

booladd_sidechain (Processor)
Ampamp ()
std::stringcomment ()
boolcustomize_plugin_insert (Processor, unsigned int, ChanCount, ChanCount)

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

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

IOinput ()
Deliverymain_outs ()

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

PeakMeterpeak_meter ()

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

intremove_processor (Processor, ProcessorStreams, bool)

remove plugin/processor

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

Returns 0 on success

remove plugin/processor

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

Returns 0 on success

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

replace plugin/processor with another

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

Returns 0 on success

replace plugin/processor with another

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

Returns 0 on success

boolreset_plugin_insert (Processor)

reset plugin-insert configuration to default, disable customizations.

This is equivalent to calling

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

Returns true if successful

reset plugin-insert configuration to default, disable customizations.

This is equivalent to calling

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

Returns true if successful

voidset_active (bool, void*)
voidset_comment (std::string, void*)
voidset_meter_point (MeterPoint, bool)
boolmonitor_active ()
boolmono ()
Controllablemono_control ()
boolsameinstance (MonitorProcessor)
voidset_cut (unsigned int, bool)
voidset_cut_all (bool)
voidset_dim (unsigned int, bool)
boolisnil ()
boolmuted ()
boolmuted_by_self ()
boolsameinstance (MuteControl)

Inherited from ARDOUR:SlavableAutomationControl,

@@ -2002,7 +1974,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C - + @@ -2037,7 +2009,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C -
voidset_automation_state (AutoState)
voidset_automation_style (AutoStyle)
voidset_value (double, GroupControlDisposition)

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

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.
voidstart_touch (double)
voidstop_touch (bool, double)
boolwritable ()
Methods
boolbypassed ()
boolisnil ()
boolsameinstance (PannerShell)
voidset_bypassed (bool)

Inherited from ARDOUR:SessionObject

@@ -2086,7 +2057,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C boolisnil () floatmeter_level (unsigned int, MeterType) voidreset_max () - boolsameinstance (PeakMeter) voidset_type (MeterType)

Inherited from ARDOUR:Processor

@@ -2128,9 +2098,8 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C Methods boolinverted (unsigned int) boolisnil () - boolsameinstance (PhaseControl) voidset_phase_invert (unsigned int, bool) -
c Audio channel index.
yn true to invert phase, otherwise false.
+
c
Audio channel index.
yn
true to invert phase, otherwise false.

Inherited from ARDOUR:AutomationControl

@@ -2143,7 +2112,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C - + @@ -2177,10 +2146,10 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C - + - + @@ -2193,11 +2162,10 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C - + - @@ -2238,7 +2206,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C - @@ -2269,7 +2236,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C
voidset_automation_state (AutoState)
voidset_automation_style (AutoStyle)
voidset_value (double, GroupControlDisposition)

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

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.
voidstart_touch (double)
voidstop_touch (bool, double)
boolwritable ()
Playlistcut (AudioRangeList&, bool)
DataTypedata_type ()
voidduplicate (Region, long, long, float)
gap from the beginning of the region to the next beginning
gap
from the beginning of the region to the next beginning
voidduplicate_range (AudioRange&, float)
voidduplicate_until (Region, long, long, long)
gap from the beginning of the region to the next beginning
end the first frame that does _not_ contain a duplicated frame
gap
from the beginning of the region to the next beginning
end
the first frame that does _not_ contain a duplicated frame
Regionfind_next_region (long, RegionPoint, int)
longfind_next_region_boundary (long, int)
boolisnil ()
RegionListPtrregion_list ()
RegionListPtrregions_at (long)
RegionListPtrregions_touched (long, long)
start Range start.
end Range end.

Returns regions which have some part within this range.

start
Range start.
end
Range end.

Returns regions which have some part within this range.

RegionListPtrregions_with_end_within (Range)
RegionListPtrregions_with_start_within (Range)
voidremove_region (Region)
boolsameinstance (Playlist)
voidsplit (long)
voidsplit_region (Region, MusicFrame)
Regiontop_region_at (long)
boolparameter_is_input (unsigned int)
PresetRecordpreset_by_label (std::string)
PresetRecordpreset_by_uri (std::string)
boolsameinstance (Plugin)
std::stringunique_id ()
Cast
LuaProcto_luaproc ()
-
Methods
boolisnil ()
boolsameinstance (PluginControl)

Inherited from ARDOUR:AutomationControl

@@ -2282,7 +2248,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C - + @@ -2312,7 +2278,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C - @@ -2339,7 +2304,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C - @@ -2381,7 +2345,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C - + @@ -2391,7 +2355,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C - @@ -2432,7 +2395,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C - + @@ -2455,9 +2418,8 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C - + -
voidset_automation_state (AutoState)
voidset_automation_style (AutoStyle)
voidset_value (double, GroupControlDisposition)

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

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.
voidstart_touch (double)
voidstop_touch (bool, double)
boolwritable ()
PresetVectorget_presets (bool)
boolis_instrument ()
boolisnil ()
boolsameinstance (PluginInfo)
Data Members
std::stringcategory
std::stringcreator
ChanMappingoutput_map (unsigned int)
Pluginplugin (unsigned int)
boolreset_parameters_to_default ()
boolsameinstance (PluginInsert)
voidset_input_map (unsigned int, ChanMapping)
voidset_output_map (unsigned int, ChanMapping)
boolstrict_io_configured ()
boolconnected ()

Returns true if this port is connected to anything

boolconnected_to (std::string)
o Port name

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

o
Port name

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

intdisconnect (std::string)
intdisconnect_all ()
boolisnil ()

Returns Port human readable name

boolreceives_input ()

Returns true if this Port receives input, otherwise false

boolsameinstance (Port)
boolsends_output ()

Returns true if this Port sends output, otherwise false

Cast
voidget_physical_inputs (DataType, StringVector&, MidiPortFlags, MidiPortFlags)
voidget_physical_outputs (DataType, StringVector&, MidiPortFlags, MidiPortFlags)
Portget_port_by_name (std::string)
name Full or short name of port

Returns Corresponding Port or 0.

name
Full or short name of port

Returns Corresponding Port or 0.

LuaTable(int, ...)get_ports (DataType, PortList&)
std::stringget_pretty_name_by_name (std::string)
ChanCountn_physical_inputs ()
boolisnil ()
unsigned longnum_ports (DataType)
Portport (DataType, unsigned long)

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

t data type
index port index

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

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

 ARDOUR:PresentationInfo

C‡: ARDOUR::PresentationInfo

@@ -2521,7 +2483,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C ChanCountinput_streams () boolisnil () ChanCountoutput_streams () - boolsameinstance (Processor) Cast Ampto_amp () Automatableto_automatable () @@ -2617,7 +2578,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C unsigned intn_channels () longread (FloatArray, long, long, int) longreadable_length () - boolsameinstance (Readable)

 ARDOUR:Region

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

@@ -2659,7 +2619,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C doublequarter_note () voidraise () voidraise_to_top () - boolsameinstance (Region) voidset_hidden (bool) voidset_initial_position (long)

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

@@ -2671,7 +2630,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C voidset_position_locked (bool) voidset_start (long) voidset_sync_position (long) -

Set the region's sync point.

absolute_pos Session time.
+

Set the region's sync point.

absolute_pos
Session time.
voidset_video_locked (bool) floatshift () Sourcesource (unsigned int) @@ -2746,12 +2705,12 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C Methods boolactive () intadd_processor_by_index (Processor, int, ProcessorStreams, bool) -

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

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

Returns 0 on success, non-0 on failure.

+

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

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

Returns 0 on success, non-0 on failure.

booladd_sidechain (Processor) Ampamp () std::stringcomment () boolcustomize_plugin_insert (Processor, unsigned int, ChanCount, ChanCount) -

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

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

IOinput () boolisnil () Deliverymain_outs () @@ -2767,15 +2726,14 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C PeakMeterpeak_meter ()

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

intremove_processor (Processor, ProcessorStreams, bool) -

remove plugin/processor

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

Returns 0 on success

+

remove plugin/processor

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

Returns 0 on success

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

replace plugin/processor with another

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

Returns 0 on success

+

replace plugin/processor with another

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

Returns 0 on success

boolreset_plugin_insert (Processor) -

reset plugin-insert configuration to default, disable customizations.

This is equivalent to calling

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

Returns true if successful

- boolsameinstance (Route) +

reset plugin-insert configuration to default, disable customizations.

This is equivalent to calling

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

Returns true if successful

voidset_active (bool, void*) voidset_comment (std::string, void*) voidset_meter_point (MeterPoint, bool) @@ -2861,7 +2819,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C - + @@ -2952,14 +2910,14 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C - + - + - + @@ -3008,7 +2966,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C - + @@ -3214,7 +3172,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C - @@ -3227,7 +3184,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C
Methods
intadd (Route)

Add a route to a group. Adding a route which is already in the group is allowed; nothing will happen.

r Route to add.

Add a route to a group. Adding a route which is already in the group is allowed; nothing will happen.

r
Route to add.
voidclear ()
voiddestroy_subgroup ()
boolempty ()
voidadd_command (Command)
voidadd_internal_sends (Route, Placement, RouteListPtr)
StatefulDiffCommandadd_stateful_diff_command (StatefulDestructiblePtr)

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

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

sfd the object to diff

Returns the allocated StatefulDiffCommand (already added via add_command)

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

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

sfd
the object to diff

Returns the allocated StatefulDiffCommand (already added via add_command)

voidbegin_reversible_command (std::string)

begin collecting undo information

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

cmd_name human readable name for the undo operation

begin collecting undo information

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

cmd_name
human readable name for the undo operation
voidcancel_all_solo ()
SessionConfigurationcfg ()
voidclear_all_solo_state (RouteListPtr)
voidcommit_reversible_command (Command)

finalize an undo command and commit pending transactions

This must only be called after begin_reversible_command ()

cmd (additional) command to add

finalize an undo command and commit pending transactions

This must only be called after begin_reversible_command ()

cmd
(additional) command to add
Controllablecontrollable_by_id (ID)
longcurrent_end_frame ()
longcurrent_start_frame ()
...sample_to_timecode_lua (--lua--)
doublesamples_per_timecode_frame ()
intsave_state (std::string, bool, bool, bool)

save session

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

Returns zero on success

save session

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

Returns zero on success

voidscripts_changed ()
voidset_control (AutomationControl, double, GroupControlDisposition)
voidset_controls (ControlListPtr, double, GroupControlDisposition)
Methods
boolisnil ()
std::stringname ()
boolsameinstance (SessionObject)
Cast
Statefulto_stateful ()
StatefulDestructibleto_statefuldestructible ()
-
Methods
boolisnil ()
boolsameinstance (SideChain)

Inherited from ARDOUR:IOProcessor

@@ -3280,7 +3236,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C -
doubleget_masters_value ()
boolisnil ()
voidremove_master (AutomationControl)
boolsameinstance (SlavableAutomationControl,)
boolslaved ()
boolslaved_to (AutomationControl)
@@ -3295,7 +3250,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C voidset_automation_state (AutoState) voidset_automation_style (AutoStyle) voidset_value (double, GroupControlDisposition) -

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

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.
voidstart_touch (double) voidstop_touch (bool, double) boolwritable () @@ -3324,7 +3279,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C Methods boolcan_solo () boolisnil () - boolsameinstance (SoloControl) boolself_soloed () boolsoloed () @@ -3350,7 +3304,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C voidset_automation_state (AutoState) voidset_automation_style (AutoStyle) voidset_value (double, GroupControlDisposition) -

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

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.
voidstart_touch (double) voidstop_touch (bool, double) boolwritable () @@ -3378,7 +3332,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C -
Methods
boolisnil ()
boolsameinstance (SoloIsolateControl)
boolself_solo_isolated ()
boolsolo_isolated ()
@@ -3404,7 +3357,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C voidset_automation_state (AutoState) voidset_automation_style (AutoStyle) voidset_value (double, GroupControlDisposition) -

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

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.
voidstart_touch (double) voidstop_touch (bool, double) boolwritable () @@ -3432,7 +3385,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C -
Methods
boolisnil ()
boolsameinstance (SoloSafeControl)
boolsolo_safe ()

Inherited from ARDOUR:SlavableAutomationControl,

@@ -3457,7 +3409,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C voidset_automation_state (AutoState) voidset_automation_style (AutoStyle) voidset_value (double, GroupControlDisposition) -

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

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.
voidstart_touch (double) voidstop_touch (bool, double) boolwritable () @@ -3492,7 +3444,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C boolisnil () longlength (long) longnatural_position () - boolsameinstance (Source) longtimeline_position () longtimestamp () intuse_count () @@ -3568,7 +3519,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C PresentationInfopresentation_info_ptr () AutomationControlrec_enable_control () AutomationControlrec_safe_control () - boolsameinstance (Stripable) AutomationControlsend_enable_control (unsigned int) AutomationControlsend_level_control (unsigned int) std::stringsend_name (unsigned int) @@ -3594,13 +3544,12 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C

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

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

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

sr samplerate

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

sr
samplerate
doubleframes_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.

sr samplerate

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

sr
samplerate
doublenote_type ()
doublenote_types_per_minute ()
doublequarter_notes_per_minute ()
- + - + @@ -3645,15 +3594,14 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C
Methods
MeterSectionadd_meter (Meter, double, BBT_TIME, long, PositionLockStyle)
TempoSectionadd_tempo (Tempo, double, long, Type, PositionLockStyle)
TempoSectionadd_tempo (Tempo, double, long, PositionLockStyle)
BBT_TIMEbbt_at_frame (long)

Returns the BBT time corresponding to the supplied frame position.

frame the position in audio samples.

Returns the BBT time at the frame position .

Returns the BBT time corresponding to the supplied frame position.

frame
the position in audio samples.

Returns the BBT time at the frame position .

doubleexact_beat_at_frame (long, int)
doubleexact_qn_at_frame (long, int)
MeterSectionmeter_section_at_beat (double)
- + - + - + - @@ -3664,12 +3612,12 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C - + - + @@ -3684,14 +3632,14 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C - + - + - + @@ -3769,7 +3717,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C
Methods
Regionbounce (InterThreadInfo&)

bounce track from session start to session end to new region

itt asynchronous progress report and cancel

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

bounce track from session start to session end to new region

itt
asynchronous progress report and cancel

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

Regionbounce_range (long, long, InterThreadInfo&, Processor, bool)

Bounce the given range to a new audio region.

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

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

Bounce the given range to a new audio region.

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

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

boolbounceable (Processor, bool)

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

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

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

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

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

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

boolcan_record ()
boolisnil ()
Playlistplaylist ()
boolsameinstance (Track)
boolset_name (std::string)
Cast
AudioTrackto_audio_track ()
Methods
boolactive ()
intadd_processor_by_index (Processor, int, ProcessorStreams, bool)

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

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

Returns 0 on success, non-0 on failure.

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

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

Returns 0 on success, non-0 on failure.

booladd_sidechain (Processor)
Ampamp ()
std::stringcomment ()
boolcustomize_plugin_insert (Processor, unsigned int, ChanCount, ChanCount)

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

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

IOinput ()
Deliverymain_outs ()

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

PeakMeterpeak_meter ()

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

intremove_processor (Processor, ProcessorStreams, bool)

remove plugin/processor

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

Returns 0 on success

remove plugin/processor

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

Returns 0 on success

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

replace plugin/processor with another

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

Returns 0 on success

replace plugin/processor with another

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

Returns 0 on success

boolreset_plugin_insert (Processor)

reset plugin-insert configuration to default, disable customizations.

This is equivalent to calling

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

Returns true if successful

reset plugin-insert configuration to default, disable customizations.

This is equivalent to calling

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

Returns true if successful

voidset_active (bool, void*)
voidset_comment (std::string, void*)
voidset_meter_point (MeterPoint, bool)
-
Methods
boolisnil ()
boolsameinstance (UnknownProcessor)

Inherited from ARDOUR:Processor

@@ -3899,7 +3846,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C - + @@ -3949,7 +3896,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C - + @@ -3967,17 +3914,17 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C - + - + - + - + @@ -3993,7 +3940,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C - +
voidclear_playlist (Playlist)
voidclear_playlists (TimeAxisView)
voidconsider_auditioning (Region)

Possibly start the audition of a region. If

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

Possibly start the audition of a region. If

r
is 0, or not an AudioRegion any current audition is cancelled. If we are currently auditioning
r
will start.
r
Region to consider.
r,
the audition will be cancelled. Otherwise an audition of
voidcopy_playlists (TimeAxisView)
MouseModecurrent_mouse_mode ()

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

voidplay_selection ()
voidplay_with_preroll ()
voidredo (unsigned int)

Redo some transactions.

n Number of transaction to redo.

Redo some transactions.

n
Number of transaction to redo.
RegionViewregionview_from_region (Region)
voidremove_last_capture ()
voidremove_location_at_playhead_cursor ()
voidselect_all_tracks ()
voidseparate_region_from_selection ()
voidset_follow_playhead (bool, bool)

Set whether the editor should follow the playhead.

yn true to follow playhead, otherwise false.
catch_up true to reset the editor view to show the playhead (if yn == true), otherwise false.

Set whether the editor should follow the playhead.

yn
true to follow playhead, otherwise false.
catch_up
true to reset the editor view to show the playhead (if yn == true), otherwise false.
voidset_loop_range (long, long, std::string)
voidset_mouse_mode (MouseMode, bool)

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

m Mouse mode (defined in editing_syms.h)
force Perform the effects of the change even if no change is required (ie even if the current mouse mode is equal to

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

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

Set the snap mode.

m Snap mode (defined in editing_syms.h)

Set the snap mode.

m
Snap mode (defined in editing_syms.h)
voidset_snap_threshold (double)

Set the snap threshold.

t Snap threshold in `units'.

Set the snap threshold.

t
Snap threshold in `units'.
voidset_stationary_playhead (bool)
voidset_video_timeline_height (int)
voidset_zoom_focus (ZoomFocus)
voidtoggle_ruler_video (bool)
voidtoggle_xjadeo_proc (int)
voidundo (unsigned int)

Undo some transactions.

n Number of transactions to undo.

Undo some transactions.

n
Number of transactions to undo.
doublevisible_canvas_height ()

 ArdourUI:MarkerSelection

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

Clear everything from the Selection

voidclear_all () boolempty (bool) -

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

internal_selection
also check object internals (e.g midi notes, automation points), when false only check objects.

Returns true if nothing is selected.

Data Members ArdourUI:MarkerSelectionmarkers ArdourUI:RegionSelectionregions @@ -4198,7 +4145,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C LuaMetaTablearray () LuaTableget_table () unsigned char*offset (unsigned int) - boolsameinstance (unsigned char*) voidset_table (LuaTable {unsigned char})

 C:DoubleVector

@@ -4225,7 +4171,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C LuaMetaTablearray () LuaTableget_table () FloatArrayoffset (unsigned int) - boolsameinstance (FloatArray) voidset_table (LuaTable {float})

 C:FloatArrayVector

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

 C:StringList

@@ -4316,9 +4260,9 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C context->translate(x, y); context->scale(width / 2.0, height / 2.0); context->arc(0.0, 0.0, 1.0, 0.0, 2 * M_PI); - context->restore();
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
+ context->restore();
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
voidarc_negative (double, double, double, double, double) -

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.

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
voidbegin_new_path ()

Clears the current path. After this call there will be no current point.

voidbegin_new_sub_path () @@ -4330,65 +4274,65 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C voidclose_path ()

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.

voidcurve_to (double, double, double, double, double, double) -

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

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
voidfill ()

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

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

voidline_to (double, double) -

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

x
the X coordinate of the end of the new line
y
the Y coordinate of the end of the new line
voidmove_to (double, double) -

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

x
the X coordinate of the new position
y
the Y coordinate of the new position
voidpaint ()

A drawing operator that paints the current source everywhere within the current clip region.

voidpaint_with_alpha (double) -

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.

alpha
an alpha value, between 0 (transparent) and 1 (opaque)
voidrectangle (double, double, double, double)

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
+ 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
voidrel_curve_to (double, double, double, double, double, double) -

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.

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
voidrel_line_to (double, double) -

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.

dx
the X offset to the end of the new line
dy
the Y offset to the end of the new line
voidrel_move_to (double, double) -

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.

dx
the X offset
dy
the Y offset
voidreset_clip ()

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.

voidrestore ()

Restores cr to the state saved by a preceding call to save() and removes that state from the stack of saved states.

save()

voidrotate (double) -

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.

angle
angle (in radians) by which the user-space axes will be rotated
voidsave ()

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

voidscale (double, double) -

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.

sx
scale factor for the X dimension
sy
scale factor for the Y dimension
voidset_dash (DoubleVector, double) -

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

dashes
an array specifying alternate lengths of on and off portions
offset
an offset into the dash pattern at which the stroke should start
voidset_font_size (double) -

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.

size
the new font size, in user space units)
voidset_line_cap (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.

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.

line_cap
a line cap style, as a LineCap
voidset_line_join (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.

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.

line_join
a line joint style, as a LineJoin
voidset_line_width (double) -

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.

width
a line width, as a user-space value
voidset_operator (Operator) -

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.

op
a compositing operator, specified as a Operator
voidset_source_rgb (double, double, double) -

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

red
red component of color
green
green component of color
blue
blue component of color
voidset_source_rgba (double, double, double, double) -

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

red
red component of color
green
green component of color
blue
blue component of color
alpha
alpha component of color
voidshow_text (std::string) -

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.

utf8
a string containing text encoded in UTF-8
voidstroke ()

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.

voidstroke_preserve ()

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

voidtranslate (double, double) -

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.

tx
amount to translate in the X direction
ty
amount to translate in the Y direction
voidunset_dash ()

This function disables a dash pattern that was set with set_dash()

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

Queries whether the layout had to wrap any paragraphs.

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

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

voidlayout_cairo_path (Context) voidset_ellipsize (EllipsizeMode) -

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

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

ellipsize The new ellipsization mode for layout.
+

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

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

ellipsize
The new ellipsization mode for layout.
voidset_markup (std::string) -

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.

markup
Some marked-up text.
voidset_text (std::string) -

Set the text of the layout.

text The text for the layout.
+

Set the text of the layout.

text
The text for the layout.
voidset_width (int) -

Sets the width to which the lines of the Pango::Layout should wrap or ellipsized. The default value is -1: no width set.

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.

width
The desired width in Pango units, or -1 to indicate that no wrapping or ellipsization should be performed.
voidset_wrap (WrapMode) -

Sets the wrap mode; the wrap mode only has effect if a width is set on the layout with set_width(). To turn off wrapping, set the width to -1.

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.

wrap
The wrap mode.
voidshow_in_cairo_context (Context)

 Evoral:Beats

@@ -4461,7 +4405,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C Methods boolisnil () ControlListlist () - boolsameinstance (Control)

 Evoral:ControlList

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

@@ -4470,26 +4413,25 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C - + - + - + - - + - + - + - + - +
Methods
voidadd (double, double, bool, bool)

add automation events

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

add automation events

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

remove all automation events between the given time range

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

remove all automation events between the given time range

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

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

where absolute time in samples

Returns parameter value

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

where
absolute time in samples

Returns parameter value

boolin_write_pass ()
InterpolationStyleinterpolation ()

query interpolation style of the automation data

Returns Interpolation Style

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

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

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

Returns parameter value

boolsameinstance (ControlList)

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

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

Returns parameter value

voidset_interpolation (InterpolationStyle)

set the interpolation style of the automation data

is interpolation style

set the interpolation style of the automation data

is
interpolation style
voidthin (double)

Thin the number of events in this list.

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

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

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

thinning_factor area-size (default: 20)

Thin the number of events in this list.

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

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

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

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

truncate the event list after the given time

last_coordinate last event to include

truncate the event list after the given time

last_coordinate
last event to include
voidtruncate_start (double)

truncate the event list to the given time

overall_length overall length

truncate the event list to the given time

overall_length
overall length

 Evoral:ControlSet

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

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

 Evoral:Event

C‡: Evoral::Event<long>

@@ -4524,7 +4465,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C Beatslength () unsigned charnote () unsigned charoff_velocity () - boolsameinstance (NotePtr) Beatstime () unsigned charvelocity () @@ -4574,7 +4514,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C -
Methods
boolisnil ()
boolsameinstance (Sequence)

 LuaSignal:Set

C‡: std::bitset<47ul>

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

Inherited from PBD:StatefulPtr

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

Inherited from PBD:StatefulPtr

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

 PBD:XMLNode

C‡: XMLNode

@@ -5739,6 +5675,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C
  • Vamp:PluginBase:ParameterList
  • Vamp:RealTime
  • - + -
    Ardour 5.7  -  Mon, 27 Feb 2017 15:02:46 +0100
    +
    Ardour 5.8-155-g51d43c6e1  -  Thu, 16 Mar 2017 21:47:44 +0100