visu(1)

NAME
visu - OSF/Motif user interface builder

SYNOPSIS
visu [ -csepAKCSEulbarmRMFWX [ code_file ] ] [ -windows ] [ -f filename ] [ -xV ]

DESCRIPTION

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.

OPTIONS

-c  Generate C code to code_file. If code_file is not specified, last C file specified in visu will be used.

-s  Generate C stubs to code_file. If code_file is not specified, last stubs file specified in visu will be used.

-e  Generate C externs to code_file. If code_file is not specified, last externs file specified in visu will be used.

-p  Generate C pixmaps to code_file. If code_file is not specified, last pixmaps file specified in visu will be used.

-A  Generate ANSI-C. Force generated code to be ANSI-C. Overrides any setting in the design file.

-K  Generate K&R C. Force generated code to be K&R C Overrides any setting in the design file.

-C  Generate C++ source code to code_file. If code_file is not specified, last C++ file specified in visu will be used.

-S  Generate C++ stubs to code_file. If code_file is not specified, last C++ stubs file specified in visu will be used.

-E  Generate C++ externs to code_file. If code_file is not specified, last C++ externs file specified in visu will be used.

-u  Generate UIL code to code_file. If code_file is not specified, last UIL file specified in visu will be used.

-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.

-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.

-a  Generate UIL pixmaps to code_file. If code_file is not specified, last pixmaps for UIL file specified in visu will be used.

-r  Generate X defaults to code_file. If code_file is not specified, last X defaults file specified in visu will be used.

-m  Generate Makefile to code_file. If code_file is not specified, last Makefile specified in visu will be used.

-R  Generate Microsoft Windows resource file.

-M  Generate Motif flavour C++.

-F  Generate Motif XP flavour C++.

-W  Generate Microsoft Windows MFC (Microsoft Foundation Class) flavour C++.

-X  Synonym for -r.

-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.

-windows
    Start visu in Microsoft Windows mode.

-f file_name
    Input file. Use -f to avoid confusion with default code_file.

-x  Print list of switches.

-V  Print the version number and exit.

ENVIRONMENT VARIABLES
The behaviour of visu is influenced by a number of environment variables specific to visu.

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:

SW_VISU_XFILESEARCHPATH
    This is prepended to XFILESEARCHPATH after $VISUROOT/lib/locale/$LANG/app-defaults is prepended.

SW_VISU_XBMLANGPATH
    This is prepended to XBMLANGPATH after $VISUROOT/bitmaps is prepended.

SW_VISU_XNLSPATH
    This is prepended to XNLSPATH after $VISUROOT/nls (or whatever alternative was configured at installation time) is prepended.

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".

FILES
$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

AUTHOR
Imperial Software Technology Ltd.