X-Git-Url: http://shamusworld.gotdns.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=_manual%2F24_lua-scripting%2F02_class_reference.html;h=503e8774823dab3f07dd8ab589f2625ac0992a1c;hb=fd1ad5d44650630a40b1afa2bd6c5278737346b9;hp=5eda47511dea025eac580520dc889c8ebc41f751;hpb=270b992a673aee5cec1d2ac347c57dff4ed0d300;p=ardour-manual-diverged diff --git a/_manual/24_lua-scripting/02_class_reference.html b/_manual/24_lua-scripting/02_class_reference.html index 5eda475..503e877 100644 --- a/_manual/24_lua-scripting/02_class_reference.html +++ b/_manual/24_lua-scripting/02_class_reference.html @@ -146,10 +146,12 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to C
ChanCount | n_physical_inputs () | |
ChanCount | n_physical_outputs () | |
bool | physically_connected (std::string) | |
--MISSING (ARDOUR::PortEngine&)-- | port_engine () | |
PortEngine | port_engine () | |
bool | port_is_physical (std::string) |
Returns true if this Port receives input, otherwise false
Returns true if this Port sends output, otherwise false
C‡: ARDOUR::AudioRange
@@ -379,6 +384,8 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to Cremove plugin/processor
Returns 0 on success
void | deactivate () | |
std::string | display_name () | |
Cast | ||
---|---|---|
Amp | to_amp () | |
Automatable | to_automatable () | |
PluginInsert | to_insert () | |
IOProcessor | to_ioprocessor () | |
SideChain | to_sidechain () | |
UnknownProcessor | to_unknownprocessor () |
Methods | ||
---|---|---|
bool | empty () | |
bool | push_back (long, unsigned long, unsigned char*) | |
bool | push_event (MidiEvent) | |
bool | sameinstance (MidiBuffer) | |
void | silence (long, long) | |
Clear (eg zero, or empty) buffer | ||
... | table (--lua--) |
C‡: boost::shared_ptr< ARDOUR::MidiPort >, boost::weak_ptr< ARDOUR::MidiPort >
@@ -951,6 +964,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to CMethods | ||
---|---|---|
MidiBuffer | get_midi_buffer (unsigned int) | |
bool | input_active () | |
bool | isnil () | |
void | set_input_active (bool) | |
Returns true if this Port receives input, otherwise false | ||
bool | sends_output () | |
Returns true if this Port sends output, otherwise false | ||
Cast | ||
AudioPort | to_audioport () | |
MidiPort | to_midiport () |
C‡: boost::shared_ptr< ARDOUR::MidiTrack >, boost::weak_ptr< ARDOUR::MidiTrack >
@@ -1022,6 +1039,8 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to Cremove plugin/processor
Returns 0 on success
Returns true if this Port receives input, otherwise false | ||
bool | sends_output () | |
Returns true if this Port sends output, otherwise false | ||
Cast | ||
---|---|---|
AudioPort | to_audioport () | |
MidiPort | to_midiport () |
C‡: ARDOUR::PortEngine
+ +PortEngine is an abstract base class that defines the functionality required by Ardour.
A Port is basically an endpoint for a datastream (which can either be continuous, like audio, or event-based, like MIDI). Ports have buffers associated with them into which data can be written (if they are output ports) and from which data can be read (if they input ports). Ports can be connected together so that data written to an output port can be read from an input port. These connections can be 1:1, 1:N OR N:1.
Ports may be associated with software only, or with hardware. Hardware related ports are often referred to as physical, and correspond to some relevant physical entity on a hardware device, such as an audio jack or a MIDI connector. Physical ports may be potentially asked to monitor their inputs, though some implementations may not support this.
Most physical ports will also be considered "terminal", which means that data delivered there or read from there will go to or comes from a system outside of the PortEngine implementation's control (e.g. the analog domain for audio, or external MIDI devices for MIDI). Non-physical ports can also be considered "terminal". For example, the output port of a software synthesizer is a terminal port, because the data contained in its buffer does not and cannot be considered to come from any other port - it is synthesized by its owner.
Ports also have latency associated with them. Each port has a playback latency and a capture latency:
capture latency: how long since the data read from the buffer of a port arrived at at a terminal port. The data will have come from the "outside world" if the terminal port is also physical, or will have been synthesized by the entity that owns the terminal port.
playback latency: how long until the data written to the buffer of port will reach a terminal port.
For more detailed questions about the PortEngine API, consult the JACK API documentation, on which this entire object is based.
This class object is only used indirectly as return-value and function-parameter. It provides no methods by itself.
C‡: std::list<boost::shared_ptr<ARDOUR::Port> >
@@ -1312,7 +1341,7 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to CChanCount | n_inputs () | |
ChanCount | n_outputs () | |
Processor | nth_plugin (unsigned int) | |
Processor | nth_processor (unsigned int) | |
Processor | nth_send (unsigned int) | |
int | remove_processor (Processor, ProcessorStreams, bool) | |
remove plugin/processor
Returns 0 on success | ||
bool | remove_sidechain (Processor) | |
void | deactivate () | |
std::string | display_name () | |
Cast | ||
---|---|---|
Amp | to_amp () | |
Automatable | to_automatable () | |
PluginInsert | to_insert () | |
IOProcessor | to_ioprocessor () | |
SideChain | to_sidechain () | |
UnknownProcessor | to_unknownprocessor () |
Methods | ||
---|---|---|
void | add_meter (Meter, BBT_TIME) | |
void | add_tempo (Tempo, BBT_TIME) | |
--MISSING (ARDOUR::MeterSection*)-- | add_meter (Meter, double, BBT_TIME, long, --MISSING (ARDOUR::PositionLockStyle)--) | |
--MISSING (ARDOUR::TempoSection*)-- | add_tempo (Tempo, double, long, --MISSING (ARDOUR::TempoSection::Type)--, --MISSING (ARDOUR::PositionLockStyle)--) |
C‡: boost::shared_ptr< ARDOUR::Track >, boost::weak_ptr< ARDOUR::Track >
@@ -1794,6 +1829,8 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to Cremove plugin/processor
Returns 0 on success
C‡: boost::shared_ptr< ARDOUR::UnknownProcessor >, boost::weak_ptr< ARDOUR::UnknownProcessor >
+is-a: ARDOUR:Processor
+ +A stub Processor that can be used in place of a `real' one that cannot be created for some reason; usually because it requires a plugin which is not present. UnknownProcessors are special-cased in a few places, notably in route configuration and signal processing, so that on encountering them configuration or processing stops.
When a Processor is missing from a Route, the following processors cannot be configured, as the missing Processor's output port configuration is unknown.
The main utility of the UnknownProcessor is that it allows state to be preserved, so that, for example, loading and re-saving a session on a machine without a particular plugin will not corrupt the session.
Methods | ||
---|---|---|
bool | isnil () |
Methods | ||
---|---|---|
void | activate () | |
bool | active () | |
AutomationControl | automation_control (Parameter, bool) | |
Control | control (Parameter, bool) | |
void | deactivate () | |
std::string | display_name () | |
Cast | ||
Amp | to_amp () | |
Automatable | to_automatable () | |
PluginInsert | to_insert () | |
IOProcessor | to_ioprocessor () | |
SideChain | to_sidechain () | |
UnknownProcessor | to_unknownprocessor () |
Methods | ||
---|---|---|
std::string | name () | |
Cast | ||
Stateful | to_stateful () | |
StatefulDestructible | to_statefuldestructible () |
C‡: std::list<boost::weak_ptr<ARDOUR::AudioSource> >
@@ -2289,8 +2360,8 @@ Pointer Classes cannot be created in lua scripts. It always requires a call to CMethods | ||
---|---|---|
unsigned char | channel () | |
unsigned char | set_channel () | |
unsigned char | set_type () | |
void | set_channel (unsigned char) | |
void | set_type (unsigned char) | |
unsigned char | type () |