This README file contains information specific to the MS Windows versions of
ANA, AVE and ROD. See the README.txt for general information on the programs and
INSTALL.UNIX for the installation information (which is also partially relevant
for MS Windows).
The ANA and ROD programs use a graphic library called GrWin written by Tsuguhiro
Tamaribuchi (tamari@spdg1.sci.shizuoka.ac.jp). The documentation and the latest
distribution of the GrWin Library and PGPLOT drivers are available at the
following URLs:
(WWW) http://spdg1.sci.shizuoka.ac.jp/grwinlib/english/
(FTP) ftp://spdg1.sci.shizuoka.ac.jp/pub/GrWinlib/english/
The PGPLOT and GrWin development and runtime files are also available on the
ANA-ROD download pages as both a "tar-gzip" and a "zip" archive in the files
pgplotPPP_grwinGGG_devrun_mingw.tar.gz
pgplotPPP_grwinGGG_devrun_mingw.zip
where PPP is the PGPLOT and GGG the GrWin version number.
These archives contain:
- the PGPLOT/GrWin libraries needed for ANA-ROD development:
libGrWin.a, libcpgplot.a and libpgplot.a
- the GrWin server and auxiliary files needed to run ANA-ROD:
grwnd.exe, grfont.dat, rgb.txt and grwnd.ini
The files needed to run ANA-ROD should be installed in the same directory as the
ANA-ROD executables. If this is not possible or desirable, the environment
variable "GRWINDIR" can be used to indicate the location of the GrWin server
and/or the optional initialization file "grwnd.ini". Note that independently of
setting GRWINDIR the environment variable PGPLOT_DIR still may have to be set
(see file "INSTALL.UNIX").
The file "grwnd.ini" allows to set default values for the properties of the
GrWin server. In particular, when setting "ZOrder=2" the resulting GrWin
graphics window starts with the "Window" property "Top Most" being switched off,
which means that it does not remain obstinately in front of all other windows
all the time.
Note that the first line of "grwnd.ini" has to be "[Defaults]" (without quotes),
otherwise the parameters defined in the file are not taken into account by the
GrWin server.
Information on the parameters that can be set in "grwnd.ini" is difficult to
find as it is partially in the program code and partially in several other
documents about the GrWin libraries. Therefore a version of "grwnd.ini" with all
parameters and explanations of their values is listed below. Note that all lines
starting with a hashmark ("#") are ignored by GrWin.
More information on "grwnd.ini" and the options for the GrWin server "grwnd.exe"
can be found at "spdg1.sci.shizuoka.ac.jp/grwinlib/english/grwndexe.html".
================================================================================
[Defaults]
#
# Storing: When this mode is set on, objects drawn are stored (serialized) in
# memory, and will be used in redrawing printing, and saving to a file, etc.
# With this mode set off, on the contrary, they are deleted and the amount of
# memories used can be reduced, though features based on the serialization such
# as redrawing, printing and saving are not available, in principle.
#
# The default status of this mode is set on.
#
# values: 1[0] the storing mode is set ON [OFF].
#
Storing=1
#
# Buffering: When this mode is turned on, an internal bitmap is created as a
# copy of the current window, and subsequent drawings are made on the bitmap.
# The drawing on the bitmap is faster but is memory consuming.
#
# The default status of this mode is set on.
#
# values: 1[0] the buffering mode is set ON [OFF].
#
Buffering=1
#
# Displaying status bar: The frame window has a status bar at the bottom, which
# can be turned on or off. The status bar has several panes to display
# information of the current window: the first is for messages, the second for
# window number and the mouse cursor position, the third for the current view
# and the fourth is for the current number of the objects stored in memory.
#
# For fast drawings it is recommended to set this mode off.
#
# The default status of this mode is set on.
#
# values: 1[0] the status bar is displayed [not displayed].
#
StatusBar=1
#
# Inquiring: When this mode is ON, a dialog box appears on deleting the objects
# or on importing an image on the clipboard.
#
# The default status of this mode is set off.
#
# values: 1[0] the inquiring mode is set ON [OFF].
#
Inquiring=0
#
# Landscape: The landscape mode is used in printing.
#
# The default status of this mode is set on.
#
# values: 1[0] the landscape printer mode is set ON [OFF].
#
Landscape=1
#
# Staying open on QUIT: Leaves the main frame window open when the application
# terminates the graphics package (by call to GWQUIT).
#
# The default status of this mode is set off.
#
# values: 1[0] the staying open on QUIT mode is set ON [OFF].
#
StayOpen=0
#
# Width and height (in pixels) of the frame
#
Width=1080
Height=720
#
# Screen coordinates (in pixels) of the top-left corner of the frame
#
#PointX=0
#PointY=0
#
# Show state of the frame. Possible values:
# 0: Hides the frame and activates another frame.
# 1: Maximizes the specified frame.
# 2: Minimizes the specified frame and activates the next top-level frame in
# the Z order.
# 3: Activates and displays the frame. If the frame is minimized or
# maximized, the system restores it to its original size and position.
# An application should specify this flag when restoring a minimized frame.
# 4: Activates the frame and displays it in its current size and position.
# 5: Activates the frame and displays it as a maximized frame.
# 6: Activates the frame and displays it as a minimized frame.
# 7: Displays the frame as a minimized frame. The active frame remains active.
# 8: Displays the frame in its current state. The active frame remains active.
# 9: Displays a frame in its most recent size and position. The active frame
# remains active.
# 10: Activates and displays a frame. If the frame is minimized or maximized,
# the system restores it to its original size and position.
# An application should specify this flag when displaying the frame for the
# first time.
#
ShowMode=10
#
# Z-order of the frame. Possible values:
# 1: Place the frame window at topmost
# 2: Place the frame window behind all topmost windows
# 3: Place the frame window at the top
# 4: Place the frame window at the bottom
#
ZOrder=2
#
# Arranges the windows in the main window. Possible values:
# 1: Cascade
# 2: Tile Horizontally
# 3: Tile Vertically
# 4: Arrange Icons
#
#ArrangeMode=2
#
# The default and the maximum dpi value for printing, bitmaps, etc.
#
# It should be noted that the upper limit of dpi values assumed in making an
# internal bitmap is specified with MaxDPI. In the Bitmap mode with buffering
# being ON and DefaultDPI option not set, the assumed bitmap size depends on
# your current working printer, and a huge bitmap internally to be created may
# cause your computer being unstable. So do not set a too large value (> 600) to
# MaxDPI unless you do know what you are doing.
#
#DefaultDPI=300
MaxDPI=300