.\" @(#)visu.1 2.1  7/3/94
.\" .ds ]W visu
.\" Copyright (c) 1992 by Imperial Software Technology.
.TH visu 1 "17th March 1995"
.SH NAME
visu \- OSF/Motif user interface builder
.SH SYNOPSIS
.B visu
[
.BI \-csepAKCSEulbarmRMFWXJ
[
.I "code_file"
]
]
[
.I -windows
]
[
.BI \-f " filename"
]
[
.BI \-xV
]
.SH DESCRIPTION
.IX "visu"  ""  "\fLvisu\fP
.LP
.B visu
is a Graphical User Interface builder for X and OSF/Motif.
If any of the code generation flags are specified, visu will not run
interactively, and an input file_name must be specified.
.SH OPTIONS
.TP 10
.BI \-c
Generate C code to code_file.
If code_file is not specified, last C file specified in
visu will be used.
.TP
.BI \-s
Generate C stubs to code_file.
If code_file is not specified, last stubs file specified in
visu will be used.
.TP
.BI \-e
Generate C externs to code_file.
If code_file is not specified, last externs file specified in
visu will be used.
.TP
.BI \-p
Generate C pixmaps to code_file.
If code_file is not specified, last pixmaps file specified in
visu will be used.
.TP
.BI \-A
Generate ANSI-C.
Force generated code to be ANSI-C.
Overrides any setting in the design file.
.TP
.BI \-K
Generate K&R C.
Force generated code to be K&R C
Overrides any setting in the design file.
.TP
.BI \-C
Generate C++ source code to code_file.
If code_file is not specified, last C++ file specified in
visu will be used.
.TP
.BI \-S
Generate C++ stubs to code_file.
If code_file is not specified, last C++ stubs file specified in
visu will be used.
.TP
.BI \-E
Generate C++ externs to code_file.
If code_file is not specified, last C++ externs file specified in
visu will be used.
.TP
.BI \-u
Generate UIL code to code_file.
If code_file is not specified, last UIL file specified in
visu will be used.
.TP
.BI \-l
Generate C code for UIL to code_file.
If code_file is not specified, last C for UIL file specified in
visu will be used.
.TP
.BI \-b
Generate stubs for UIL code to code_file.
If code_file is not specified, last stubs for UIL file specified in
visu will be used.
.TP
.BI \-a
Generate UIL pixmaps to code_file.
If code_file is not specified, last pixmaps for UIL file specified in
visu will be used.
.TP
.BI \-r
Generate X defaults to code_file.
If code_file is not specified, last X defaults file specified in
visu will be used.
.TP
.BI \-m
Generate Makefile to code_file.
If code_file is not specified, last Makefile specified in
visu will be used.
.TP
.BI \-R
Generate Microsoft Windows resource file.
.TP
.BI \-M
Generate Motif flavour C++.
.TP
.BI \-F
Generate Motif XP flavour C++.
.TP
.BI \-W
Generate Microsoft Windows MFC (Microsoft Foundation Class) flavour C++.
.TP
.BI \-J
Generate Java(tm) to the directory specified.
.TP
.BI \-X
Synonym for -r.
.TP
.BI \-L
Run with a private colormap. This is useful if you are running other applications which have a high color usage. This option may cause color flashing when moving between windows.
.TP
.BI \-windows
Start visu in Microsoft Windows mode.
.TP
.BI \-f " file_name"
Input file. Use -f to avoid confusion with default code_file.
.TP
.BI \-x
Print list of switches.
.TP
.BI \-V
Print the version number and exit.
.SH "ENVIRONMENT VARIABLES"
The behaviour of visu is influenced by a number of environment
variables specific to visu.
.PP
visu prepends three important X environment variables with
visu-specific directory paths. Whilst this is safe, and protects
from old versions of files accidentally being picked up from the
paths, it makes it impossible to override the visu default
settings for X resources, bitmaps and the like. To counter this, for
those users that require an override capability, three "extended"
path environment variables are understood by visu:
.IP SW_VISU_XFILESEARCHPATH
This is prepended to XFILESEARCHPATH after $VISUROOT/lib/locale/$LANG/app-defaults
is prepended.
.IP SW_VISU_XBMLANGPATH
This is prepended to XBMLANGPATH after $VISUROOT/bitmaps is
prepended.
.IP SW_VISU_XNLSPATH
This is prepended to XNLSPATH after $VISUROOT/nls (or whatever
alternative was configured at installation time) is prepended.
.PP
By default visu utilises a set of icons that use minimal
color and render satisfactorily on a monochrome display.
However, if you have a color display and would like to use the full
color icons then these can be switched on by setting the environment
variable SW_VISU_ICONS to "color_icons" (the default is
"bitmaps").
Conversely, if you want to see the default set of built-in monochrome
icons then set SW_VISU_ICONS to "default".
.SH FILES
.nf
$VISUROOT - base installation directory
$VISUROOT/bitmaps - standard bitmaps
$VISUROOT/color_icons - full color icon bitmaps
$VISUROOT/lib/locale/$LANG/app-defaults - X resource files
$VISUROOT/bin - executable binary directory (add to PATH)
$VISUROOT/demos - demonstration programs, etc
.fi
.SH AUTHOR
Imperial Software Technology Ltd.