xig.me

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

.lo
.de SM          \"macro to shrink left margin
.br
.nr $i \\n($i+\\$1i
..
.de RM          \"macro to restore original left margin
.br
.nr $i 0
..
.de MS		\"macro for main section (sans serif bold)
.ft SB
.nf
\\$1
.sp -.8
.fi
..
.de SS		\"macro for sub-section (sans serif italics)
.ft SI
.nf
\\$1
.sp -.8
.fi
..
.sc
.he 'XIG NOTE''page %'
.fo '1.2'ERL1/22/93'
.nf
.ce 
\s+4\fB ENTROPIC RESEARCH LABORATORY, INC.\fR\s-4
.sp 1i
.ce 100
\s+1\fB

ESPS APPLICATIONS NOTE: X Interface Generation in ESPS and \fIxwaves\fP+
\fP\s-1
.sp .3i
\fIJohn Shore \fP
.sp .3i
Entropic Research Laboratory, Inc.
600 Pennsylvania Ave. S.E., Suite 202
Washington, D.C. 20003
[phone]
.sp .5i
.fi
.lp
.sh 1 INTRODUCTION
.lp
.lp
ESPS Version 4.1 and \fIxwaves\fP+ 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
configuration files, it is easy to produce highly-customized
\fIxwaves\fP+/ESPS packages that meet personal or application-specific
needs.  This technical note summarizes the these XIG features and
explains how to use them.
.sh 1 "OVERVIEW OF ESPS AND \fIxwaves\fP+ FACILITIES"
.lp
In this section, we list the relevant ESPS (or \fIxwaves\fP+) 
programs, library functions, environment variables, \fIxwaves\fP+ 
globals, \fIxwaves\fP+ commands, etc. 
.sh 2 "User-Level Programs"
.lp
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
\fIeman\fP (1\-\s-1ESPS\s+1) to view the on-line man pages.
.nf
.ta 1.25i

\fIeinfo\fP \-	X-based tool for reading ESPS release notes, tech notes. etc. 
\fIedemos\fP \-	put up a button control panel for ESPS demos

\fIxtext\fP \-	create window for text file or output of any text-producing command

\fIfbuttons\fP \-	create window with buttons that run programs on specific files
\fImbuttons\fP \-	create window with buttons for running arbitrary programs

\fIexprompt\fP \-	interactive ESPS parameter entry in a pop-up window
\fIexpromptrun\fP \-	runs program after interactive parameter prompts
\fIxeparam\fP \-	run an ESPS program with interactive parameter prompt window
\fIgetparam\fP \-	prints value of ESPS parameter from parameter file or ESPS Common

\fIxrefcof\fP \-	run \fIrefcof\fP (1\-\s-1ESPS\s+1) with X Windows interactions and displays
\fIxfft\fP \-	run \fIfft\fP (1\-\s-1ESPS\s+1) with X Windows interactions and displays
\fIxacf\fP \-	interactive tool for making \fIacf\fP (1\-\s-1ESPS\s+1) parameter files 

\fIplot3d\fP \-	interactive 3-D plot (perspective plots with hidden lines removed)

\fIxwaves\fP \-	general interactive analysis and display program for ESPS data
\fIxspectrum\fP \-	\fIxwaves\fP+ attachment for spectrum estimation
\fIxlabel\fP \-	\fIxwaves\fP+ attachment for time-series labelling
\fIsend_xwaves\fP \-	open a connection to an xwaves+ server socket and send commands

\fIaplot\fP \-	non-interactive plot of ASCII data
\fIplotsd\fP \-	non-interactive plot of sampled data
\fIxmcd\fP \-	non-interactive plot of any data in Unix GPS format
\fIgenplot\fP \-	non-interactive plot of ESPS data in multiline format
\fImlplot\fP \-	non-interactive plot of sampled-data in multiline format
\fIplotspec\fP \-	non-interactive plot of ESPS spectral data (FEA_SPEC record(s))
\fIscatplot\fP \-	non-interactive scatter plot of ESPS FEA data
\fIplotsgram\fP \-	non-interactive plot of FEA_SPEC data as spectrogram
\fIimage\fP \-	non-interactive plot of ESPS FEA data as an image

\fIwsystem\fP \-	return the type of window system being run
.fi
.sh 2 "ESPS Library Functions"
.lp
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
\fIeman\fP (1\-\s-1ESPS\s+1) to view the on-line man pages.
.nf
.ta 2i

\fIexv_get_help\fP \-	create XView frame containing text of man page or help file
\fIexv_make_text_window\fP \-	create XView frame containing text of ASCII file
\fIexv_helpfile\fP \-	return file name containing cleaned man page or plain text
\fIexv_attach_icon\fP \-	attach one of the standard ESPS icons to a frame.  

\fIexv_prompt_params\fP \-	create interactive window for ESPS parameter file 

\fIexv_bbox\fP \-	create panel with arbitrary screen buttons
\fIread_olwm_menu\fP \-	reads a menu in Open Look Window Manager format; 
\fIprint_olwm_menu\fP \-	prints an \fIolwm\fP-format menu; 

\fIopen_xwaves\fP \-	open a socket connection to an \fIxwaves\fP+ server
\fIsend_xwaves\fP \-	send a command to an \fIxwaves\fP+ server
\fIclose_xwaves\fP \-	close a socket connection to an \fIxwaves\fP+ server
\fIsend_xwaves2\fP \-	send command to an \fIxwaves\fP+ server without separate 
	     open and close
.fi
.sh 2 "\fIxwaves\fP+ Globals"
.lp
The initial state of \fIxwaves\fP+ is determined by the globals in the
".wave_pro" file that is read on startup.  Included in the effects of
the globals are:
.ip "\ \ \ \(bu"
initial \fIxwaves\fP+ control window position (and iconization state)
.ip "\ \ \ \(bu"
default position and size of first \fIxwaves\fP+ data display window
and default relative positions of subsequent windows
.ip "\ \ \ \(bu"
heights for scrollbar and digital readout panels
.ip "\ \ \ \(bu"
whether or not to display the spectrogram reticle
.ip "\ \ \ \(bu"
whether or not to display field labels and digital readouts
.ip "\ \ \ \(bu"
ganging control for scrolling and zooming
.ip "\ \ \ \(bu"
controls for spectrogram (image) interpolation and rescaling
.ip "\ \ \ \(bu"
initial semantics for left and middle mouse buttons
.ip "\ \ \ \(bu"
initial colormap
.ip "\ \ \ \(bu"
parameters for digital halftone algorithms (monochrome displays)
.ip "\ \ \ \(bu"
crude controls for plotting scales
.ip "\ \ \ \(bu"
initial position of \fIxspectrum\fP and \fIxlabel\fP control windows
.ip "\ \ \ \(bu"
initial position and size of xspectrum data (plot) window
.lp
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 \fIeinfo\fP (1\-\s-1ESPS\s+1).
.lp
Two globals deserve special mention.  One is \fIinit_file\fP \- 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 \fIinit_file\fP occurs.  The \fIinit_file\fP usually is the best
place in which to put initial \fIxwaves\fP+ commands for
reconfiguring the menu, bringing up button panels, etc.
.lp
The other global is \fIoutput_dir\fP.  If \fIoutput_dir\fP is defined,
all output files from \fIxwaves\fP+, \fIxspectrum\fP, and \fIxlabel\fP
will go into this directory (including edited files, saved file
segments, spectrogram output files, outputs from add_espsf, etc.).  If
\fIoutput_dir\fP 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.
.sh 2 "\fIxwaves\fP+ Commands"
.lp
Since \fIxwaves\fP+ is primarily a display program, a large number of
the \fIxwaves\fP+ 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 spectrogram menus, and that create arbitrary screen
buttons that can be used to invoke \fIxwaves\fP+ commands or command
files.  For details about these and other commands, see the 
\fIxwaves\fP+ manual.  
.nf
.ta 1.5i

\fIadd_espsf\fP \-	add external ESPS (file output) call to menu
\fIadd_espst\fP \-	add external ESPS (text output) call to menu
\fIadd_espsn\fP \-	add external ESPS (no output) call to menu
\fIadd_waves\fP \-	add \fIxwaves\fP+ command (or command file) to menu

\fIdelete_item\fP \-	delete specific item from \fIxwaves\fP+ menu
\fIdelete_all_items\fP\-	delete all items from \fIxwaves\fP+ menu

\fImake_panel\fP \-	create auxiliary control panel with screen buttons
\fIclose_panel\fP \-	close (iconize) auxiliary control panel
\fIopen_panel\fP \-	open auxiliary control panel
\fIkill_panel\fP \-	kill auxiliary control panel

\fIclose_ctlwin\fP \-	close (iconize) main \fIxwaves\fP+ control
\fIopen_ctlwin\fP \-	open main \fIxwaves\fP+ control panel

\fImake\fP \-	create a new data display window
\fIclose\fP \-	close (iconize) a data window
\fIopen\fP \-	open a data window
\fIkill\fP \-	destroy one or more data display windows

\fIattach\fP \-	start an attachment (\fIxlabel\fP, \fIxspectrum\fP)
\fIdetach\fP \-	terminate an attachment
\fIsend\fP \-	send a message to an attachment 

\fIenable_server\fP \-	start operation as display server 
\fIdisable_server\fP \-	stop operation as display server 
.fi
.sh 2 "Environment Variables"
.lp
ESPS and \fIxwaves\fP+ programs are sensitive to a variety of
\fIunix\fP environment variables that support position 
independence and XIG customization.  For a list and discussion of 
the full set, see \fIespsenv\fP (1\-\s-1ESPS\s+1).  Here are some
particularly relevant ones: 
.ip ESPS_BASE
This should be set to the root of the ESPS (and \fIwaves\fP+) install
tree.  If not defined, programs all use /usr/esps as a default. 
.ip 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.  The 
plot programs have been modified to support ESPS_TEMP_PATH.  
.ip ESPS_MENU_PATH
This is the path used by \fImbuttons\fP (1\-\s-1ESPS\s+1) and
\fIfbuttons\fP (1\-\s-1ESPS\s+1) to find \fIolwm\fP-format menu
files.   If ESPS_MENU_PATH is not defined, the default path used is
".:$ESPS_BASE/lib/menus".
.ip ESPS_PARAMS_PATH
This is the path used to find ESPS parameter files specified by the
standard ESPS \fB-P\fP option.  If ESPS_PARAMS_PATH is not defined,
the default path used is ".:$ESPS_BASE/lib/params".
.ip WAVES_INPUT_PATH
This is the path used by \fIwaves+\fP and \fIxwaves+\fP to find all