Un-ignored: the dev drive is the ground truth the restoration and emulator work constantly reference (DPL3/LIBDPL + VRENDER i860 renderer source, BT/RP live+dev game trees, VGL_LABS pod boot, scene/audio content). Kept in-repo for the pod-owner community. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
439 lines
11 KiB
Plaintext
439 lines
11 KiB
Plaintext
VIZPC HELP FILE
|
|
---------------
|
|
THIS FILE HAS THE FOLLOWING STRUCTURE -
|
|
THE FIRST 3 CHARS OF EACH LINE CONTAINS THE KEYWORD
|
|
THE USER GIVES A KEYWORD AND THE PROGRAM SEARCHES
|
|
UNTIL IT FINDS IT. ALL LINES ARE THEN OUTPUTTED UNTIL
|
|
A NON BLANK KEYWORD IS FOUND.
|
|
"???" IS USED IF NO MATCH IS FOUND IN THE FILE
|
|
???
|
|
|
|
Rectangular prism "REC" Cylinder "CYL"
|
|
Extruded shape "EXT" Rotated shape "REV"
|
|
Pyramid shape "PYR" Sphere "SPH"
|
|
Hemisphere "HEM" Manual input "MAN"
|
|
File input "REA" Change colour "CHA"
|
|
|
|
Move "MOV" Copy "COP"
|
|
Rotate "ROT" Scale "SCA"
|
|
Edit "EDI" Search "SEA"
|
|
|
|
Delete "DEL" Group "GRO"
|
|
Ungroup "UNG" Totals "TOT"
|
|
Invert "INV" Set Colour "SET"
|
|
Menu "MEN" Bottle "BOT"
|
|
|
|
List "LIS" Dump to file "SAV"
|
|
Draw "DRA" Define Macro "DEF"
|
|
Identify "IDE" Axonometric "AXO"
|
|
Window "WIN" Help "HEL"
|
|
|
|
Finish "QUI"
|
|
|
|
KEY
|
|
|
|
The following keywords are recognised -
|
|
|
|
HELp RECtangle EXTrude REVolution
|
|
DRAw PYRamid CYLinder MANual
|
|
IDEntify SET colour BOTtle MOVe
|
|
SEArch COPy ROTate SCAle
|
|
INVert EDIt DELete LISt
|
|
SAVe AXOnometric GROup UNGroup
|
|
REAd CHAnge colour TOTals WINdow
|
|
SECtion MENu SPHere HEMisphere
|
|
DEFine Zoom QUIt
|
|
|
|
HEL
|
|
|
|
Help "HEL"
|
|
|
|
The user is asked to input a Keyword (only first 3
|
|
chars. significant). If it matches any of the known
|
|
Keywords then that section of text is output.
|
|
If it fails to find the 3 chars input then a list of
|
|
the menu options is output.
|
|
"KEY" gives a list of the recognised Keywords.
|
|
|
|
ZOO
|
|
|
|
Zoom window
|
|
|
|
A window-zoom using the mouse (hold a button pressed)
|
|
can be performed everywhere graphical input is possible.
|
|
P.e. when in axonometric view, search, plan view etc.
|
|
|
|
|
|
DEF
|
|
|
|
Define macro "DEF"
|
|
|
|
The user can define a macro by chosing function-key under
|
|
DOS and a numeric key under X-windows for executing this
|
|
macro, until an ESCape is encountered all commands are
|
|
stored in this macro (file).
|
|
NOTE: The mouse cannot be used to select a command when
|
|
defining a macro!!!!
|
|
|
|
REC
|
|
|
|
Rectangular prism "REC"
|
|
|
|
This shape is created by defining the origin
|
|
(minimum X,Y,Z co-ordinate) and the size of
|
|
the prism (DX,DY,DZ).
|
|
|
|
This shape is always created orthoganal to the axes.
|
|
|
|
CYL
|
|
|
|
Cylinder "CYL"
|
|
|
|
Creates a vertical cylinder.
|
|
|
|
The user inputs the radius and the number of segments,
|
|
the minimum and maximum height and the (X,Y) position
|
|
of the centre of the shape.
|
|
|
|
EXT
|
|
|
|
Extruded shape "EXT"
|
|
|
|
This shape is created by digitizing the section and then
|
|
specifying the length of the shape by defining minimum and
|
|
maximum co-ordinates.
|
|
|
|
The section may be defined in either the XY, YZ or XZ plane.
|
|
The size of the grid is specified.
|
|
|
|
See "SEC" for list of commands to define section.
|
|
|
|
SEC
|
|
|
|
The following commands may be used when inputing
|
|
the section -
|
|
|
|
'E' - end section
|
|
'D' - delete last vertex
|
|
'C' - define circular section
|
|
'A' - line at defined angle and length
|
|
'X' - line at defined angle to X value
|
|
'Y' - line at defined angle to Y value
|
|
'P' - select point not on grid
|
|
'?' - show position
|
|
|
|
REV
|
|
|
|
Rotated shape "REV"
|
|
|
|
Creates an approximation to a solid of revolution.
|
|
|
|
A section is created using the same interface as the
|
|
"EXT" option.
|
|
|
|
The user then defines the number of rotated segments
|
|
and the rotated angle of each.
|
|
|
|
See "SEC" for list of commands to define section.
|
|
|
|
|
|
PYR
|
|
|
|
Pyramid shape "PYR"
|
|
|
|
Creates a pyramid with its base in the XY plane.
|
|
|
|
The base is defined as a section in the same interface as
|
|
in the "EXT" option. The user then inputs the Z of that
|
|
plane and the (X,Y,Z) of the point of the pyramid.
|
|
|
|
See "SEC" for list of commands to define section.
|
|
|
|
|
|
|
|
SPH
|
|
|
|
Sphere "SPH"
|
|
|
|
Creates a sphere.
|
|
|
|
The user defines the radius and the number of segments to
|
|
be created. Center is always (0,0,0). Use MOVe to relocate
|
|
the sphere.
|
|
|
|
|
|
|
|
HEM
|
|
|
|
Hemisphere "HEM"
|
|
|
|
Creates a hemisphere.
|
|
|
|
The user defines the radius and the number of segments to
|
|
be created. Center is always (0,0,0). Use move to relocate
|
|
the hemisphere.
|
|
|
|
MAN
|
|
|
|
Manual input "MAN"
|
|
|
|
The user is prompted to define the vertices and surfaces
|
|
defining the body.
|
|
|
|
The required input is -
|
|
|
|
Number of vertices
|
|
Number of surfaces
|
|
(X,Y,Z) of each vertex
|
|
|
|
for each surface -
|
|
|
|
Number of vertices in surface
|
|
List of vertices in a clockwise direction.
|
|
|
|
|
|
|
|
REA
|
|
|
|
File input "REA"
|
|
|
|
Reads into the database an existing data file.
|
|
|
|
If the user gives a filename without an file type then the
|
|
default file type of ".VIZ" is supplied, otherwise the name
|
|
given by the user is accepted.
|
|
If DIR is inputted the user can get a list of files of a chosen
|
|
directory.
|
|
|
|
For exact definition of legal filenames see -
|
|
"DOS User's Guide".
|
|
|
|
|
|
MOV
|
|
|
|
Move "MOV"
|
|
|
|
The user selects whether to move relatively or absolutely.
|
|
You can move a group or a number of patches.
|
|
|
|
If a relative move is requested then the user inputs the
|
|
dx, dy and dz values.
|
|
|
|
If an absolute move is requested then the origin of the body
|
|
is printed and the user gives the X,Y,Z coordinate that this
|
|
point is to be moved to.
|
|
|
|
|
|
|
|
COP
|
|
|
|
Copy "COP"
|
|
|
|
|
|
Copy a group or a number of patches with the given displacement.
|
|
User inputs DX, DY, DZ .
|
|
|
|
|
|
|
|
ROT
|
|
|
|
Rotate "ROT"
|
|
|
|
A group or a number of patches is rotated by the given
|
|
angle about the selected axis (X, Y or Z).
|
|
The user may define the origin of rotation.
|
|
|
|
|
|
SCA
|
|
|
|
Scale "SCA"
|
|
|
|
Scale a group or a number of patches.
|
|
The user inputs a scaling factor for the scaling to be
|
|
performed about each axis.
|
|
|
|
A scaling factor of 1.0 means no change of scale.
|
|
Reflections are defined by giving a negative scaling factor.
|
|
|
|
Scaling factors of 0.0 can give erroneous results.
|
|
|
|
EDI
|
|
|
|
Edit "EDI"
|
|
|
|
With this option you get possibilities to manually
|
|
change the 'contents' of a patch. You can change the
|
|
position of a vertex, delete verts, add verts and strips.
|
|
You can change a value (X,Y and/or Z) through a patch/strip.
|
|
You can change surface-normal orientation of a patch/strip.
|
|
|
|
|
|
DEL
|
|
|
|
Delete "DEL"
|
|
|
|
You have four options to choose from:
|
|
1) ALL , all patches are deleted.
|
|
2) Undelete , all deleted patches are recovered.
|
|
3) Group , all patches in the specified group are deleted.
|
|
4) Patch , a or a number off patches is deleted.
|
|
|
|
GRO
|
|
|
|
Group "GRO"
|
|
|
|
This option associates patches so that they may be considered
|
|
as a single entity. You can perform transformations on a group
|
|
as a whole.
|
|
|
|
Patches can only belong to one group.
|
|
|
|
|
|
UNG
|
|
|
|
Ungroup "UNG"
|
|
|
|
|
|
This option is used to remove any associations which exist
|
|
between patches.
|
|
Three options to ungroup are available:
|
|
1) All , all patches are removed from all groups
|
|
in fact they all become member of the default
|
|
group '0'.
|
|
2) Group, You remove patches from a specified group.
|
|
3) Patches, You remove specified patches from their group.
|
|
|
|
|
|
|
|
LIS
|
|
|
|
List "LIS"
|
|
|
|
Lists the vertices and strips in a patch.
|
|
If patch 0 is chosen a short list of patches is shown.
|
|
|
|
|
|
SAV
|
|
|
|
Dump to file "SAV"
|
|
|
|
The contents of the database is outputted to the given file.
|
|
|
|
If the user gives a filename without an file type then the
|
|
default file type of ".VIZ" is supplied, otherwise the name
|
|
given by the user is accepted.
|
|
|
|
For exact definition of legal filenames see -
|
|
"DOS User's Guide".
|
|
|
|
|
|
DRA
|
|
|
|
Draw "DRA"
|
|
|
|
This gives the user 4 options -
|
|
1. Plan (You can 'window-zoom')
|
|
2. XZ Elevation (You can 'window-zoom')
|
|
3. YZ Elevation (You can 'window-zoom')
|
|
4. All 3 views (You canNOT 'window-zoom')
|
|
|
|
The pictures are drawn to the current window parameters
|
|
which may be changed using the "WIN" command.
|
|
|
|
|
|
IDE
|
|
|
|
Identify "IDE"
|
|
|
|
This option helps the user to keep track of the patches in the
|
|
database.
|
|
(You can 'window-zoom')
|
|
A plan view of the database is displayed and the choosen
|
|
patch or group is highlighted (blue).
|
|
|
|
SEA
|
|
|
|
Search "SEA"
|
|
|
|
This option only works with a mouse !!!!!!!
|
|
The entire database is displayed in an axonometric view.
|
|
By pointing to one of the lines of a patch and clicking one
|
|
of the mouse-buttons the patchnumber and stripnumber is
|
|
displayed.
|
|
(You can 'window-zoom')
|
|
|
|
INV
|
|
|
|
Invert "INV"
|
|
|
|
This option reverses the orientation of the surfacenormals
|
|
of all strips in a selected group or number of patches.
|
|
|
|
SET
|
|
|
|
Set colour "SET"
|
|
|
|
Set the default colour of all entities created after this
|
|
command.
|
|
|
|
AXO
|
|
|
|
Axonometric view "AXO"
|
|
|
|
A axonometric view of the whole database is shown using
|
|
a given vector as viewdirection.
|
|
(You can 'window-zoom')
|
|
|
|
CHA
|
|
|
|
Change colour "CHA"
|
|
|
|
You can change the colour of a number of patches or a given
|
|
group.
|
|
|
|
MEN
|
|
|
|
Menu "MEN"
|
|
|
|
A full list of commands available is shown.
|
|
|
|
BOT
|
|
|
|
Bottle "BOT"
|
|
|
|
This is an alternative way to create a solid of revolution.
|
|
Section of this solid are inputted manually and you cannot
|
|
create a toroide using this command.
|
|
|
|
WIN
|
|
|
|
Window "WIN"
|
|
|
|
With this option you generate a 3D-viewport.
|
|
|
|
You can choose to input this window manually,
|
|
or let the program calculate a window around the
|
|
whole database.
|
|
|
|
TOT
|
|
|
|
Totals "TOT"
|
|
|
|
With this choice you see the contents of your database.
|
|
Number of patches, strips and vertices.
|
|
The available memory is also displayed.
|
|
|
|
|
|
QUI
|
|
|
|
Finish "QUI"
|
|
|
|
|
|
Exit the program.
|
|
|
|
If the user selects this option without dumping the database
|
|
to a viewer file then the contents are lost.
|
|
|
|
To avoid the accidental use of this command a confirmation
|
|
is requested by the program.
|