THE VISTAPRO MENUS
VISTAPRO MENUS
within the Vistapro Program
Vistapro's menus are accessed via the buttons at the top left
of the main screen. To see the menus, place the mouse cursor
over one of the buttons and press the left mouse button. A menu
with several selections appears immediately below the button.
This menu will remain on the screen as long as the left mouse
button is held down. To select a menu item, move the mouse
pointer down over the menu and release it when the cursor is
over the desired item. For more general information on using
the menus see the Graphical User Interface section located in
Chapter 2 of the manual.
There are five menus in Vistapro:
* The Project Menu allows access to DOS, information about
Vistapro, information about the currently loaded landscape, and
the quit Vistapro function.
* The Load Menu allows loading of landscapes, colormaps and pictures.
* The Save Menu saves landscapes, colormaps and pictures.
* The GrMode Menu is used for selecting graphics and animation modes.
* The Script Menu is for creating and executing Scripts.
Many of the Menu items involve the use of Vistapro's File
Requestor. The File Requestor indicates file names for those
functions which require file names - loading and saving files
for example. The File Requestor allows easy navigation through
drives and directories to find files. See the section titled
Vistapro File Requestor for more details on how to use the File
Requestor.
PROJECT MENU
------------
The Project Menu allows temporary transfer to DOS, retrieves
the information about the current landscape, and allows you to
quit Vistapro.
Spawn DOS
---------
Spawn DOS temporarily transfers you to the DOS command line.
Spawn DOS is useful to format a diskette, delete files, view an
animation, or perform other DOS tasks. When Spawn DOS is
requested, Vistapro returns the screen to the starting mode. It
frees about 256K of memory and then attempts to run
COMMAND.COM. If an attempt is made to run a program that
requires more than 256K of memory, it may not succeed. After
the DOS excursion is completed, type EXIT to exit DOS and
return to Vistapro. Vistapro returns to the state that it was
in when the DOS excursion was initiated.
About Vista
-----------
About Vista opens a window with information about Vistapro, its
authors, and its publisher. While this window is visible, none
of the other Vistapro menus and buttons will be active even
though they are still visible. To shut this window click the
button labeled OK at the top left corner of the window.
About Landscape
---------------
About Landscape opens a window with information about the
current landscape. The file name of the landscape and other
information from the landscape header file will appear. While
this window is visible, none of the other Vistapro menus and
buttons are active even though they are still visible. To shut
this window click the button labeled OK at the top left corner
of the window.
Quit
----
Quit causes Vistapro to clean up after itself and return to DOS
or the program from which you started Vistapro. Vistapro will
delete all its temporary files, restore the screen to the mode
that it was in when Vistapro was started, and free the memory
it was using.
LOAD MENU
---------
Load Menu loads landscapes, colormaps, and picture (PCX format)
files into Vistapro. The File Requestor is used for all these
functions. See the File Requestor section for details on its
use.
Load DEM
--------
DEM is an acronym for Digital Elevation Model - a format used
to represent landscape data. Load DEM loads a landscape into
Vista. Each Vistapro landscape has elevation data, color data,
and usually, some textual information (which can be read via
the About Landscape Menu item). All of this information is
loaded by Load DEM. Many of the internal settings of Vistapro
will be reset to some default values when a landscape is loaded
- for instance, the camera is placed at the top center of the
contour map and the target is placed at the bottom center.
Vistapro recalculates all of its coloring and shading
information when rendering starts.
When installing Vistapro, all landscapes are placed in the DEM
subdirectory in the Vistapro directory. For example, if
Vistapro was installed in C:\VISTAPRO then all its landscapes
will be found in C:\VISTAPRO\DEM.
Load CMAP
---------
The CMAP, or colormap, is the group of colors, contrast
setting, and exposure setting used to coltion.
VESA 1024x768
-------------
This is the 1024x768 256 color VESA format available on many
VGA and SVGA cards with 1024K (1M) of video memory. Most VESA
drivers for SVGA cards with 1024K (1M) of memory support this
mode. A monitor capable of handling this mode is required.
Standard VGA monitors do not support this mode. Many Multi-sync
or Multi-scan monitors do not support this mode.
SCRIPT MENU
-----------
The Scripting functions allow generation of a series of images
without having to attend to the computer for each image. There
are two uses for Scripts. One generates a sequence of images
unattended. The second generates animations. Actually both uses
are the same except that the succession of camera positions is
more ordered for animations.
Vistapro Scripts can only control the camera location and
direction. Lighting, or any of the other settings of Vistapro,
can't be controlled from script functions.
Vistapro Script files are plain ASCII text files. You can use
any text editor that saves files in ASCII to change them. It is
important the first line of the Script file be: Vista Script
File. The text must appear exactly as depicted here with no
leading or trailing spaces. The second line may have any text
or may be left blank - when Vistapro creates a Script file the
second line is just a reminder of the order of the data on each
line of the Script CamX, CamY, CamZ, Bank, Hdng, Ptch,.
The subsequent lines are a sequence of Camera X, Y, and Z
coordinates and Banks, Headings, and Pitches. There is one line
for each frame of the animation. The first value on the line is
the Camera X position. The second value is the Camera Y
position, and the third value is the Camera Z position. The
following values are the Camera, Bank, Heading, and Pitch
settings. These values are similar to the corresponding values
that appear in Vistapro's Control Panel. Leading or trailing
spaces are allowed on these lines. Each value must be separated
by a comma. Text may be included after the six required values.
The values may be either in integer or floating point format.
For example, the following constitutes a valid Script file:
Vista Script File
CamX, CamY, CamZ, Bank, Hdng, Ptch,
0, 0, 1234, -20, +30, 17,
1000, 1000, 2000, 0, 0, 0
1234.56, -2345.67, .34, 0.27, -.123, 3, "Comment"
Note that leading spaces are valid.
The simplest way to start a new Vistapro Script file is to use
Vistapro's Create Script function. This will create a Script
file with the first two lines filled out. Append each of the
camera positions to the file.
Generate
--------
This option creates a quick linear path from the current camera
position to the current target position. Generate is most
useful for generating simple straight-line paths for
animations. When this option is selected, Vistapro asks for the
name of the Script file to generate. Then it asks for the
number of frames. If the camera is 1000 meters from the target
and 100 frames are selected, the camera will be 10 meters
closer to the target in each subsequent frame. The Bank,
Heading, and Pitch will remain constant (the camera will
continue to point at the target).
If the name of an existing file is selected, Vistapro will ask
you if you want to delete the file or abort the operation.
Putting Script files in the SCRIPT subdirectory, usually
C:\VISTAPRO\SCRIPT, is recommended.
Create
------
Create is used to create a new Script file. The new file will
have the appropriate first line to identify it as a valid
Vistapro Script file. The second line shows the order of the
arguments for the subsequent lines. If you select a file name
that already exists, Vistapro will ask if you want to delete it
or abort the operation. Putting Script files in the SCRIPT
subdirectory, usually C:\VISTAPRO\SCRIPT, is recommended.
Open
----
Open simply selects a file name for use with the Add function
described below. Open a file when you want to append camera
positions to an old Script file. If the name of a file that
doesn't exist is selected, Vistapro will complain and then do
nothing. Script files default to the C:\VISTAPRO\SCRIPT
subdirectory.
Add
---
This function adds the current camera position, Bank, Heading,
and Pitch to the current Script file. You must first select the
script file with either the Generate, Create, or Open Script
functions.
Preview
-------
Preview depicts the path specified by a Script file. It appears
as a series of black dots on the contour map. Each dot
represents one Camera position.
Execute
-------
This function executes a script. Vistapro asks for the name of
the script to execute and the name of the image or animation
file(s) to output. Vistapro has two Execute modes that are set
by the GrMode (Graphics Mode) Menu items.
If the graphics mode is VANIM 320x200 Vistapro will produce a
VANIM animation file which can be viewed with the Viewer
utility. In any other graphics mode Vistapro will produce a
sequence of PCX files. The PCX files are named: ABCxxxxx.PCX
where ABC is the filename that you supplied via the File
Requestor, xxxxx is a five digit number indicating the frame
number, and .PCX is the standard extension. For example, if you
picked PIC as the filename the output files will be:
PIC00000.PCX
PIC00001.PCX
PIC00002.PCX
etc....
If you picked a filename longer than three characters only the
first three characters will be used; if you selected
PICTURE.XYZ the same sequence of picture names are generated as
with PIC.If you select a name shorter than three characters
Vistapro will just append the five digit value to the name you
selected. A filename of P will generate the following output
files:
P00000.PCX
P00001.PCX
P00002.PCX
etc....
If you are generating an animation in VANIM mode the output
file name is exactly the name you specified with the exception
that if you didn't supply an extension Vistapro will
automatically append .VAN to the file name:
PIC -> PIC.VAN ; no extension specified
PIC. -> PIC. ; a blank extension specified
PIC.VNM -> PIC.VNM ; a different extension specified
We recommend that all your VANIM animations use the .VAN
extension.
