ecasound-iam man page on DragonFly

Man page or keyword search:  
man Server   44335 pages
apropos Keyword Search (all sections)
Output format
DragonFly logo
[printable version]

ecasound-iam(1)		      Multimedia software	       ecasound-iam(1)

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 interac‐
       tive mode commands from outside of libecasound. When issuing inter com‐
       mands  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 nec‐
       essary), 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  gap‐
       less/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,  *-regis‐
	      ter *-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’ eca‐
	      sound 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, out‐
       puts, chains, etc) are connected to some chainsetup. There can be  many
       chainsetups  but	 only  one can be connected. Similarly only one chain‐
       setup 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 typ‐
	      ing  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 chain‐
	      setups. [-]

       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 orig‐
	      inal.  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  con‐
	      nected)? [i]

       cs-connect
	      Connect  currently  selected chainsetup to engine. When connect‐
	      ing, all resources (e.g. files, soundcard devices, external pro‐
	      grams)  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-sec‐
       onds’
	      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-sec‐
	      onds’ 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	 infi‐
	      nite  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	chain‐
	      setup.  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  sup‐
	      pressed. 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 other‐
       wise 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  con‐
	      trollers.	 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 dou‐
	      ble-quotes. [-]

       ao-add-default
	      Adds the default output device (see ecasoundrc (5)). [-]

       ai-describe, ao-describe
	      Returns a Ecasound Option Syntax (EOS) compliant string describ‐
	      ing  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 con‐
	      tains  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-ise‐
	      lect’ 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.	 Espe‐
	      cially  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-set‐
       pos ’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	chain‐
       setup 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 opera‐
	      tors, 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 describ‐
	      ing 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 pro‐
	      cessing.	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  com‐
	      mas,  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 describ‐
	      ing  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 param‐
	      eter. 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 follow‐
       ing  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 dis‐
	      tributed 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 pri‐
       marily 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 speci‐
	      fied in section OPERATOR DESCRIPTIONS. [s]

DUMP COMMANDS
       The following dump commands are not meant for normal use.   Their  pri‐
       mary  purpose  is to provide an easy way to get internal state informa‐
       tion from libecasound. All dump commands output a single line with syn‐
       tax "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	float‐
	      ing-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 sec‐
	      onds, 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 sec‐
	      onds, 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,	 loga‐
	      rithmic_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)
[top]

List of man pages available for DragonFly

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net