OSM Composer and other OSM tools are research-oriented projects developed at Brigham Young University. These tools come "as is." They are packaged together and are currently compiled and available for the following platforms:
These installation file sets are also available through anonymous ftp to osm7.cs.byu.edu in the osm subdirectory.
The installation file set contains the following files:
COPYRIGHT bin/compose bin/Ipost bin/Normalize osm/{a whole lot of files}
You must read the license agreement before downloading OSM Composer.
After reading the license agreement and downloading the installation file set, uncompress the file set and extract the contents of the tar file into a directory you have chosen for installation. We recommend /usr/local as the installation location. For example:
cd /usr/local -- use anonymous ftp to download the installation file set gunzip composer-hp-700.tar.gz tar xvf composer-hp-700.tar
Make sure the bin directory is in your path, and type compose
to start the OSM Composer. The Composer window should appear on your screen.
There are a number of environment variables you can use to customize OSM Composer's operation:
OSMFILES
-- the full
path of the configuration-file directory. The default value is
/usr/local/osm
. If you install OSM Composer is some location
other than /usr/local
, you must set this variable accordingly.
OSMPATH
-- the full
path of the directory where your diagram files are stored. The default value
is the current working directory.
OSMPRT
-- the command
used to print PostScript files on your system. For HP systems, the default
value is "lp %s
", and for SPARC systems it is
"lpr -h %s
". Your command must contain a single "%s
".
The "%s
" is replaced at run time by the name of the file to print.
OSMTMP
-- the full
path of the directory OSM Composer will use for temporary working space
(e.g., for temporary print files, etc.).
OSMQL_COMPILE
-- the
command used to compile an OSM-QL query program. The default value is
"gcc %s/queryCode%d.C -L%s -L/usr/local/lib -lsf -lg++ -I%s -I. -o %s/queryCode%d
".
We have tested OSM-QL with the Gnu gcc compiler, version 2.6.3.
OSMHELP
--
the command used to view the OSM Composer help that is accessible through
the World-Wide Web at URL http://osm7.cs.byu.edu/composer/home.html.
This command needs to contain a single "%s
". The
"%s
" is replaced at run time by the URL of the help document.
If you do not specify OSMHELP, the default help command is
"netscape %s &
".
OSM_RESIZE_ENABLE
--
this variable is only effective for HP systems. It places Motif resize
decorations on OSM Composer's dialog boxes. The default is for resize
decorations to be absent for HP systems.
We have experienced difficulty using the Art user-interface mechanism on non-Motif X-Window systems. If you have difficulty getting the keyboard focus in text type-in boxes, try changing your X-Window focus policy from click focus to mouse focus. (That is, have the focus follow the mouse cursor, rather than change when you click the mouse in a window.)
There are bugs in OSM Composer. This is a research project, and you will find bugs and/or quirks as you use this software. You may send bug reports and other suggestions to osm@osm7.cs.byu.edu.