CMGUI(1)
NAME
cmgui - front end graphical user interface to CMISS.
SYNOPSIS
cmgui [-cm] [-cm_epath directoryname] [-id number]
[-cm_parameters filename] [-command_list] [-display host-
name:0.0] [-epath directoryname] [-example example_name]
[-h] [-mycm] [-random randomseed] [filename]
DESCRIPTION
cmgui is the front end graphical user interface to
cmiss(1). It provides a 3D visualization environment,
including functionality to enter commands to, and display
the results from, the back end computational kernel cm(1).
If a command_file_name is given, then cmgui will open and
execute the commands in the specified file (with an added
.com suffix if necessary).
OPTIONS
-cm Launch the back end computational kernel from cmgui
to create the combined cmiss program.
-cm_epath directoryname
Override the default back end example path root
directory with the specified directory name.
-id number
Define the identification number for the instance
of cmgui.
-cm_parameters filename
Specify the back end parameters file to use when
invoking cm. Note that a .ippara suffix is added
to the supplied filename.
-command_list
Write a list of all current cmgui commands.
-display hostname:0.0
Specify the X11 host to display on.
-epath directoryname
Override the default example path root directory
with the specified directory name.
-example example_name
Executes commands from an example. The com-
mand_file_name argument is usually not required but
may be supplied to specify a different command file
in the cmiss_input directory of the specified exam-
ple.
This is equivalent to issuing the cmgui commands
`set directory example example_name' and `open com-
file $example/command_file_name execute'.
-execute string
Execute the specified string of commands before any
other commands are processed.
-h Show all command options.
-mycm Launch a personalised back end computational kernel
from cmgui to create the combined cmiss program.
-random randomseed
Specify the random number seed to use in cmgui
ENVIRONMENT VARIABLES
CMISS_PERL, CMISS32_PERL, CMISSN32_PERL, CMISS64_PERL
CMISS_PERL specifies the location of the perl exe-
cutable used to determine the list of directories
in which to search for Perl library files. On IRIX
platforms, CMISSN32_PERL overrides CMISS_PERL for
the cmgui new 32-bit ABI executable, and
CMISS64_PERL overrides CMISS_PERL for the cmgui64
64-bit ABI executable. If these variables are not
defined then `perl' is used.
CMISS_PERLLIB, CMISS32_PERLLIB, CMISSN32_PERLLIB,
CMISS64_PERLLIB
CMISS_PERLLIB specifies a colon separated list of
paths which will be prepended to the list of direc-
tories in which to search for Perl library files.
This is commonly used to include some standard perl
modules related to cmiss and consequently if none
of these variables are set and CMISS_ROOT is set
then the directory '${CMISS_ROOT}/cmiss_perl/lib'
is added automatically. On IRIX platforms,
CMISSN32_PERLLIB overrides CMISS_PERLLIB for the
cmgui new 32-bit ABI executable, and CMISS64_PERL-
LIB overrides CMISS_PERLLIB for the cmgui64 64-bit
ABI executable.
APPLICATION RESOURCE FILE
An X-resource file named Cmgui can be used to customise
various options within cmgui. The system wide resource
file is installed in /usr/lib/X11/app-defaults. The system
wide settings may be overridden by copying this file to a
users HOME directory and customising it.
The following resource options may be used in the Cmgui
file. Note all resource options are prefixed with cmgui.*.
and recommended values are given in square brackets.
CMGUI OPTIONS
*useSchemes:
Put the line '*useSchemes: all' in your Cmgui file
to tell CMGUI to use the colours from the current
desktop colour scheme. Default behaviour is to use
OSF/Motif defaults. Note that this resource option
does not have the cmgui.*. prefix.
HELP OPTIONS
helpUrl:
The URL for the cmiss help.
[file:/usr/local/cmiss/help/index.html]
examplesDirectory:
The full directory path to the root directory con-
taining the cmiss example hierarchy. Note that this
path must contain a trailing /.
[/usr/local/cmiss/examples/]
CMISS OPTIONS
cmExecutable:
The name of the back end computational kernel to
run when cmgui is invoked with the -cm command line
option. Note that unless the executable is within
the users path environment a full path name will be
required. [cm]
mycmExecutable:
The name of the back end computational kernel to
run when cmgui is invoked with the -mycm command
line option. Note that unless the executable is
within the users path environment a full path name
will be required. [cmo]
wormholeTimeoutSeconds:
The number of seconds before the connection between
the front and back ends times out. [300]
FONT OPTIONS
buttonFont:
Font to be used on all dialog push buttons and tog-
gle buttons. Use xlsfonts(1) to find out which
fonts may be used on your X server. Note that * can
be used in place of any unimportant font parame-
ters. [*-Helvetica-medium-R-*--*-120-*]
headingFont:
Font to be used on all dialog headings. [-*-Hel-
vetica-bold-R-*--*-120-*]
listFont:
Font to be used for all list items in cmgui
dialogs. [*-Helvetica-medium-R-*--*-120-*]
menuFont:
Font to be used on all cmgui menu buttons. [*-Hel-
vetica-medium-R-*--*-120-*]
normalFont:
Font to be used on all plain text in dialogs.
[*-Helvetica-medium-R-*--*-120-*]
normalNonProportionalFont:
Must be a non proportional (fixed-width) font. Used
on cmgui dialogs when a fixed-width font is
required for column alignment. [*-Courier-medium-
r-normal--12-*]
smallFont:
Font to be used in cmgui dialogs when it must be
small to save screen space. [*-Helvetica-medium-r-
narrow--*-80-*]
GRAPHICAL FINITE ELEMENT OPTIONS
defaultElementDiscretization:
The default number of line segments used to draw
element curves (>=1). [4]
maximumElementDiscretization:
The maximum number of line segments used to draw
element curves. [50]
defaultCircleDiscretization:
The default number of line segments used to draw
circles (>= 2). Note that 5 is the first number
that looks remotely round. [6]
maximumCircleDiscretization:
The maximum number of line segments used to draw
circles. [64]
WINDOW OPTIONS
backgroundColour:
The background colour for the 3D graphics window.
Specified as an X11 colour. [black]
comfile_window.x:
The X11 x location of the comfile window on the
screen. [0]
comfile_window.y:
The X11 y location of the comfile window on the
screen. [520]
comfile_window.height:
The height (in pixels) of the comfile window. [200]
comfile_window.width:
The width (in pixels) of the comfile window. [300]
command_window.x:
The X11 x location of the command window on the
screen. [0]
command_window.y:
The X11 y location of the command window on the
screen. [2000]
command_window.*.output_text.rows:
The number of rows in the command window output
text area. [30]
command_window.*.output_text.columns:
The number of columns in the command window output
text area. [100]
command_window.*.output_text.fontList:
The font for the command window output text area.
[*-courier-medium-r-normal--12-*]
command_window.*.menu_form.*.fontList:
Font used for menu items on the command window.
[*-helvetica-bold-r-normal--12-*]
digitiser_window.*.digwin_viewing_area.height:
Default height of the digitiser window, including 2
x 1 pixel border. [402]
digitiser_window.*.digwin_viewing_area.width:
Default width of the digitiser window, including 2
x 1 pixel border. [402]
graphics_window.*.gwin_viewing_form.height:
Default height of the 3-D graphics window, includ-
ing 2 x 1 pixel border. [402]
graphics_window.*.gwin_viewing_form.width:
Default width of the 3-D graphics window, including
2 x 1 pixel border. [402]
graphicsWindowOrthoUpAxis:
The default "Up Axis" for the orthographic views in
the graphics window. Available options are -X, -Y,
-Z, X, Y, Z. [Z]
graphicsWindowOrthoFrontAxis:
The default "Front Axis" for the orthographic views
in the graphics window. Available options are -X,
-Y, -Z, X, Y, Z. [-Y]
menu_window.x:
The X11 x position of the menu window on the
screen. [0]
menu_window.y:
The X11 y position of the menu window on the
screen. [520]
menu_window.height:
The height (in pixels) of the menu window. [200]
menu_window.width:
The width (in pixels) of the menu window. [300]
projection_window.*.spectrum_drawing_area.height:
[75]
projection_window.*.projection_drawing_area.height:
[400]
projection_window.*.projection_drawing_area.width:
[600]
prompt_window.x:
The X11 x position of the prompt window on the
screen. [0]
prompt_window.y:
The X11 y position of the prompt window on the
screen. [250]
prompt_history.rows:
The number of rows in the prompt window history
area. [20]
prompt_history.columns:
The number of columns in the prompt window history
area. [100]
prompt_history.fontList:
The font for the prompt window history area.
[*-courier-medium-r-normal--12-*]
prompt_reply.fontList:
The font for the prompt window reply area.
[*-courier-medium-r-normal--12-*]
COPYRIGHT
CMISS IS PROPRIETARY SOFTWARE. It is owned by
Auckland UniServices Ltd,
C/- The University of Auckland
Private Bag 92019,
Auckland 1,
NEW ZEALAND
The use of CMISS is subject to the following conditions:
1. Auckland UniServices Limited grants a limited, non-
exclusive, non-sublicensible, license to use this
version of CMISS in binary executable form for aca-
demic use only.
2. Auckland UniServices Limited makes no representa-
tion about the suitability of the software or about
any content of information made accessible by the
software, for any purpose. CMISS is provided "as
is". Auckland UniServices Limited disclaims all
express or implied warranties, including warranties
of merchantability, and fitness for a particular
purpose, title and or non-infringement. CMISS is
provided gratuitously for academic use, and accord-
ingly, Auckland UniServices Limited shall not be
liable for any consequential or other damages suf-
fered by you or any user of CMISS. Auckland UniSer-
vices Limited will not support CMISS apart from the
help accessible via the CMISS Web Site and will not
necessarily issue updates.
3. Title, Ownership Rights, Copyright and other Intel-
lectual Property Rights in and for CMISS remain in
Auckland UniServices Limited. CMISS is copyright
1996-2001 by Auckland UniServices Limited.
SEE ALSO
cmiss(1), cm(1).
Apr 27, 2001 CMGUI(1)