X-Git-Url: http://shamusworld.gotdns.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=_manual%2F24_lua-scripting%2F02_class_reference.html;h=66aa47212cf01c0578ca504d4802ac2ee10093cb;hb=6e1d335671e9affda395ca068541291fc112eb74;hp=8f71da02847c9579a0cc935b75eca8d7bdb69203;hpb=2cb1352946cba2bb946114738fdb987ae1ce7f17;p=ardour-manual diff --git a/_manual/24_lua-scripting/02_class_reference.html b/_manual/24_lua-scripting/02_class_reference.html index 8f71da0..66aa472 100644 --- a/_manual/24_lua-scripting/02_class_reference.html +++ b/_manual/24_lua-scripting/02_class_reference.html @@ -10,6 +10,7 @@ This documention is far from complete may be inaccurate and subject to change.
+

Overview

The top-level entry point are ARDOUR:Session and ArdourUI:Editor. @@ -232,11 +233,13 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C boolactive () intadd_processor_by_index (Processor, int, ProcessorStreams, bool) std::stringcomment () + boolcustomize_plugin_insert (Processor, unsigned int, ChanCount) ChanCountn_inputs () ChanCountn_outputs () Processornth_plugin (unsigned int) intremove_processor (Processor, ProcessorStreams, bool) intreplace_processor (Processor, Processor, ProcessorStreams) + boolreset_plugin_insert (Processor) voidset_active (bool, void*) voidset_comment (std::string, void*) boolset_strict_io (bool) @@ -285,6 +288,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C Methods AutoStateautomation_state () doubleget_value () +

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

boolisnil () voidset_automation_style (AutoStyle) voidset_value (double, GroupControlDisposition) @@ -327,19 +331,35 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C

A count of channels, possibly with many types.

Operators are defined so this may safely be used as if it were a simple (single-typed) integer count of channels.

+ + + + + + + + + + + + + +
Constructor
ℂARDOUR.ChanCount (DataType, unsigned int)

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

unsigned intn_audio ()

query number of audio channels

Returns number of audio channels

unsigned intn_midi ()

query number of midi channels

Returns number of midi channels

unsigned intn_total ()

query total channel count of all data types

Returns total channel count (audio + 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

∁ ARDOUR:ChanMapping

C‡: ARDOUR::ChanMapping

-

A mapping from one set of channels to another (e.g. how to 'connect' two BufferSets).

+

A mapping from one set of channels to another (e.g. how to 'connect' two BufferSets).

for plugins the form is "pin" -> "buffer"

- + + +
Constructor
ℂARDOUR.ChanMapping ()
Methods
unsigned intget (DataType, unsigned int)
unsigned intget (DataType, unsigned int)

get buffer mapping for given data type and pin

from
pin
type
data type

Returns mapped buffer number (or ChanMapping::Invalid)

voidset (DataType, unsigned int, unsigned int)

set buffer mapping for given data type

from
pin
to
buffer
type
data type

ℕ ARDOUR.DSP

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

C‡: ARDOUR::Location

is-a: PBD:StatefulDestructible

-

Base class for objects with saveable and undoable state

+

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

@@ -462,8 +482,10 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C + +
Methods
longend ()
boollocked ()
intmove_to (long)
intset_end (long, bool, bool)

Set end position.

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

Set start position.

s
New start.
force
true to force setting, even if the given new start is after the current end.
allow_bbt_recompute
True to recompute BBT start time from the new given start time.
longstart ()

Inherited from PBD:Stateful

@@ -545,11 +567,13 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C boolactive () intadd_processor_by_index (Processor, int, ProcessorStreams, bool) std::stringcomment () + boolcustomize_plugin_insert (Processor, unsigned int, ChanCount) ChanCountn_inputs () ChanCountn_outputs () Processornth_plugin (unsigned int) intremove_processor (Processor, ProcessorStreams, bool) intreplace_processor (Processor, Processor, ProcessorStreams) + boolreset_plugin_insert (Processor) voidset_active (bool, void*) voidset_comment (std::string, void*) boolset_strict_io (bool) @@ -621,6 +645,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C boolisnil () char*label () boolload_preset (PresetRecord) +

Set parameters using a preset

char*maker () char*name () LuaTable(unsigned int, ...)nth_parameter (unsigned int, bool&) @@ -647,6 +672,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C Methods AutoStateautomation_state () doubleget_value () +

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

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.
@@ -684,7 +710,6 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C voidset_input_map (unsigned int, ChanMapping) voidset_no_inplace (bool) voidset_output_map (unsigned int, ChanMapping) - voidset_strict_io (bool) boolstrict_io_configured ()

Inherited from ARDOUR:Processor

@@ -806,6 +831,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C voidraise_to_top () 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.

voidset_length (long) voidset_locked (bool) voidset_muted (bool) @@ -814,6 +840,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.
voidset_video_locked (bool) floatshift () longstart () @@ -821,7 +848,9 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C boolsync_marked () LuaTable(long, ...)sync_offset (int&) longsync_position () +

Returns Sync position in session time

voidtrim_end (long) +
new_endpoint
New region end point, such that, for example, a region at 0 of length 10 has an endpoint of 9.
voidtrim_front (long) voidtrim_to (long, long) boolvalid_transients () @@ -854,12 +883,14 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C boolactive () intadd_processor_by_index (Processor, int, ProcessorStreams, bool) std::stringcomment () + boolcustomize_plugin_insert (Processor, unsigned int, ChanCount) boolisnil () ChanCountn_inputs () ChanCountn_outputs () Processornth_plugin (unsigned int) intremove_processor (Processor, ProcessorStreams, bool) intreplace_processor (Processor, Processor, ProcessorStreams) + boolreset_plugin_insert (Processor) voidset_active (bool, void*) voidset_comment (std::string, void*) boolset_name (std::string) @@ -916,7 +947,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C

∁ ARDOUR:Session

C‡: ARDOUR::Session

-

Base class for objects with saveable and undoable state

+

Ardour Session

@@ -947,6 +978,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C + @@ -999,7 +1031,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C

∁ ARDOUR:TempoMap

C‡: ARDOUR::TempoMap

-

Base class for objects with saveable and undoable state

+

Tempo Map - mapping of timecode to musical time. convert audio-samples, sample-rate to Bar/Beat/Tick, Meter/Tempo

Methods
boolactively_recording ()
Routeroute_by_name (std::string)
Routeroute_by_remote_id (unsigned int)
intsave_state (std::string, bool, bool, bool)
snapshot_name
Name to save under, without .ardour / .pending prefix
voidscripts_changed ()
voidset_dirty ()
std::stringsnap_name ()
@@ -1025,11 +1057,13 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C + + @@ -1101,11 +1135,12 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C

∅ ArdourUI:ArdourMarker

C‡: ArdourMarker

-

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

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

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

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

 signal
+

Location Marker

Editor ruler representation of a location marker or range on the timeline.

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

∁ ArdourUI:Editor

C‡: PublicEditor

+

This class contains just the public interface of the Editor class, in order to decouple it from the private implementation, so that callers of PublicEditor need not be recompiled if private methods or member variables change.

Methods
voidadd_meter (Meter, BBT_TIME)
boolactive ()
intadd_processor_by_index (Processor, int, ProcessorStreams, bool)
std::stringcomment ()
boolcustomize_plugin_insert (Processor, unsigned int, ChanCount)
ChanCountn_inputs ()
ChanCountn_outputs ()
Processornth_plugin (unsigned int)
intremove_processor (Processor, ProcessorStreams, bool)
intreplace_processor (Processor, Processor, ProcessorStreams)
boolreset_plugin_insert (Processor)
voidset_active (bool, void*)
voidset_comment (std::string, void*)
boolset_strict_io (bool)
@@ -1201,6 +1236,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C
Methods
voidaccess_action (std::string, std::string)
+ @@ -1492,7 +1528,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C

C‡: PBD::StatefulDestructible

is-a: PBD:Stateful

-

Base class for objects with saveable and undoable state

+

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

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

Inherited from PBD:Stateful

Methods
voidclear_all ()

Empty this RegionSelection.

longend_frame ()
unsigned longn_midi_regions ()
longstart ()
@@ -1838,6 +1874,4 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C
  • Timecode:BBT_TIME
    • -
    Ardour 4.7-469-g3f71e66  -  Sat, 26 Mar 2016 21:11:56 +0100
    - - +
    Ardour 4.7-535-g0818257  -  Thu, 31 Mar 2016 01:17:33 +0200