MGED(1)

NAME
mged - multi-display interactive combinatorial solid geometry editor

SYNOPSIS
mged [-r] [-c] [-f] database.g [mged_command]

DESCRIPTION
mged interactively edits the specified database file database.g on any one of a number of display devices, including any UNIX-plot device, a Vector General 3300, a Megatek 7250, a Tektronix 4014 or compatable display, a Tektronix 4109 or compatable display, a Raster Technologies One/80, an Evans and Sutherland Picture System 300, a Silicon Graphics IRIS 2400 or 3030 workstation, a Silicon Graphics IRIS 4D workstation, or any workstation which supports the MIT X-Window System (X11).

For detailed documentation, obtain a copy of the guide ``Computer Graphics for Target Descriptions'', BRL Technical Report ARBRL-TR-02480, ``GED: An Interactive Solid Modeling System for Vulnerability Assessments'', or refer to the ``Users Manual for BRL-CAD Graphics Editor MGED'' which is included in the full BRL-CAD manual set.

HINTS
mged database names conventionally end with .g.

SIGINT aborts the current command.

"q" or EOF exits the program.

EXAMPLE
    $ mged tank.g

STARTUP
mged may be run in one of three modes. (a) single-shot command. One command is given on the command line, after the database name. (b) multiple commands from a file. The input is not from a terminal, but instead from a file or shell-script ``here document''. No display manager is attached to. (c) interactive mode.
The ".mgedrc" file is processed and then either a multiple window graphical user interface (GUI) is presented or the user is prompted for which display manager they wish to attach to, with a question like:
  attach (nu|tek|tek4109|ps|plot|sgi|X)[nu]?

The ".mgedrc" file is searched for in three places. The first one found is used, and any others are ignored. (a) If the environment variable MGED_RCFILE is set, it is used as a path name for the file to be used. (b) If the environment variable HOME is set, then HOME/.mgedrc is used. (c) If the file ".mgedrc" exists in the current directory, it is used.

Whether or not mged presents a multiple window GUI depends on whether or not it is running in "classic" mode. By default, it will create a multiple window GUI and automatically detach from the executing terminal so it may run as a background process.

MODES
The "set" command can be used to select various operating modes for mged. This is most useful in conjunction with the ".mgedrc" file, to establish per-user preferences.
  set autosize=0
will defeat the automatic resizing of the view when the screen is empty.

  set sgi_win_size=1024
  set sgi_win_origin=200,0
can be used (before attaching to the SGI display manager) to establish a preference for the size and location of the window to be opened.

The -r option to mged opens the database in a read-only mode.

The -c option to mged will run in "classic" mode.

The -f option to mged will prevent the application from automatically detaching and running in the background.

X11 NOTES
When using mged with the X11 display manager (or the SGI display manager on an SGI 4D running IRIX 4.0), be certain that the shell variable DISPLAY is set to indicate the host that you wish to have your window opened on. Failure to set the DISPLAY variable, or setting it improperly, can cause bemusing error messages from the X window system.

SEE ALSO
Computer Graphics for Target Descriptions
brlcad(1), rt(1), comgeom-g(1), vdeck(1), librt(3).

DIAGNOSTICS
Error messages are intended to be self-explanatory.

AUTHORS
Keith Applin
Doug Gwyn
Chuck Kennedy
Gary Kuehl
Gary Moss
Mike Muuss
Chuck Stanley
Bob Suckling
Earl Weaver

SOURCE
SECAD/VLD Computing Consortium, Bldg 394
The U. S. Army Ballistic Research Laboratory
Aberdeen Proving Ground, Maryland 21005

BUG REPORTS
Reports of bugs or problems should be submitted via electronic mail to <devs@brlcad.org>.