Provided by: ecasound_2.9.3-2_amd64 bug

NAME

       ecasound-iam - ecasound interactive mode

SYNOPSIS

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 ecasound’s 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, it’s 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

       It’s 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, ’quit’ terminates the ecasound process. When sent over ecasound server
              connection (aka NetECI), ’quit’ 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 ’start’ but blocks until processing is finished. Error string is return if  any  errors  upon
              startup, or during process, are encountered. [e]

       debug ’debug-level’
              Set  debug level to ’debug-level’. Notice that client programs can reimplement the debug routines.
              [-]

       resource-file ’path-to-file’
              Overrides the global and user resource files.  Does  not  affect  already  created  objects.  This
              command is equivalent to ’-R’ ecasound option (see ecasound (1) man page).

       -prefix:arg1,...,argN
              Equivalent to issuing ’cs-option -prefix:arg1,...,argN). See documentation for ’cs-option’.

       help’, ’h’
              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
              ’cs-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.
              ecasound’s 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 ’name’
              Adds a new chainsetup with name ’name’. ’name’ is now the selected chainsetup. [-]

       cs-remove
              Removes currently selected chainsetup. [-]

       cs-list
              Returns a list of all chainsetups. [S]

       cs-select ’name’
              Selects chainsetup ’name’. [-]

       cs-selected
              Returns the name of currently selected chainsetup. [s]

       cs-index-select ’cs_index’, cs-iselect ’cs_index’
              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. ’cs_index’ is an integer value, where ’1’
              refers to the first audio input/output. You can use ’cs-list’ and ’cs-status’ to get a  full  list
              of currently available chainsetups. [-]

       cs-load ’filename’
              Adds  a  new  chainsetup  by  loading  it  from  file  ’filename’.  ’filename’ 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  doesn’t  have  a  default  filename, it’s saved to
              "chainsetup_name.ecs". [-]

       cs-save-as ’filename’
              Saves currently selected chainsetup to file ’filename’. [-]

       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 ’time-in-seconds’, rewind ’time-in-seconds’, rw ’time-in-seconds’
              Rewinds  the current chainsetup position by ’time-in-seconds’ seconds.  Position of all inputs and
              outputs attached to the selected chainsetup is also affected. [-]

       cs-forward ’time-in-seconds’, forward ’time-in-seconds’, fw ’ttime-in-seconds’
              The current chainsetup position is forwarded by ’time-in-seconds’ seconds. Position of all  inputs
              and outputs attached to the selected chainsetup is also affected. [-]

       cs-set-position  ’time-in-seconds’,  cs-setpos  ’time-in-seconds’, setpos ’time-in-seconds’, set-position
       ’time-in-seconds’
              Sets the chainsetup position to ’time-in-seconds’ seconds from  the  beginning.  Position  of  all
              inputs and outputs attached to the selected chainsetup is also affected. [-]

       cs-set-position-samples ’time-in-samples’
              Sets  the  chainsetup  position  to  ’time-in-samples’ 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 ’seconds’
              Sets processing time in seconds (doesn’t have to be an integer value).  A  special-case  value  of
              ’-1’ will set the chainsetup length according to the longest input object. [-]

       cs-set-length-samples ’samples’
              Sets processing time in samples. [-]

       cs-toggle-loop
              Toggle  looping.  When  processing is finished, engine will start again from the initial position.
              It’s not always possible to enable looping (for instance all  inputs  and  outputs  have  infinite
              length and chainsetup length is not explicitly set with ’cs-set-length’). [-]

       cs-set-param
              Interpret  general chainsetup parameters like for example "-b" (buffersize), "-n" (name), etc. See
              ecasound (1) for more info. [-]

       cs-set-audio-format ’bits,channels,sample_rate’
              Set the default sample parameters for currently selected chainsetup.  For example cd-quality audio
              would be "16,2,44100". This does the same as command-line argument "-f" (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 ’cs-select’ or ’cs-iselect’, and then issue ’cs-select’. [s]

       cs-option ’-prefix:arg1,...,argN’
              One powerful feature of the interactive-mode  is  that  it  provides  full  access  to  ecasound’s
              command-line  syntax.  For instance, command "cs-option -efb:400,200" 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 ’cs-option’ (i.e. only
       options that modify chainsetups).

       Note! Ecasound interactive mode implicitly interprets all strings beginning  with  a  ’-’  as  "cs-option
       string".

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 ’cname1,...,cnameN’
              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 ’cname1,...,cnameN’
              Selects chains. Other chains are automatically deselected. [-]

       c-index-select ’index1,...,indexN’, c-iselect ’index1,...,indexN’
              Selects a set of chains based on the list of indixes. Each index is an integer  value,  where  ’1’
              refers  to  the  first  chain. You can use ’c-list’ and ’c-status’ to get a full list of currently
              available chains. [-]

       c-select-all
              Selects all chains. [-]

       c-select-add ’cname1,...,cnameN’
              Selects more chains. [-]

       c-deselect ’cname1,...,cnameN’
              Deselects chains. [-]

       c-selected
              Returns a list of selected chains. [S]

       c-clear
              Clear selected chains by removing all chain operators and controllers.  Doesn’t change how  chains
              are connected to inputs and outputs. [-]

       c-rename ’new_name’
              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: "on" -> chain is muted, "off" -> not muted, and "toggle" ->  change
       the  muting  state.   If parameter is omitted, "toggle" is assumed (muting is either enabled or disabled,
       depending on previous state).

       Control of chain and chain operator muting states is independent.   If  "c-mute  off"  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: "on" -> chain is bypassed, "off" -> no bypass, and "toggle" ->
       change the bypass state.  If parameter is omitted, "toggle" 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
              ’c-bypass’. [i]

       c-is-mute
              Returns true if selected chain is currently muted (outputs silence as its output).  See  ’c-mute’.
              [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 ’input_format_string’
              Adds a new input object. See ecasound (1) man page for more info about the argument  format  (’-i’
              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 ’output_format_string’
              Adds a new output object. See ecasound (1) man page for more info about the argument format  (’-o’
              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 User’s Guide for more information about EOS. This  command  was  introduced  in  ecasound
              2.4.4. [s]

       ai-select ’aobject_name’, ao-select ’aobject_name’
              Selects  an  audio  object. ’aobject_name’ 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, ’ai-select’ and  ’ao-select’
              will  select the first matching instance. In order to select a specific instance, the ’ai-iselect’
              and ’ao-iselect’ commands need to be used. [-]

       ai-index-select ’aobject_index’, ai-iselect ’aobject_index’, ao-index-select ’aobject_index’,  ao-iselect
       ’aobject_index’
              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.
              ’aobject_index’  is  an  integer value, where ’1’ refers to the first audio input/output.  You can
              use ’ai-list’ and ’ao-list’ 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   ’time_in_seconds’,   ai-fw   ’time_in_seconds’,    ao-forward    ’time_in_seconds’,    ao-fw
       ’time_in_seconds’
              Selected  audio  object  is  forwarded  by  ’time-in-seconds’  seconds.  Time should be given as a
              floating point value (eg. 0.001 is the same as 1ms). [-]

       ai-rewind   ’time_in_seconds’,    ai-rw    ’time_in_seconds’,    ao-rewind    ’time_in_seconds’,    ao-rw
       ’time_in_seconds’
              Selected  audio  object  is  rewinded  by  ’time-in-seconds’  seconds.   Time should be given as a
              floating point value (eg. 0.001 is the same as 1ms). [-]

       ai-setpos   ’time_in_seconds’,   ai-set-position    ’time_in_seconds’,    ao-setpos    ’time_in_seconds’,
       ao-set-position ’time_in_seconds’
              Set audio object position to ’time_in_seconds’. [-]

       ai-set-position-samples ’time_in_samples’, ao-set-position-samples ’time_in_samples’
              Set audio object position to ’time_in_samples’. [-]

       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 ’-f’ 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, ’chainop_id’ and ’param_id’ are
       used to select chain operators and their parameters. First valid value for these parameters is 1.

       cop-add ’cop_format_string’
              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  ’cop-add’.   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: "on" -> operator is bypassed, "off" -> no bypass, and "toggle"  ->  change  the  bypass
              state.   If  parameter  is  omitted,  "toggle"  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 User’s 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 ’param_id’, cop-index-select ’param_id’, cop-iselect ’param_id’
              Selects a chain operator. [-]

       cop-selected
              Returns the index number of currently selected chain operator. [i]

       cop-set ’chainop_id,param_id,value’
              Changes the value of a single chain operator parameter. Unlike other chain operator commands, this
              can also be used during processing.  See also ’cop-get’. [-]

       cop-get ’chainop_id,param_id’
              Returns the current value of chain operator parameter identified by ’chainop_id’  and  ’param_id’.
              This command is a shorthand for ’cop-select chainop_id ; copp-iselect param_id ; copp-get’. [f]

       cop-status
              Returns info about chain operator status. [s]

       copp-list
              Returns a list of selected chain operator’s parameters. [S]

       copp-select ’param_id’, copp-index-select ’param_id’, copp-iselect ’param_id’
              Selects a chain operator parameter. [-]

       copp-selected
              Returns the index number of currently selected chain operator parameter. [i]

       copp-set ’value’
              Sets the selected parameter value to ’value’. [-]

       copp-get
              Returns the selected parameter value. See also ’cop-get’. [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 ’copc_format_string’
              Adds a new controller and attach it to currently selected chain operator. The argument  syntax  is
              either  "-<id_string>:par1,...,parN"  or  just  "<id_string>:par1,...,parN".  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 User’s 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 ’param_id’, ctrl-index-select ’param_id’, ctrl-iselect ’param_id’
              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 ’cop-list’). [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 ’value’. 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 ’src-port’ ’dest-port’
              Make a connection between the two ports given as  parameters.  This  command  is  similar  to  the
              ’jack_connect’ command line tool that is distributed with JACK package. [-]

       jack-disconnect ’src-port’ ’dest-port’
              Disconnect  the  two  ports  given as parameters. This command is similar to the ’jack_disconnect’
              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  ’jack_lsp’  command line tool (e.g. ’jack_lsp -c’) 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 "key value" to the selected output stream (defaults to stdout).

       dump-target ’filename’
              Set target stream for dumping. [-]

       dump-status
              Dumps engine status - ’running’, ’stopped’, ’finished’ or ’notready’. [-]

       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 - ’connected’, ’selected’  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 ’open’ or ’closed’. [-]

       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 ’open’ or ’closed’. [-]

       dump-cop-value ’chainop,param’
              Dumps chain operator parameter value. ’chainop’ and  ’param’  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:

              ’keyword,name,description,num_of_params,par1_def,par2_def,...’

              parX_def describes one object parameter. This definition is present  for  all  parameters  of  the
              described object type.  The used syntax is:

              ’name,description,defaultvalue,upper_bound_flag,upper_bound,
              lower_bound_flag,lower_bound,toggled_flag,integer_flag, logarithmic_flag,output_flag’

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

                                                   03.06.2012                                    ecasound-iam(1)