xig.doc

来自「speech signal process tools」· DOC 代码 · 共 661 行 · 第 1/2 页

                         ENTROPIC RESEARCH LABORATORY, INC.








         ESPS APPLICATIONS NOTE: X Interface Generation in ESPS and xwaves+



                                    John Shore


                         Entropic Research Laboratory, Inc.
                       600 Pennsylvania Ave. S.E., Suite 202
                               Washington, D.C. 20003
                                   [phone]




       1 .  INTRODUCTION

       ESPS Version 4.1 and xwaves+ Version  2.1  contain  a  variety  of  X-
       Windows  Interface  Generation  (XIG)  features  for  customizing  and
       extending the user-interface.  By using a variety of simple ASCII con-
       figuration files, it is easy to produce highly-customized xwaves+/ESPS
       packages that  meet  personal  or  application-specific  needs.   This
       technical  note  summarizes the these XIG features and explains how to
       use them.

       2 .  OVERVIEW OF ESPS AND xwaves+ FACILITIES

       In this section, we list the  relevant  ESPS  (or  xwaves+)  programs,
       library  functions,  environment  variables,  xwaves+ globals, xwaves+
       commands, etc.

       2 .1 .  User-Level Programs

       Here is a list of the user-level programs relevant to XIG.   For  more
       information  about  each of them, see the ESPS reference manual or use
       eman (1-ESPS) to view the on-line man pages.

       einfo -     X-based tool for reading ESPS release notes, tech notes. etc.
       edemos -    put up a button control panel for ESPS demos

       xtext -     create window for text file or output of any text-producing command

       fbuttons -  create window with buttons that run programs on specific files










       XIG NOTE                                                        page 2


       mbuttons -  create window with buttons for running arbitrary programs

       exprompt -  interactive ESPS parameter entry in a pop-up window
       expromptrun -runs program after interactive parameter prompts
       xeparam -   run an ESPS program with interactive parameter prompt window
       getparam -  prints value of ESPS parameter from parameter file or ESPS Common

       xrefcof -   run refcof (1-ESPS) with X Windows interactions and displays
       xfft -      run fft (1-ESPS) with X Windows interactions and displays
       xacf -      interactive tool for making acf (1-ESPS) parameter files

       plot3d -    interactive 3-D plot (perspective plots with hidden lines removed)

       xwaves -    general interactive analysis and display program for ESPS data
       xspectrum - xwaves+ attachment for spectrum estimation
       xlabel -    xwaves+ attachment for time-series labelling
       send_xwaves -open a connection to an xwaves+ server socket and send commands

       aplot -     non-interactive plot of ASCII data
       plotsd -    non-interactive plot of sampled data
       xmcd -      non-interactive plot of any data in Unix GPS format
       genplot -   non-interactive plot of ESPS data in multiline format
       mlplot -    non-interactive plot of sampled-data in multiline format
       plotspec -  non-interactive plot of ESPS spectral data (FEA_SPEC record(s))
       scatplot -  non-interactive scatter plot of ESPS FEA data
       plotsgram - non-interactive plot of FEA_SPEC data as spectrogram
       image -     non-interactive plot of ESPS FEA data as an image

       wsystem -   return the type of window system being run

       2 .2 .  ESPS Library Functions

       Here is a list of the user-level programs relevant to XIG.   For  more
       information  about  each of them, see the ESPS reference manual or use
       eman (1-ESPS) to view the on-line man pages.

       exv_get_help -      create XView frame containing text of man page or help file
       exv_make_text_window -create XView frame containing text of ASCII file
       exv_helpfile -      return file name containing cleaned man page or plain text
       exv_attach_icon -   attach one of the standard ESPS icons to a frame.

       exv_prompt_params - create interactive window for ESPS parameter file

       exv_bbox -          create panel with arbitrary screen buttons
       read_olwm_menu -    reads a menu in Open Look Window Manager format;
       print_olwm_menu -   prints an olwm-format menu;

       open_xwaves -       open a socket connection to an xwaves+ server
       send_xwaves -       send a command to an xwaves+ server
       close_xwaves -      close a socket connection to an xwaves+ server
       send_xwaves2 -      send command to an xwaves+ server without separate
                                open and close



       1.2                           ERL1/22/93







       XIG NOTE                                                        page 3


       2 .3 .  xwaves+ Globals

       The initial state of xwaves+ is  determined  by  the  globals  in  the
       ".wave_pro"  file that is read on startup.  Included in the effects of
       the globals are:

          + initial xwaves+ control window position (and iconization state)

          + default position and size of first xwaves+  data  display  window
            and default relative positions of subsequent windows

          + heights for scrollbar and digital readout panels

          + whether or not to display the spectrogram reticle

          + whether or not to display field labels and digital readouts

          + ganging control for scrolling and zooming

          + controls for spectrogram (image) interpolation and rescaling

          + initial semantics for left and middle mouse buttons

          + initial colormap

          + parameters for digital halftone algorithms (monochrome displays)

          + crude controls for plotting scales

          + initial position of xspectrum and xlabel control windows

          + initial position and size of xspectrum data (plot) window

       For details on these and other globals, see the the  heavily-commented
       default  ".wave_pro" ($ESPS_BASE/lib/waves/.wave_pro).  Note that this
       file can be viewed by means of einfo (1-ESPS).

       Two globals deserve special mention.  One is init_file - this  is  the
       name  of  a  command  file to be executed on startup.  Execution takes
       place after all the other variable initializations in the profile  are
       done,  regardless  of  where  in that file the definition of init_file
       occurs.  The init_file usually is the best place in which to put  ini-
       tial  xwaves+  commands for reconfiguring the menu, bringing up button
       panels, etc.

       The other global is output_dir.  If output_dir is defined, all  output
       files  from xwaves+, xspectrum, and xlabel will go into this directory
       (including edited  files,  saved  file  segments,  spectrogram  output
       files,  outputs  from add_espsf, etc.).  If output_dir is not defined,
       outputs go in the same directory as  the  corresponding  input.   This
       global  is  important  for  multi-user  applications in which a set of
       standard, read-only, input files are used by everyone.



       1.2                           ERL1/22/93







       XIG NOTE                                                        page 4


       2 .4 .  xwaves+ Commands

       Since xwaves+ is primarily a display program, a large  number  of  the
       xwaves+ commands are relevant to the customization of user-interfaces.
       Here, we mention some particularly  relevant  commands  -  those  that
       bring  up new display windows, that reconfigure the waveform and spec-
       trogram menus, and that create arbitrary screen buttons  that  can  be
       used  to  invoke xwaves+ commands or command files.  For details about
       these and other commands, see the xwaves+ manual.

       add_espsf -    add external ESPS (file output) call to menu
       add_espst -    add external ESPS (text output) call to menu
       add_espsn -    add external ESPS (no output) call to menu
       add_waves -    add xwaves+ command (or command file) to menu

       delete_item -  delete specific item from xwaves+ menu
       delete_all_items-delete all items from xwaves+ menu

       make_panel -   create auxiliary control panel with screen buttons
       close_panel -  close (iconize) auxiliary control panel
       open_panel -   open auxiliary control panel
       kill_panel -   kill auxiliary control panel

       close_ctlwin - close (iconize) main xwaves+ control
       open_ctlwin -  open main xwaves+ control panel

       make -         create a new data display window
       close -        close (iconize) a data window
       open -         open a data window
       kill -         destroy one or more data display windows

       attach -       start an attachment (xlabel, xspectrum)
       detach -       terminate an attachment
       send -         send a message to an attachment

       enable_server -start operation as display server
       disable_server -stop operation as display server

       2 .5 .  Environment Variables

       ESPS and xwaves+ programs are sensitive to a variety of unix  environ-
       ment  variables  that support position independence and XIG customiza-
       tion.  For a  list  and  discussion  of  the  full  set,  see  espsenv
       (1-ESPS).  Here are some particularly relevant ones:

       ESPS_BASE
            This should be set to the root of the ESPS (and  waves+)  install
            tree.  If not defined, programs all use /usr/esps as a default.

       ESPS_TEMP_PATH
            This can be set to the directory that you want  programs  to  use
            for temporary files.  Not all programs currently pay attention to
            ESPS_TEMP_PATH, but over time they will be  modified  to  do  so.


       1.2                           ERL1/22/93







       XIG NOTE                                                        page 5


            The plot programs have been modified to support ESPS_TEMP_PATH.

       ESPS_MENU_PATH
            This is the path used by mbuttons (1-ESPS) and fbuttons  (1-ESPS)
            to  find  olwm-format  menu  files.    If  ESPS_MENU_PATH  is not
            defined, the default path used is ".:$ESPS_BASE/lib/menus".

       ESPS_PARAMS_PATH
            This is the path used to find ESPS parameter files  specified  by
            the standard ESPS -P option.  If ESPS_PARAMS_PATH is not defined,
            the default path used is ".:$ESPS_BASE/lib/params".

       WAVES_INPUT_PATH
            This is the path used by waves+ and xwaves+  to  find  all  input
            signal   files,   label   files,   and   label  menu  files.   If
            WAVES_INPUT_PATH  is  not  defined,  the  default  path  used  is
            ".:$ESPS_BASE/lib/waves/files".

       WAVES_LIB_PATH
            This is the path used by  waves+  and  xwaves+  to  find  certain
            library  files.   If  WAVES_LIB_PATH  is not defined, the default
            path used is "$ESPS_BASE/lib/waves".

       WAVES_MENU_PATH
            This is the path used by xwaves+ to find olwm-format  menu  files
            used  with the xwaves+ command make_panel.  If WAVES_MENU_PATH is
            not     defined,     the      default      path      used      is
            ".:$ESPS_BASE/lib/waves/menus".

       WAVES_COMMAND_PATH
            This is the path used by  waves+  and  xwaves+  to  find  command
            files.   If  WAVES_COMMAND_PATH  is not defined, the default path
            used is ".:$ESPS_BASE/lib/waves/commands".

       WAVES_COLORMAP_PATH
            This is the path used by waves+ and xwaves+  to  find  colormaps.
            If  WAVES_COLORMAP_PATH  is not defined, the default path used is
            ".:$ESPS_BASE/lib/waves/colormaps".

       WAVES_PROFILE_PATH
            This is the path used by waves+ and xwaves+ to find  the  startup
            profile.   IF WAVES_PROFILE_PATH is not defined, the default path
            used is "$HOME:$ESPS_BASE/lib/waves".

       WAVES_HOST
            This is the hostname of an  xwaves+  display  server.   That  is,
            send_xwaves  (1-ESPS)  send_xwaves  (3-ESPS) attempt to send mes-
            sages to an xwaves+ process running on WAVES_HOST.  If WAVES_HOST
            is not defined, the local host is assumed.

       WAVES_PORT
            This is the INET domain socket port number  used  by  send_xwaves
            (1-ESPS)  and  send_xwaves  (3-ESPS)  when sending messages to an


       1.2                           ERL1/22/93