Parent Topic: <A href="http://www.pcigeomatics.com/cgi-bin/pcihlp/IWORKS">IWORKS</a><hr>
<H3>Command Line Options</H3>
Note:  Command Line Options are not supported on Mac OS.
<P>
<PRE>
 Usage: imageworks [options]
</PRE>
ImageWorks accepts a number of command line options. Some of these
are for debugging purposes, while others can be used to defined
operating modes.  The following is a list of command line options:
<P>
<PRE>
 -datasize x_size y_size
</PRE>
The -datasize option is used to define the size of the image and
graphic planes in memory. It overrides the datasize defined in the
parameter file (PRM.PRM), and suppresses the ImageWorks Configuration
Panel.  The default size is 512 x 512, if there is no PRM.PRM file.
<P>
<PRE>
 -image n_planes
</PRE>
The -image option allows the number of in-memory image planes to be 
configured. The argument overrides the number of image planes defined 
in the parameter file, and suppresses the ImageWorks Configuration Panel.
The default number of image planes is 3, if there is no parameter file.
<P>
<PRE>
-image # 8-bit planes [# 16-bit planes] [# 32-bit planes]

For example 
   -image 2 3 1
</PRE>
In this example 2 8-bit image planes are created along with 3 16-bit planes
and 1 32-bit plane.  The parameters for specifying the number of 16 and
32-bit imageplanes are optional and can be zero.
<P>
<PRE>
 -graphic n_planes
</PRE>
<PRE>
 -graphic n_planes
</PRE>
The -graphic option allows the number of in-memory graphic planes 
to be configured. The argument overrides the number of graphic planes 
defined in the parameter file, and suppresses the ImageWorks Configuration
Panel. The default number of graphic planes is 8, if there is no parameter
file. The number of graphic planes may not exceed 16.
<P>
<PRE>
 -nocontrol
</PRE>
The -nocontrol option suppresses the popping up of the ImageWorks
General Control panel. This is primarily useful for hands off demos.
<P>
<PRE>
 -noconfig
</PRE>
The -noconfig option suppresses the popping up of the ImageWorks 
configuration panel.  This is primarily useful for hands off demos.
<P>
<PRE>
 -nomenu
</PRE>
The -nomenu command line option suppresses the menubar from appearing in
the main ImageWorks display window.  This is primarily useful for hands off
demos.
<P>
<PRE>
 -name window-name
</PRE>
This option allows the name appearing on the window frame of the main
ImageWorks window to be overridden.  This is the equivalent of setting a
non-default value in the VDn: parameter in the PRM.PRM file.
<P>
<PRE>
 -mainwin display-name
</PRE>
Normally, all of the ImageWorks panels appear on one display; this display 
is determined by the DISPLAY environment variable or the -display command 
line option. Sometimes, however, the user will want to display the main
image window on another display (when there are two monitors side by side,
for instance).  The -mainwin option allows the user to specify this
second display.  The `display-name' value should be the name of the display 
to which the main image window is to be redirected.
<P>
<PRE>
 -cmd procedure_name
</PRE>
The -cmd command line argument is used to pass an EASI Modelling Procedure
to be executed after ImageWorks startup.  The argument is the name of an
EASI procedure to be executed.  The filename should be all in upper case,
and with the extension &quot;.EAS&quot;.  Only the base portion of the filename should
be provided (eg. `filter' instead of FILTER.EAS).
<P>
<PRE>
 -play recording_file
</PRE>
The -play command is used to trigger automatic execution of a user 
interaction recording created with the Macro Recorder.  The pathname to
the file to be executed should be provided as an argument.  The macro will
be ``played'' after the configuration panel has been popped down, so for
a fully automated startup the -noconfig commandline argument should also
be used.
<P>
<PRE>
 -share 
 -noshare
</PRE>
The -share option is used to turn on use of the X Windows Shared
Memory extension where possible. The -noshare option is used to
ensure the extension is not used. The shared memory extension speeds
up redraw speed on the screen, sometimes by as much as a factor of
three if the display is local to the machine running ImageWorks.
However, on many systems the shared memory extension causes problems
with proper screen updating when performing Image, Graphic, and
Vector editing. Thus shared memory is defaulted to not being used.<p>
People wishing to squeeze extra graphic performance out of
ImageWorks are encouraged to try out the -share option.
<P>
<PRE>
 -mmap 
 -nommap
</PRE>
The -mmap option enables the used of memory mapped disk IO where
possible. Its use is equivalent to defining the environment
variable ``ENABLE_MMAP''. The -nommap option disables memory mapped
disk IO, even if the ``ENABLE_MMAP'' environment variable is defined.<p>
Memory mapped disk IO can provide IO speedups of up to a factor of
three on some machines. However, on at least a few machines, the use
of memory mapped IO can cause problems. Those interested in speeding
up IO are encouraged to experiment with the -mmap option.  This option 
only works on some systems.
<P>
<PRE>
 -8
</PRE>
The -8 option forces ImageWorks to consider only 8-bit visuals.
<P>
<PRE>
 -24
</PRE>
The -24 option forces ImageWorks to consider only 24-bit visuals.
<P>
<PRE>
 -extra
</PRE>
This option will enable several extra options in the ``Tools'' pulldown 
menu and possibly elsewhere.  These functions are not considered to
be release ready, but may be interesting to experiment with.
<P>
<PRE>
 -showerror
</PRE>
On SunOS 4.x (not Solaris), standard error is redirected to
/dev/null. The -showerror option prevents this redirection.
<P>
<PRE>
 -debug [n]
</PRE>
The -debug option places ImageWorks in debugging mode. Plentiful output 
is sent to standard error.
<P>
<PRE>
 -nodebug
</PRE>
The -nodebug option ensures that ImageWorks is not run in debugging mode.
<P>
<hr>
Parent Topic: <A href="http://www.pcigeomatics.com/cgi-bin/pcihlp/IWORKS">IWORKS</a><br>
<a href="http://www.pcigeomatics.com/dev_corner/pcihlp_gateway.html">About PCI Help Gateway</a>