xwaves.help

speech signal process tools

            (see also nb_spect_params).  The default search
            path used is ".:$ESPS_BASE/lib/waves/files";
            this can be overriden by setting the unix
            environment variable WAVES_INPUT_PATH before
            starting xwaves+.

       write_common
            If write_common is 1, each time the mouse is
            used to change the position of segment markers,
            the file name ("filename"), starting record
            ("start"), and number of records ("nan") are
            written to ESPS Common; if write_common is 0,
            Common is not written.  For more information
            about ESPS Common processing, see various ESPS
            manual pages (e.g., getparam (1-ESPS) and
            read_params (3-ESPS)).

       x_increment
            horizontal displacement between successive win-
            dows

       y_increment
            vertical displacement between successive windows

       xlabel_ctlwin_x
            The X position of the xlabel (attachment) con-
            trol window.

       xlabel_ctlwin_y
            The Y position of the xlabel (attachment) con-
            trol window.

       xspectrum_ctlwin_x
            The X position of the xspectrum (attachment)
            control window.

       xspectrum_ctlwin_y
            The Y position of the xspectrum (attachment)
            control window.

       xspectrum_datwin_forward

            Whether (1) or not (0) the xspectrum data (plot)
            window is brought forward every time a new plot
            is displayed.  The default is 1.

       xspectrum_datwin_height
            The height of xspectrum data (plot) windows.

       xspectrum_datwin_width
            The height of xspectrum data (plot) windows.

       xspectrum_datwin_x

       xspectrum_datwin_y
            These two globals control the initial position
            of the xspectrum data (plot window) if there is
            only one display object.  Positive values for
            xspectrum_datwin_x or xspectrum_datwin_y specify
            respectively the X and Y position of the xspec-
            trum plot window if there is only one display
            object at the time the plot window is displayed.
            If there is more than one display object, the
            xspectrum plot window is aligned with the first
            display window of the corresponding xwaves+
            display object, with the xspectrum display
            directly underneath the left side of the xwaves+
            window.  If xspectrum_data_win_x is negative,
            the top of all xspectrum plot windows is posi-
            tioned directly underneath the first xwaves+
            display window of the corresponding object.  If
            xspectrum_data_win_y is negative, the left side
            of all xspectrum plot windows is lined up (vert-
            ically) with the left side of the first waves+
            display window of the corresponding object.
            This is only effective on startup of xspectrum.

       xspectrum_max_lpc_order
            The maximum order for LPC (maximum entropy)
            spectral estimates in xspectrum.  This item is
            only effective on startup of xspectrum.

       zoom_ratio
            fractional change caused by "zoom" operations

       zoom_ganged
            1 to zoom all signals in object, 0 for just one
            (see also scroll_ganged)

       P8574_type
            1 (default) means correct P8574 version part is
            on the Ariel analog board.    If you get a mes-
            sage like:

            iicack: bus error, sta=0x8, flag=0x0, goodbye!

            when trying to do analog output, then you might
            have an Ariel board with the wrong version
            P8574P on it.  Some have been shipped with the A
            version, which has different addresses.  If you
            get this message, then set this global to 0.

       ARIEL_16
            Specifies which crystal is on the Ariel VME-16 ProPort
            Ariel analog module for the AT&T Surfboard.  Set to 0 (the 
            default), to specify the standard 24 Mhz crystel; set to 1 
            to specify the 16 Mhz crystal. 

XWAVES+ COMMANDS
===============

Xwaves+ commands may be executed by entering them manually in the 
control panel, or by running a command file containing a sequence of 
commands.  The available commands are listed below.  The command name 
is shown on the left followed by a short description enclosed in ">>" 
and "<<" brackets.  Most commands have one or more optional 
attribute-value pairs that follow the command name.  The available
attributes are listed, one-per-line, right after the command.  For
explanations, see the man page.  The following should be used as 
reminders about the commands, not as a means for learning them.  

  set          >> SET GLOBAL PARAMETERS FOR THE PROGRAM <<
         <global name>

  add_espsf    >> ADD EXTERNAL ESPS-TO-FILE CALL TO XWAVES+ MENU <<
         name 
         out_ext
         display
	 outputs
	 menu
         command

  add_espst    >> ADD EXTERNAL ESPS-TO-TEXT CALL TO XWAVES+ MENU <<
         name 
	 menu
         command

  add_espsn    >> ADD EXTERNAL ESPS (NO OUTPUT) CALL TO XWAVES+ MENU <<
         name 
	 menu
         command

  delete_item    >> REMOVE ITEM FROM xwaves+ MENUS <<
	 name
	 menu

  delete_all_items   >> REMOVE EVERYTHING FROM xwaves+ MENUS <<
	 menu

  add_waves  >>  ADD WAVES+ COMMAND TO WAVES+ MENU <<
	 name
	 menu
	 command
	 builtin
	 submenu

  make_panel     >> CREATE AUXILIARY CONTROL PANEL <<
	 loc_x
	 loc_y
	 title
	 icon_title
	 columns
	 quit_button
	 name
	 file


  close_panel     >> CLOSE AUXILIARY CONTROL PANEL <<
	 name

  open_panel     >> OPEN AUXILIARY CONTROL PANEL <<
	 name

  kill_panel     >> KILL AUXILIARY CONTROL PANEL <<
	 name

  close_ctlwin    >> CLOSE (ICONIZE) MAIN CONTROL PANEL <<


  open_ctlwin     >> OPEN MAIN CONTROL PANEL <<


  cd           >> CHANGE WORKING DIRECTORY <<
         path 

  detach       >> DETACH ANY FUNCTION CURRENTLY ATTACHED TO xwaves+ <<

  attach       >> ATTACH A FUNCTION (LIKE label (1-ESPS)) <<
         function

  send         >> SEND A MESSAGE TO THE FUNCTION ATTACHED TO xwaves+ <<
         <any string>

  auto_plot_limits     >> SET AUTOMATIC PLOT LIMITS <<

  pause        >> PAUSE READING FROM COMMAND FILE FOR INTERACTION <<

  kill         >> DESTROY ONE OR MORE DATA VIEWS <<
         <none>
         name 
         file 

  make         >> CREATE A DATA VIEW AND/OR DISPLAY ENSEMBLE <<
         name 
         file 
         identifiers
         numbers
         <any 'set' keyword>
              as described above for the "set" command.  A few
              of the more commonly used variables have been
              given aliases for convenience:
                 duration
                 start
                 width
                 height
                 loc_x
                 loc_y

  enable_server   >> START LISTENING FOR COMMMANDS ON SOCKET  <<

  disable_server   >> STOP LISTENING FOR COMMMANDS ON SOCKET  <<

  quit         >> CAUSES xwaves+ TO QUIT AND RETURN TO UNIX <<

  sleep        >> SLEEP WHILE BACKGROUND PROCESS OCCURS (e.g. D/A) <<
         seconds

  shell        >> SEND COMMANDS TO A UNIX SHELL <<
     <unix command line>

  branch       >> TRANSFER CONTROL TO ANOTHER WAVES COMMAND FILE <<
         commandname

  call         >> CALL A WAVES COMMAND FILE AS A SUBROUTINE <<
         commandname

  return       >> RETURN TO THE CALLING WAVES COMMAND FILE <<

  ----------------------------------------------------------

  The following commands and keyword/arguments may be sent to
  display ensembles (named as in the "make" command above):

  ----------------------------------------------------------

  align        >> ALIGN ALL VIEWS IN A DISPLAY ENSEMBLE <<
         file   

  activate     >> ENABLE/DISABLE PLOTTING OF SELECTED VECTOR ELEMENTS <<
         file         
         op           
         numbers      
         identifiers
 
  close        >> CLOSE A DATA VIEW AND TURN INTO AN ICON<<
         file 

  open         >> OPEN A DATA VIEW THAT IS CLOSED (ICONIZED) <<
         file 

  bracket      >> CHANGE VIEW STARTING TIME AND TIME SCALE <<
         file 
         start
         end  

  overlay      >> OVERLAY PARAMETER TRACKS ON SPECTROGRAMS <<
         file 
         on_file
      
  page         >> PAGE SIGNAL IN WINDOW<<
         file 
         step 
         ref_step

  play_wind    >> PLAY WINDOW <<
         file 

  save         >> SAVE SEGMENT IN OUTPUT FILE<<
         file 
         start
	 end
	 get

  get          >> GET INFO. FROM xwaves+ <<
         attributes
         file 
	 output
	 aname

  cursor       >> MOVE THE TIME/FREQUENCY CURSOR <<
         time 
         frequency

  marker       >> MOVE THE RIGHT OR LEFT TIME MARKER <<
         time 
         do_left

  colormap     >> CHANGE THE COLORMAP USED FOR SPECTROGRAMS <<
         file 
         threshold
         range

  spectrogram  >> MAKE A SPECTROGRAM OF DISPLAYED PCM DATA <<
         file 
         loc_x
         loc_y
         type 
         start
         end  

  play         >> D/A CONVERT DATA IN A PCM VIEW <<
         file 
         start
         end  

  set      >> SAME AS 'SET' DIRECTED TO xwaves+ <<

  mark         >> APPLY TIME MARKS TO ALL VIEWS IN THE ENSEMBLE <<
         time 
         color

  unmark        >> REMOVE TIME MARKS FROM THE ENSEMBLE <<
         all   
         time 
         color

-----
@(#)xwaves.help	1.1 1/13/93 ERL/AT&T
Copyright (c) 1988, 1989, 1989, 1990, 1991 ESI/AT&T