Files
CydandClaude Fable 5 db7745fcd0 sda4: commit the Glaze developer hard-drive dump
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>
2026-07-04 19:41:15 -05:00

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.