fbuttons.1

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

.\" Copyright (c) 1991 Entropic Research Laboratory, Inc.; All rights reserved
.\" @(#)fbuttons.1	1.16 01 Apr 1997 ERL
.ds ]W (c) 1991 Entropic Research Laboratory, Inc.
.TH  FBUTTONS 1\-ESPS 01 Apr 1997
.SH NAME
.nf
fbuttons \- create panel with buttons that run programs on specific files
.fi
.SH SYNOPSIS
.B
fbuttons
[
.BI \-F " file_menu"
] [ 
.BI \-s " max_scroll_lines"
] [ 
.BI \-R " regexp"
] [ 
.BI \-L " proglist_file"
] [ 
.BI \-S " progmenu_file"
] [
.BI \-M " mbuttons_menu"
] [
.B  \-a
] [
.BI \-b " but_per_row"
] [ 
.BI \-q " quit_button"
] [ 
.BI \-Q " quit_label"
] [ 
.BI \-l " quit_command"
] [ 
.B \-c
] [
.B \-h
] [
.BI \-w " window_title"
] [ 
.BI \-i " icon_title"
] [ 
.BI \-X " x_pos"
] [ 
.BI \-Y " y_pos"
] [
.BI \-x " debug_level"
] [
\fIfilename1\fP
] [
\fIfilename2\fP ...
]
.SH DESCRIPTION
.PP
\fIfbuttons\fP ("file buttons") pops up an X window with screen
buttons (or a scrollble list) for invoking one of a given set of
programs on one of a given set of files.  By default, the window
displayed by \fIfbuttons\fP has two panels, one panel to provide
selections for the program to be run, and one panel with buttons that
invoke the selected program on a given file.  By default,
\fIfbuttons\fP is configured to either play or view the header of all
files in the current directory with suffixes ".sd" or ".d".  If the
\fB-M\fP option is used, a third panel is created with screen buttons
that can have arbitrary functions in the style of \fImbuttons\fP
(1\-\s-1ESPS\s+1).
.PP
Programs are invoked on a given file by pressing (left mouse) the
corresponding button in the bottom panel of the window.  Buttons there
may have menus associated with them, in which case programs are
invoked on a given file by making an appropriate menu selection.
Often the button labels duplicate the file names, but (if \fB-F\fP is
used) it is possible to create file buttons with arbitrary labels.
The program that is invoked by pressing such a file button (or making
a button-menu selection) is controlled by an exclusive set of
toggle-buttons in the top panel of the window (or in the middle panel
if the \fB-M\fP option is used).  Pushing the "program button"
labelled with the desired program selects the named program as the one
that will be invoked on a file when a the file is selected by pressing
a file button in the bottom panel or making a button-menu selection
there.  (Note that the act of pushing a program button has no effect
other than selecting that program for subsequent invocation via the
file buttons.)  Programs invoked by \fIfbuttons\fP inherit its
environment.  A QUIT button is also provided in the panel containing
the program buttons; it can be disabled using the \-\fBq\fP option.  
.PP
File names associated with the file buttons, scrollable file list, or file
button-menus can be provided to \fIfbuttons\fP using any combination
of three methods: (1) a list on the command line (\fIfilename1\fP
\fIfilename2\fP ...), in which case the button labels are given by the
file names; (2) a regular expression for a set of file names
(\fB-R\fP), in which case the button labels are also given by the file
names; and (3) a menu file containing button labels and associated
file names (\fB-F\fP).  If none of these three methods is used, by
default \fIfbuttons\fP uses the regular expression "\\.s*d$" to select
all files in the current directory with suffixes ".sd" or ".d",
If the \fB-a\fP is used, file names will be sorted alphabetically 
(but note that sorting does not apply to a menu file associated
with \fB-F\fP).  
.PP
If \fB-s\fP is used, a scrollable list is provided instead of buttons 
in the bottom panel.  The number of files shown is limited to 
\fImax_scroll_lines\fP (but of course the list can be scrolled).  
If \fB-s\fP is used, the list labels are limited to file names (i.e., 
\fB-F\fP cannot be used).  A scrollable list cannot be used if a 
\fIfile_menu\fP is specified (\fB-F\fP). 
.PP
The \fIfile_menu\fP specified with \fB-F\fP uses uses the same format
as menu files for the OPEN LOOK window manager \fIolwm\fP (same as
\fIsunview\fP menu files).  If submenus are specified, they result in
menu buttons with pull-down menus.
.PP
The simplest case for \fIfile_menu\fP is a file with two columns \-
the button labels are taken from the first column and the
corresponding files are taken from the second column.  If blanks are
needed in the button labels, use quotes to surround the string in the
first column (e.g., "Max Headroom").  More complicated cases can be
created using the full syntax of \fIolwm\fP(1) menu files.  The only
restriction is that there can only be one level of submenus \- i.e.,
each entry in the \fIfile_menu\fP can itself specify a menu (either
directly or by giving the full path to another menu file), but the
specified submenu cannot have additional submenus.  Also, while the
\fIolwm\fP command keyword DEFAULT is handled, others (PROPERTIES,
REFRESH, FLIPDRAG, etc.)  are treated as ordinary strings.  For
details about the format of menu files, see \fIolwm\fP(1) \- the
manual page is included in the ESPS distribution.  Also, see
\fImbuttons\fP (1\-\s-1ESPS\s+1) and the EXAMPLES.
.PP
Program names for the program buttons can be provided to
\fIfbuttons\fP in one of two ways: (1) by means of a file containing a
list of programs (\fB-L\fP) \- in this case, the program "name" is
actually the full command line to be used (i.e., each "name" is used
both as a button label and as the command line to be executed); (2) by
means of a file containing a list of names and associated command
lines (\fB-S\fP) \- in this case, the name is used as the button label
and is independent of the command line to be executed.  If neither
\fB-L\fP or \fB-S\fP is specified, \fIfbuttons\fP uses a default
\fIprogfile_menu\fP to create two program buttons: one labeled "play
file" and one labeled "show header".  The former causes "play \-r1: "
to be invoked on any file whose file button is pressed; the latter
causes "xtext psps -aD" to be invoked (this results in a pop-up window
with a full-history header but no data).  If the default menu cannot
be found, \fIfbuttons\fP uses "play -r1:" and "xtext psps -aD" both as
program button labels and command strings.
.PP
The \fB-M\fP option can be used to specify a menu file of the type
used by \fImbuttons\fP (1\-\s-1ESPS\s+1) to create arbitrary screen
buttons.  The syntax of the menu file and the semantics of the
resulting button panel are exactly the same as for \fImbuttons\fP,
execept that the panel appears as the top panel within the
\fIfbuttons\fP window rather than in its own window (as is the case
for \fImbuttons\fP).  Pressing a simple button invokes an associated
command.  Pressing a menu button (specified as a sub-menu within the
\fImbuttons_file\fP) produces a pop-down menu; selecting an item from
the menu invokes an associated command.  If the \-\fBc\fP is specified
a set of exclusive choice buttons is presented instead of a menu
button.  For details, see the \fImbuttons\fP man page.
.PP
In a typical application, each file name (as specfied on the command
line or via \fB-F\fP and \fB-R\fP) is the name of an existing file.
In some cases, however, it makes sense for the names to have other
meanings that are known to the invoked programs.  For example, in the
TIMIT demo (included in the ESPS demo directory), the button labels
are file prefixes, and the invoked programs derive relevant file names
by appending appropriate suffixes.
.PP
If \fB-S\fP, \fB-M\fP, or\fB- F\fP is used, \fIfbuttons\fP looks looks
for the named \fIprogmenu_file\fP, \fImbuttons_menu\fP or
\fIfile_menu\fP file first in the current directory and then in
$ESPS_BASE/lib/menus.  This default search path can be overriden by
setting the \fIunix\fP environment variable ESPS_MENU_PATH. 
\fIfind_esps_file\fP(3\-\s-1ESPS\s+1) is used in implementing this
behavior, so environment variables (preceeded by the character $) can be
embedded within the \fIprogmenu_file\fP and \fImbuttons_menu\fP
strings.
.SH OPTIONS
.PP
The following options are supported:
.TP
.BI \-F " file_menu"
Specifies that file buttons be created from the file \fIfile_menu\fP.
In the simplest case, the button labels are taken from the first
column and the associated files are taken from the second column.
Butons with associated pop-down menus can also be created (see the
discussion above under DESCRIPTION).  Note that the \fB-F\fP option
can be used in combination with \fB-R\fP and with file names listed
explicitly on the command line.
.TP 
\fB\-R\fI regexp\fR ['\\\\\\\\.s*d$'] Specifies that file buttons be
created for any file in the current directory that matches the regular
expression \fIregexp\fP.  By default, any file name with suffix ".sd"
or ".d" is selected, provided that the \fB-F\fP option isn't use and
that file names are not given explicitely on the command line.  The
\fB-R\fP option can be used in combination with \fB-F\fP and with file
names listed explicitly on the command line.
.TP 
.BI \-L " proglist_file"
Specifies that program buttons be created for the strings listed in
the file \fIproglist_file\fP, one string per line (empty lines are
ignored).  A set of exclusive toggle-buttons is created.  The button
labels are the strings in \fIproglist_file\fP.  The same string is
used as a program command line if a given program button is down when
any file button is pressed, the file name is appended to the program
button label (i.e., to the string that was in \fIproglist_file\fP) and
the resulting command is executed.  The command inherits the
environment of \fIfbuttons\fP.  This option and \fB-S\fP are mutually
exclusive.  If neither are used, then a default menu file is used to
create two program buttons: one labeled "play file" and one labeled