waves5.0.me

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

operation to be performed when a button defined as blow_up;function
is released.  This can be any operation added with \fIadd_op\fR, or any
built-in menu operation.  By default, \fIxspectrum\fR, \fIxlabel\fR and \fIxmarks\fR all
add themselves as the \fIblowup_op\fR as part of their initialization to
emulate the behavior of older \fIxwaves\fR versions.
.sh 3 "Commands to Attachments"
.lp
Since multiple attachments are now possible, the \fIxwaves\fR \fIsend\fR command
has been augmented to permit messages to be directed to a particular
attachment.  If only one attachment is active, the older form of the
send command behaves as before, so that existing \fIxwaves\fR scripts will
continue to work correctly.
.sh 3 "Remote Xlabel Access"
.lp
There is now a \fIlabel\fR qualifier to the \fImark\fR command in \fIxlabel\fR.
This permits full specification of the label to be applied via a
\fIsend\fR command.  Now, any external process can apply labels of any
content to the \fIxlabel\fR data view (e.g. via the send_xwaves program or
library calls).
.sh 3 "New Source Example"
.lp
A new example attachment has been provided in source form. \fIxample.c\fR
is an RPC-based attachment for \fIxwaves\fR that does not use xview.  This
can serve as a skeleton for developing your own, custom attachments.
This file can be found in \fI$ESPS_BASE/lib\fR.
.sh 3 "Custom Spectrum Estimation"
.lp
The new features in \fIxwaves\fR and \fIxspectrum\fR permit implementation of
specialized spectrum estimation techniques and display of the results
in the \fIxspectrum\fR display window.  An example script demonstrating this
feature is provided in the \fIxspectrum\fP manual.

.sh 2 "Ease of Use Features"
.sh 3 "Graphics Export Control"
.lp
There is a new \fIxwaves\fR command: \fIprint_setup\fR.  This command
invokes a setup window that allows the user to select output to a file
or printer; name an output file; specify a command for the local or
networked printer; choose PostScript or PCL; set the resolution of
output device; specify a scale factor; and choose PostScript Level 1
or 2.  This command is most easily invoked by the button \fIprint
setup\fR on in the \fIxwaves\fR startup environment panel.  All of
these parameters may also be set remotely by \fIsend_xwaves\fR or an
\fIxwaves\fP script.
.sh 3 "Customizing Xwaves"
.lp
We provide a graphical interface to the new \fIadd_op\fP command-definition
facility through the \fIadd_op_panel\fR command.  The \fIxwaves\fR default
startup environment that we now provide gives you quick access to the
\fIadd_op_panel\fR with a single button press.  \fIAdd_op_panel\fR not 
only helps
you build custom operators, it also provides quick reference access to
\fIxwaves\fR variables, commands and keywords.
.sh 3 "Help with Symbols"
.lp
We have implemented informational access to argument lists for \fIxwaves\fR
commands.  If any command is issued with a question mark (?) as the
first non-white character in the argument list, \fIxwaves\fR returns the
names of all acceptable keywords for the given command.  Thus the
shell command
.sp
	send_xwaves set ?
.sp
will return the names of all \fIxwaves\fR globals.
.sh 3 "Output File Management"
.lp
All displayable files created with \fIadd_op\fR operators, spectrogram
commands, etc. now appear in the new files browser list accessible
by right mousing the OUTPUT file control-panel item.  This list may
also be accessed via the new \fIxwaves\fR symbol \fInew_files\fP.  Thus, to
remove all files created during a given run of \fIxwaves\fR, you could issue
the shell command:
.sp
	rm -f `send_xwaves get aname new_files`
.sp
Of course, this would remove ALL new files, including those saved with
save segment in file!  A safer strategy might be to just save
the list for perusal later:
.sp
	send_xwaves get aname new_files > misc_files_list
.sp
.sh 3 "Initializing Attachments"
.lp
The attachments can now be fully customized through entries in your
startup profile file (\fI.wave_pro\fR) or interactively by sending set
commands to the attachments.  See the attachment manuals for listings
of the relevant symbol names.
.sh 3 "Saving Attachment Customizations"
.lp
All attachment-specific globals may now be saved with the new
\fIsave_globals\fR command that has been added to the attachments.  This
saves the values in a form suitable for inclusion in your \fIxwaves\fR
startup profile (\fI.wave_pro\fR), so the current configurations may be
easily saved for future use.  This is especially handy for \fIxspectrum\fR,
since it has so many free parameters.
.sh 3 "Speedups for Xlabel"
.lp
There are now keyboard qualifiers for the MOVE and REPLACE modes of
\fIxlabel\fR.  If SHIFT is depressed, xlabel switches into the MOVE mode
(for middle button operations) as long SHIFT is held.  If SHIFT is
depressed, the REPLACE mode is in effect for label menu selections
(but not for direct keyboard entry).  The previous mode is reentered
after the SHIFT key is released.
.sh 3 "Et Cetera"
.lp
More state information is shown in the data-view frame, including
mouse button bindings and full path names.
.lp
For brevity, and simplicity, the keyword \fIop\fR has been made synonymous
with \fIcommand\fR in all \fIxwaves\fR commands that use these keywords.
.lp
We have resolved all differences in \fIxwaves\fR' processing of multi-word
text arguments (e.g. for \fIop\fR or \fIcommand\fR arguments).  These may now
be either quoted strings or not.  If a multi-word argument is the last
item on a line, it need not be quoted, but can be quoted if it is to
appear in another position.  Formerly, items such as the \fImiddle_op\fR
or \fRleft_op\fR button specification were required to be the last item
on a line.
.lp
We added the \fIappend_extensions\fR boolean global to \fIxwaves\fR.  
With a zero value, this
can switch off the appending of extensions in the save segment in
file function (and the \fIsave\fR command).  This allows you to know
exactly what output filename will be used so that references can be
made later, for example, in a shell script.

.sh 2 "General Enhancements"
.sh 3 "Saving Xwaves Configurations"
.lp
All operator definitions and menu items created using the \fIadd_op\fR
command may now be saved for later use with the new
\fIsave_add_ops\fR and \fIsave_menus\fR commands.  Thus, it is
possible to incrementally tailor \fIxwaves\fR to your exact needs.
Operators added with add_esps{f,t,n} are automatically converted to
equivalent \fIadd_op\fR commands when saved with the
\fIsave_add_ops\fR command.  The operator and menu definitions are
saved in the form of \fIxwaves\fP commands that may be executed
to reconstruct them.
.sh 3 "Reticles"
.lp
Reticles with time scale and ordinal numbering have been added to all
waveform views.  These reticles may be enabled or disabled on a
per-vector-element (per-channel) basis in vector-signal
(multi-channel) views.
.sh 3 "Improved Custom Control Panels"
.lp
In \fIxwaves\fR 2.1 we introduced the \fImake_panel\fR command that provides a
simple means for developing your own custom control interfaces.  In
version 5.0 we have added new input modes and better state feedback to
the panels produced by \fImake_panel\fR.  We have also added the
\fIsave_panels\fR command to save the current \fIxwaves\fR button panel
configuration.  Thus, you can develop new panels interactively, and
when satisfied, save the exact configuration for later use.
.sh 3 "New Line Types"
.lp
Two new line types have been added to waveform plots; Type 3 is the
DSP style, where a single vertical line is drawn from the data value
to the zero baseline for each data point.  Type 4 is the same, except
hat the data points are also connected with straight-line segments.
The line type used is established by the \fIline_type\fR global or
view-specific attribute.
.sh 3 "Access to Attachments"
.lp
The attachments may now be started by a button press on the main
\fIxwaves\fR Control Panel.  The attachment options that appear are
determined by the new symbol \fIattachments\fR that may be defined 
in your \fI.wave_pro\fR profile file.  For example, the entry
.sp
	attachments xspectrum xlabel xchart
.sp
would provide three options for selection.  Note that these are no
longer mutually-exclusive. Several attachments can be active at once.
If \fIattachments\fP is set to the distinguished value \fInone\fP, no
attachment options will appear in the panel.
.sh 3 "Spectra of Long Sequences"
.lp
\fIXspectrum\fR can now perform spectrum estimation on sequences of any
length.  There is a soft limit on the size of the FFT set by the
variable \fIxspectrum_max_fft_size\fR of 2 million points.  This can be
changed by an entry in your startup profile file (\fI.wave_pro\fR).
.sh 3 "Output from Xspectrum"
.lp
Spectra created by \fIxspectrum\fR may now be saved in an ASCII file.  The
\fIxspectrum\fR control parameters, the source signal file name, and the
spectrum, as frequency-log-magnitude tuples, are saved to a named
.sh 3 "Et Cetera"
.lp
The \fIxwaves options\fR keyword is now considered obsolete.  The functional bits
of this global have been expanded into the more easily understood
global booleans: \fIdont_save_sgrams\fR, \fIredraw_on_release\fR,
\fIrewrite_after_edit\fR and \fIoverlay_as_number\fR.  These attributes are
now settable on a per-view basis.  \fIOptions\fP is still recognized, but
its use is discouraged.  It will be removed in later \fIxwaves\fR versions.
.lp
The \fIxwaves save\fR and \fIspectrogram\fP commands now permit specification
of the output file name.  This makes it much easier for external
processes to keep track of the names of files created by these
operations.
.lp
Cross-view frequency cursor tracking has been added to \fIxspectrum\fR.
Moving the cursor in the spectrum window will cause the spectrogram
cursors in \fIxwaves\fR to track.
ASCII file with the new \fIsave_spectrum\fR command.

.sh 2 "Major Bug Fixes"
.lp
The display repaint procedures have been made more efficient.  Most of
the annoying tendencies for xview to unnecessarily refresh the screen
have been eliminated.
.lp
Due to a complete change in the \fIxwaves\fR to attachments
communications, screen lockup is no longer possible.

.sh 1 "KNOWN PROBLEMS"
.lp
When \fIxwaves\fR starts, it attempts to register itself as an RPC
server using a default program and version number.   If another
application happens to be using these same numbers, then the
registration will fail and \fIxwaves\fR will not be able to act as an
RPC server.  In this event, communications with its attachments will
fail.   This is very unlikely, except in the case where another
\fIxwaves\fR is already running on a given CPU when \fIxwaves\fR is
started.   If this does happen, a message is printed on \fIxwaves\fR
startup.    If this happens, the user should exit \fIxwaves\fR and start
it again using the \fB-V\fR option to specify some alternate version
number.   In practice almost any value will work.   If no message is
issued complaining that \fIxwaves\fR could not register as an RPC
server, then the new value is OK.  This problem will be fixed shortly by
having \fIxwaves\fR try alternate RPC addresses if the default fails.