ecasound-iam (1)
NAME
ecasound-iam - ecasound interactive modeSYNOPSIS
DESCRIPTION
Ecasound library contains an interpreter module that understands a set of commands aimed at controlling various library services. This is called the ecasound interactive mode (EIAM). All programs linked to ecasound library can use this facility.
ECI API and return types
A special case of interactive mode use is ecasoundcqs control interface (ECI), which is a small library providing easy access to the interactive mode commands from outside of libecasound. When issuing inter commands using the control interface, itcqs possible that commands also return information. Currently supported return value types are: string [s], list of strings [S] (elements separated by commas; escaped if necessary), integer [i], long integer [li] and floating-point number [f]. These definitions are used throughout this document. Commands that return nothing (void) are marked with [-]. Additionally, return type [e] marks an error condition. When an interactive mode command results in an error, an error string explaining the condition is returned.
Limitations related to real-time control and modifications
Itcqs not possible to use all interactive mode commands to modify and control objects that belong to a connected chainsetup. Ecasound will automatically disconnect (and later try to reconnect) the chainsetup in case these commands are received while connected. Commands that have this limitation are:
- cs-remove, cs-set-length, cs-set-length-samples, cs-toggle-loop, cs-set-param, cs-option, c-add, c-remove, c-rename, c-clear, ai-add, ai-remove, ai-attach, ai-forward, ai-rewind, ai-set-position, ai-set-position-samples, ao-add, ao-add-default, ao-remove, ao-attach, ao-forward, ao-rewind, ao-set-position, ao-set-position-samples.
The following commands may be used on with a connected chainsetup, but they require pausing the engine temporarily (if running) and this can cause audible gaps to playback and recording. In practise this means it is currently not possible to add or remove chain operators in a gapless/seamless fashion. The affected commands:
- cop-add, ctrl-add,
The following commands can be used on a connected chainsetup and when the engine is running (not a complete list but at least these commands are supported):
- cop-set, copp-set, ctrlp-set, c-bypass, c-muting, setpos, cs-set-position, *-describe *-deselect, *-get, *-list, *-register *-select, *-selected, *-status, dump-*, int-*, jack-*, map-*
GENERAL
- quit, q
- Quit ecasound session. What this means in practice depends on the client implementation. In ecasound interactive mode, cqquitcq terminates the ecasound process. When sent over ecasound server connection (aka NetECI), cqquitcq terminates the active network connection, but does not terminate the ecasound server process. [-]
- start, t
- Processing is started (play). Error string is return if any errors upon startup are encountered. [e]
- stop, s
- Stop processing. [-]
- stop-sync, s
- Stop processing with a blocking call (do not return until engine has actually stopped). [-]
- run
- Like cqstartcq but blocks until processing is finished. Error string is return if any errors upon startup, or during process, are encountered. [e]
- debug cqdebug-levelcq
-
Set debug level to cqdebug-levelcq. Notice that client programs can
reimplement the debug routines. [-]
- resource-file cqpath-to-filecq
- Overrides the global and user resource files. Does not affect already created objects. This command is equivalent to cq-Rcq ecasound option (see ecasound (1) man page).
- -prefix:arg1,...,argN
- Equivalent to issuing cqcs-option -prefix:arg1,...,argN). See documentation for cqcs-optioncq.
- helpcq, cqhcq
- Help! [-]
GLOBAL
- engine-status
- Returns a string describing the engine status (running, stopped, finished, error, not ready). See also cs-status. [s]
- engine-launch
- Starts the real-time engine. Engine will execute the currently connected chainsetup (see cqcs-connect). This action does not yet start actual processing (see start and stop). When ecasound is used as a JACK client, issuing engine-launch makes ecasound an active JACK client (i.e. ecasoundcqs ports can be connected to other JACK clients). [-]
- engine-halt
- Stops the engine. Does not disconnect the chainsetup that was running. See also cs-disconnet and stop. When ecasound is used as a JACK client, engine-halt will cause ecasound to become a deactivated client (all JACK connections are torn down). [-]
CHAINSETUPS
Chainsetup is the central data object. All other objects (inputs, outputs, chains, etc) are connected to some chainsetup. There can be many chainsetups but only one can be connected. Similarly only one chainsetup can be selected. If not otherwise specified operations are done on the selected chainsetup. Some operations also require that selected chainsetup is not connected.- cs-add cqnamecq
- Adds a new chainsetup with name cqnamecq. cqnamecq is now the selected chainsetup. [-]
- cs-remove
- Removes currently selected chainsetup. [-]
- cs-list
- Returns a list of all chainsetups. [S]
- cs-select cqnamecq
- Selects chainsetup cqnamecq. [-]
- cs-selected
- Returns the name of currently selected chainsetup. [s]
- cs-index-select cqcs_indexcq, cs-iselect cqcs_indexcq
- Selects a chainsetup based on a short index string. Chainsetup names can be rather long. This command can be used to avoid typing these long names. cqcs_indexcq is an integer value, where cq1cq refers to the first audio input/output. You can use cqcs-listcq and cqcs-statuscq to get a full list of currently available chainsetups. [-]
- cs-load cqfilenamecq
- Adds a new chainsetup by loading it from file cqfilenamecq. cqfilenamecq is now the selected chainsetup. [-]
- cs-save
- Saves the currently selected chainsetup to file. If chainsetup was loaded from a file, the saved version will replace the original. If it doesncqt have a default filename, itcqs saved to dqchainsetup_name.ecsdq. [-]
- cs-save-as cqfilenamecq
- Saves currently selected chainsetup to file cqfilenamecq. [-]
- cs-edit
- Currently selected chainsetup is saved to a temporary file. This file is loaded to an external editor (see ecasoundrc (5)). After editing, the chainsetup is loaded back to ecasound. [-]
- cs-is-valid
- Whether currently selected chainsetup is valid (=can be connected)? [i]
- cs-connect
- Connect currently selected chainsetup to engine. When connecting, all resources (e.g. files, soundcard devices, external programs) needed to execute the chainsetup are reserved. Only one chainsetup can be connected at a time. Error string is returned if connection fails (for instance due to error in allocating the resources). [e]
- cs-disconnect
- Disconnect currently connected chainsetup. This action will free all external resources needed by the chainsetup. [-]
- cs-connected
- Returns the name of currently connected chainsetup. [s]
- cs-rewind cqtime-in-secondscq, rewind cqtime-in-secondscq, rw cqtime-in-secondscq
- Rewinds the current chainsetup position by cqtime-in-secondscq seconds. Position of all inputs and outputs attached to the selected chainsetup is also affected. [-]
- cs-forward cqtime-in-secondscq, forward cqtime-in-secondscq, fw cqttime-in-secondscq
- The current chainsetup position is forwarded by cqtime-in-secondscq seconds. Position of all inputs and outputs attached to the selected chainsetup is also affected. [-]
- cs-set-position cqtime-in-secondscq, cs-setpos cqtime-in-secondscq, setpos cqtime-in-secondscq, set-position cqtime-in-secondscq
- Sets the chainsetup position to cqtime-in-secondscq seconds from the beginning. Position of all inputs and outputs attached to the selected chainsetup is also affected. [-]
- cs-set-position-samples cqtime-in-samplescq
- Sets the chainsetup position to cqtime-in-samplescq samples from the beginning. Position of all inputs and outputs attached to the selected chainsetup is also affected. [-]
- cs-get-position, cs-getpos, getpos, get-position
- Returns the current chainsetup position in seconds. [f]
- cs-get-position-samples
- Returns the current chainsetup position in samples. [li]
- cs-get-length, get-length
- Returns the chainsetup length in seconds (if known). [f]
- cs-get-length-samples, get-length-samples
- Returns the chainsetup length in samples (if known). [li]
- cs-set-length cqsecondscq
- Sets processing time in seconds (doesncqt have to be an integer value). A special-case value of cq-1cq will set the chainsetup length according to the longest input object. [-]
- cs-set-length-samples cqsamplescq
- Sets processing time in samples. [-]
- cs-toggle-loop
- Toggle looping. When processing is finished, engine will start again from the initial position. Itcqs not always possible to enable looping (for instance all inputs and outputs have infinite length and chainsetup length is not explicitly set with cqcs-set-lengthcq). [-]
- cs-set-param
- Interpret general chainsetup parameters like for example dq-bdq (buffersize), dq-ndq (name), etc. See ecasound (1) for more info. [-]
- cs-set-audio-format cqbits,channels,sample_ratecq
- Set the default sample parameters for currently selected chainsetup. For example cd-quality audio would be dq16,2,44100dq. This does the same as command-line argument dq-fdq (see ecasound (1)). [-]
- cs-status, status, st
- Prints out status information about available chainsetup. Detailed information is printed out for connected (=available for running) nd selected (=available for editing) chainsetups. Other chainsetups are listed, but further details are suppressed. To get full details of a specific chainsetup, select it with cqcs-selectcq or cqcs-iselectcq, and then issue cqcs-selectcq. [s]
- cs-option cq-prefix:arg1,...,argNcq
- One powerful feature of the interactive-mode is that it provides full access to ecasoundcqs command-line syntax. For instance, command dqcs-option -efb:400,200dq means that a bandpass filter is added to the currently selected chain, with initial parameters 400 (center frequency) and 200 (width in Hz).
Note that session level options (such as setting debug level) can not be used with cqcs-optioncq (i.e. only options that modify chainsetups).
Note! Ecasound interactive mode implicitly interprets all strings
beginning with a cq-cq as dqcs-option stringdq.
CHAINS
Chain is a simple signal flow abstraction. Every chain has one input and one output. All chain operators and their controllers are attached to chains. Chains can be muted, unmuted and be bypassed. If not otherwise stated, all operations are done to currently selected chainsetup.- c-add cqcname1,...,cnameNcq
- Adds a set of chains. Added chains are automatically selected. Note that commas in chain names are not allowed. [-]
- c-remove
- Removes selected chains. [-]
- c-list
- Returns a list of all chains. [S]
- c-select cqcname1,...,cnameNcq
- Selects chains. Other chains are automatically deselected. [-]
- c-index-select cqindex1,...,indexNcq, c-iselect cqindex1,...,indexNcq
- Selects a set of chains based on the list of indixes. Each index is an integer value, where cq1cq refers to the first chain. You can use cqc-listcq and cqc-statuscq to get a full list of currently available chains. [-]
- c-select-all
- Selects all chains. [-]
- c-select-add cqcname1,...,cnameNcq
- Selects more chains. [-]
- c-deselect cqcname1,...,cnameNcq
- Deselects chains. [-]
- c-selected
- Returns a list of selected chains. [S]
- c-clear
- Clear selected chains by removing all chain operators and controllers. Doesncqt change how chains are connected to inputs and outputs. [-]
- c-rename cqnew_namecq
- Renames the selected chain. When using this command, exactly one chain must be selected. [-]
- c-mute <on|off|toggle>
- Set the mute state of the currently selected chain. When chain is muted, it will only output silence.
The command takes a single parameter: dqondq -> chain is muted, dqoffdq -> not muted, and dqtoggledq -> change the muting state. If parameter is omitted, dqtoggledq is assumed (muting is either enabled or disabled, depending on previous state).
Control of chain and chain operator muting states is independent. If dqc-mute offdq is executed, the states of individual cop-bypass commands will take effect. If chain is muted, the chain will output silence irrespective of the individual chain operator muting state. [-]
- c-bypass <on|off|toggle>
- Set the bypass state of the currently selected chain. When chain is bypassed, sample data is passed through unprocessed (all chain operators are disabled for the given chain).
The command takes a single parameter: dqondq -> chain is bypassed, dqoffdq -> no bypass, and dqtoggledq -> change the bypass state. If parameter is omitted, dqtoggledq is assumed (bypass is either enabled or disabled, depending on previous state).
Control of chain and chain operator bypass states is independent. If chain bypass is disabled, the states of individual cop-bypass commands will take effect. If chain is bypassed, all operators are bypassed independetly of their cop-bypass state. [-]
- c-status, cs
- Print status info about all chains. [s]
- c-is-bypassed
- Returns true if selected chain is currently bypassed (none of the chain operators are run). See cqc-bypasscq. [i]
- c-is-mute
- Returns true if selected chain is currently muted (outputs silence as its output). See cqc-mutecq. [i]
AUDIO INPUT/OUTPUT OBJECTS
If not otherwise stated, all operations are done to currently selected object. All commands with ai- prefix operate on audio inputs, while commands with ao- operate on outputs.- ai-add cqinput_format_stringcq
- Adds a new input object. See ecasound (1) man page for more info about the argument format (cq-icq option). Note on syntax: if any of the parameters (such as a filename) contains commas, the parameter should be enclosed in double-quotes. [-]
- ao-add cqoutput_format_stringcq
- Adds a new output object. See ecasound (1) man page for more info about the argument format (cq-ocq option). If argument is omitted, a default output device is added (see ecasoundrc (5)). Note on syntax: if any of the parameters (such as a filename) contains commas, the parameter should be enclosed in double-quotes. [-]
- ao-add-default
- Adds the default output device (see ecasoundrc (5)). [-]
- ai-describe, ao-describe
- Returns a Ecasound Option Syntax (EOS) compliant string describing the input/output. See the Ecasound Usercqs Guide for more information about EOS. This command was introduced in ecasound 2.4.4. [s]
- ai-select cqaobject_namecq, ao-select cqaobject_namecq
- Selects an audio object. cqaobject_namecq refers to the string used when creating the object (the first argument given to ai-add/ao-add). Note that as a important difference to ai-add/ao-add, one should not enclose the object name in double quotes for ai-select/ao-select. In the case a chainsetup contains multiple inputs, or outputs, with identical name, cqai-selectcq and cqao-selectcq will select the first matching instance. In order to select a specific instance, the cqai-iselectcq and cqao-iselectcq commands need to be used. [-]
- ai-index-select cqaobject_indexcq, ai-iselect cqaobject_indexcq, ao-index-select cqaobject_indexcq, ao-iselect cqaobject_indexcq
- Select some audio object based on a short index string. Especially file names can be rather long. This command can be used to avoid typing these long names when selecting audio objects. cqaobject_indexcq is an integer value, where cq1cq refers to the first audio input/output. You can use cqai-listcq and cqao-listcq to get a full list of currently available inputs/outputs. [-]
- ai-selected, ao-selected
- Returns the name of the currently selected audio object. [s]
- ai-attach, ao-attach
- Attaches the currently selected audio object to all selected chains. [-]
- ai-remove, ao-remove
- Removes the currently selected audio object from the chainsetup. [-]
- ai-forward cqtime_in_secondscq, ai-fw cqtime_in_secondscq, ao-forward cqtime_in_secondscq, ao-fw cqtime_in_secondscq
- Selected audio object is forwarded by cqtime-in-secondscq seconds. Time should be given as a floating point value (eg. 0.001 is the same as 1ms). [-]
- ai-rewind cqtime_in_secondscq, ai-rw cqtime_in_secondscq, ao-rewind cqtime_in_secondscq, ao-rw cqtime_in_secondscq
- Selected audio object is rewinded by cqtime-in-secondscq seconds. Time should be given as a floating point value (eg. 0.001 is the same as 1ms). [-]
- ai-setpos cqtime_in_secondscq, ai-set-position cqtime_in_secondscq, ao-setpos cqtime_in_secondscq, ao-set-position cqtime_in_secondscq
- Set audio object position to cqtime_in_secondscq. [-]
- ai-set-position-samples cqtime_in_samplescq, ao-set-position-samples cqtime_in_samplescq
- Set audio object position to cqtime_in_samplescq. [-]
- ai-getpos, ai-get-position, ao-getpos, ao-get-position
- Returns the audio object position in seconds. [f]
- ai-get-position-samples, ao-get-position-samples
- Returns the audio object position in samples. [li]
- ai-get-length, ao-get-length
- Returns the audio object length in seconds. [f]
- ai-get-length-samples, ao-get-length-samples
- Returns the audio object length in samples. [li]
- ai-get-format, ao-get-format
- Returns the audio format of the selected audio input/output as a formatted string. See documentation for cq-fcq command-line option. [s]
- ai-list, ao-list
- Returns a list of all input/output objects. [S]
- aio-register
- Prints a list of registered audio object types. [s]
- aio-status
- Audio object status (index strings, position, length, etc). [s]
CHAIN OPERATORS
Chain operators are used to process and analyze sample data. They are attached to chains. If not otherwise stated, currently selected chainsetup and chain are used. Also, cqchainop_idcq and cqparam_idcq are used to select chain operators and their parameters. First valid value for these parameters is 1.- cop-add cqcop_format_stringcq
- Adds a new chain operator. In addition to normal chain operators, this commmand can also be used to add effect presets and various plugins. Note; it is not possible to add operators to multiple chains at once. In other words only one chain should be selected when issuing cqcop-addcq. See ecasound (1) man page for more info. [-]
- cop-bypass <on|off|toggle>
- Set the bypass state of the currently selected chain operator. The command takes a single parameter: dqondq -> operator is bypassed, dqoffdq -> no bypass, and dqtoggledq -> change the bypass state. If parameter is omitted, dqtoggledq is assumed (bypass is either enabled or disabled, depending on previous state). [-]
- cop-is-bypassed
- Returns true if selected chain operator is currently bypassed (temporarily not part of the processing chain). [i]
- cop-describe
- Returns a Ecasound Option Syntax (EOS) compliant string describing the chain operator. See the Ecasound Usercqs Guide for more information about EOS. This command was introduced in ecasound 2.4.4. [s]
- cop-remove
- Removes the selected chain operator. [-]
- cop-list
- Returns a list of all chain operators attached to the currently selected chain. [S]
- cop-select cqparam_idcq, cop-index-select cqparam_idcq, cop-iselect cqparam_idcq
- Selects a chain operator. [-]
- cop-selected
- Returns the index number of currently selected chain operator. [i]
- cop-set cqchainop_id,param_id,valuecq
- Changes the value of a single chain operator parameter. Unlike other chain operator commands, this can also be used during processing. See also cqcop-getcq. [-]
- cop-get cqchainop_id,param_idcq
- Returns the current value of chain operator parameter identified by cqchainop_idcq and cqparam_idcq. This command is a shorthand for cqcop-select chainop_id ; copp-iselect param_id ; copp-getcq. [f]
- cop-status
- Returns info about chain operator status. [s]
- copp-list
- Returns a list of selected chain operatorcqs parameters. [S]
- copp-select cqparam_idcq, copp-index-select cqparam_idcq, copp-iselect cqparam_idcq
- Selects a chain operator parameter. [-]
- copp-selected
- Returns the index number of currently selected chain operator parameter. [i]
- copp-set cqvaluecq
- Sets the selected parameter value to cqvaluecq. [-]
- copp-get
- Returns the selected parameter value. See also cqcop-getcq. [f]
- cop-register
- Prints a list of registered chain operators. [s]
- preset-register
- Prints a list of registered effect presets. [s]
- ladspa-register
- Prints a list of registered LADSPA plugins. [s]
CONTROLLERS
Controllers are used to control individual chain operator parameters. They are attached to chains. If not otherwise stated, currently selected chainsetup and chains are used.- ctrl-add cqcopc_format_stringcq
- Adds a new controller and attach it to currently selected chain operator. The argument syntax is either dq-<id_string>:par1,...,parNdq or just dq<id_string>:par1,...,parNdq. If parameter itself contains commas, the parameter should be enclosed in double-quotes. See ecasound (1) man page for more info. [-]
- ctrl-describe
- Returns a Ecasound Option Syntax (EOS) compliant string describing the controller. See the Ecasound Usercqs Guide for more information about EOS. This command was introduced in ecasound 2.4.4. [s]
- ctrl-remove
- Removes the selected controller. [-]
- ctrl-list
- Returns a list of all controllers attached to the currently selected chain. [S]
- ctrl-select cqparam_idcq, ctrl-index-select cqparam_idcq, ctrl-iselect cqparam_idcq
- Selects a controller. [-]
- ctrl-selected
- Returns the index number of currently selected controller. [i]
- ctrl-status
- Returns info about controller status. [s]
- ctrl-register
- Prints a list of registered controllers. [s]
- ctrl-get-target
- Returns the index number of the chain operator that is connected to the selected controller. The returned index refers to the currently selected chain (see cqcop-listcq). [i]
- ctrlp-list
- Returns a list of all controller parameters. This command was introduced in ecasound 2.4.2. [S]
- ctrlp-select
- Selects a controller parameter. This command was introduced in ecasound 2.4.2. [-]
- ctrlp-selected
- Returns the index number of currently selected controller parameter. This command was introduced in ecasound 2.4.2. [i]
- ctrlp-get
- Returns the selected controller parameter value. This command was introduced in ecasound 2.4.2. [f]
- ctrlp-set
- Sets the selected controller parameter value to cqvaluecq. This command was introduced in ecasound 2.4.2. [-]
JACK CONNECTION MANAGEMENT
If Ecasound is compiled with support for JACK audio server, the following set of commands is provided for controlling connections between JACK ports.- jack-connect cqsrc-portcq cqdest-portcq
- Make a connection between the two ports given as parameters. This command is similar to the cqjack_connectcq command line tool that is distributed with JACK package. [-]
- jack-disconnect cqsrc-portcq cqdest-portcq
- Disconnect the two ports given as parameters. This command is similar to the cqjack_disconnectcq command line tool that is distributed with JACK package. [-]
- jack-list-connections
- Returns a list of all JACK ports and a list of connections for each port. This command is similar to the cqjack_lspcq command line tool (e.g. cqjack_lsp -ccq) that is distributed with JACK package. [s]
INTERNAL COMMANDS
Internal commands are not directly aimed at normal use. They are primarily meant for use in scripting and frontends.- int-cmd-list
- Returns a list of all registered interactive mode commands. [S]
- int-log-history
- Returns recent log messages sent by libecasound modules. This is a good tool for debugging ECI/EIAM scripts and applications. This command was introduced in ecasound 2.4.0. [s]
- int-output-mode-wellformed
- Select the well-format output format for log messages. [-]
- int-set-float-to-string-precision
- Sets precision used in float to text conversions. Note that this can be used to control the precision of float return values for ECI commands. [-]
- int-set-log-history-length
- Sets the log history length. Defaults to 0 items. This command was introduced in ecasound 2.4.0. [-]
- int-cmd-version-string
- Returns ecasound interactive mode parser version string. [s]
- int-cmd-version-lib-current
- Returns ecasound interactive mode library interface version (libtool). [i]
- int-cmd-version-lib-revision
- Returns ecasound interactive mode library interface revision (libtool). [i]
- int-cmd-version-lib-age
- Returns ecasound interactive mode library interface age (libtool). [i]
OBJECT MAPS
Object maps are central repositories for commonly used object types. By querying the maps, applications can get a list of all registered object types and their properties.- map-cop-list
- Prints a list of registered chain operators using the format specified in section OPERATOR DESCRIPTIONS. [s]
- map-preset-list
- Prints a list of registered effect presets using the format specified in section OPERATOR DESCRIPTIONS. [s]
- map-ladspa-list
- Prints a list of registered LADSPA plugins using the format specified in section OPERATOR DESCRIPTIONS. [s]
- map-ladspa-id-list
- Prints a list of registered LADSPA plugins using the format specified in section OPERATOR DESCRIPTIONS. Numerical LADPSA plugin identifiers are used. [s]
- map-ctrl-list
- Prints a list of registered controllers using the format specified in section OPERATOR DESCRIPTIONS. [s]
DUMP COMMANDS
The following dump commands are not meant for normal use. Their primary purpose is to provide an easy way to get internal state information from libecasound. All dump commands output a single line with syntax dqkey valuedq to the selected output stream (defaults to stdout).- dump-target cqfilenamecq
- Set target stream for dumping. [-]
- dump-status
- Dumps engine status - cqrunningcq, cqstoppedcq, cqfinishedcq or cqnotreadycq. [-]
- dump-position
- Dumps the global position. Printed in seconds using a floating-point representation. [-]
- dump-length
- Dumps the overall processing length. Printed in seconds using a floating-point representation. [-]
- dump-cs-status
- Dumps status string for the currently selected chainsetup - cqconnectedcq, cqselectedcq or an empty string. [-]
- dump-c-selected
- Dumps the name of currently selected chain. [-]
- dump-ai-selected
- Dumps label of currently selected audio input. If no input is selected, dumps an empty string. [-]
- dump-ai-position
- Dumps position of currently selected audio inputs. Printed in seconds, using a floating-point representation. [-]
- dump-ai-length
- Dumps length of currently selected audio input. Printed in seconds, using a floating-point representation. [-]
- dump-ai-open-state
- Dumps audio input state info. Either cqopencq or cqclosedcq. [-]
- dump-ao-selected
- Dumps label of currently selected audio output. If no output is selected, dumps an empty string. [-]
- dump-ao-position
- Dumps position of currently selected audio outputs. Printed in seconds, using a floating-point representation. [-]
- dump-ao-length
- Dumps length of currently selected audio output. Printed in seconds, using a floating-point representation. [-]
- dump-ao-open-state
- Dumps audio output state info. Either cqopencq or cqclosedcq. [-]
- dump-cop-value cqchainop,paramcq
- Dumps chain operator parameter value. cqchainopcq and cqparamcq are operator and parameter index values (1...n). [-]
OPERATOR DESCRIPTIONS
The map-xxx-list commands return a string containing all registered objects of the given type xxx. Each line of the output describes one registered type. The used syntax is:- cqkeyword,name,description,num_of_params,par1_def,par2_def,...cq
- parX_def describes one object parameter. This definition is present for all parameters of the described object type. The used syntax is:
- cqname,description,defaultvalue,upper_bound_flag,upper_bound, lower_bound_flag,lower_bound,toggled_flag,integer_flag, logarithmic_flag,output_flagcq
- For exact descriptions of these fields, please see the header file ecasound/libecasound/eca-operator.h.
DEPRECATED COMMANDS
Use of following commands is deprecated. They still work in current version of Ecasound, but will be dropped in the future:-
- ai-wave-edit, ao-wave-edit
SEE ALSO
ecasound (1), ecatools (1), ecasoundrc (5)AUTHOR
Kai Vehmanen, <kvehmanen -at- eca -dot- cx <kvehmanen -at- eca -dot- cx>>