VPT WinFrame-3D-Viewer Operation
Invoking WF-3DIt is helpful to define a convenient alias or shortcut to where you have WF-3D installed on your computer.
For example, in Linux Bash-shell: alias wf3d=/home/bart/tools/wf3d.exe. Then invoke WF3D with your file(s) and/or socket(s) on the command-line.
For example, wf3d geom.dat .
(Microsoft seems to be incapable of using aliases with command-line arguments, so a remedy is to add the WF3D directory to your execution path.)
Basic Usage InstructionsDue to the rich variety of control operations supported, the WinFrame-3D (WF-3D) Viewer is modal - meaning that you must first select a control-mode, and then future mouse and arrow commands are interpreted according to the selected mode - until a new mode is selected.
You can change modes by opening the control panel by clicking the Controls button on the upper-left of the WinFrame display, or by typing keyboard keys defined below. The simple control panel is designed for the most frequently used controls. More options are available from the keyboard list.
The primary modes are also listed on your computer screen when you first invoke WF-3D.
For example, mode (4) will interpret mouse (drag) movements to rotate the camera's view-point (camera's location)
around the camera's last aim-point (often the origin (0,0,0)), much like walking around a museum display.
Mode (6) will rotate the camera's aim-point, much like turning your head, up-down/left-right.
Mode (7) will zoom the camera toward or away from whichever direction it is pointing.
Modes: (Change by pressing number/letter key.) 1. Move camera into scene (zoom) (z and x). 2. Move camera around scene (x and y). 3. Translate camera over scene (xy+aim). 4. Rotate camera about aim-point (constant radius). 5. Move camera's aim-point. (xz). 6. Rotate camera's aim. (y-x/z). 7. Zoom camera to/from pointing direction. 8. Move last-added object (xz). 9. Rotate last-added object (y-axis). s. Start/stop AutoPan - Automatic camera rotation about origin. t. Start/stop AutoTour of outer loop.. z. Start/stop AutoZoom - Automatic zoom toward origin. p. Snap Picture. c. Show Camera Coordinates. e. Show Frame Rate stats. f. Freeze object motions. m. Meta functions. h. Help. q. Quit.Pressing the number or letter shown (with mouse focus in the WF3d window), either puts the viewer in the mode to control the specified attribute or carries out the intended function.
For example, pressing 1 causes left-right arrow presses (or mouse left-right movements) to move the camera position along the Z-axis toward or away from the origin. Pressing 2 causes the arrow keys (or mouse) to move the camera in the X-Y plane. With a little practice, you can become adroit at manipulating the camera's position and pointing direction, around and through a scene.
Other commands, such as p cause a picture to be snapped of the current scene, without altering the pointing mode. Pressing c causes the camera's coordinates to be displayed. This is handy when trying to find a good initial camera setting to place in a file.
The letters s, t, and z put the camera into preplanned trajectories of continuous motion. S Scans around a circular orbit of the origin at whatever radius you position it. You can even change the radius as it scans. T takes the camera on a Tour which follows a similar orbit, but looks ahead in the direction of motion, instead of toward the center. Z Zooms the camera toward the origin, where it begins a slow rotation looking out around the horizon. Pressing any of these letters a second time, stops the camera's motion. Pressing it again resumes it. You can switch smoothly between motions by simply switching between them directly.
Meta Functions: 1. View Angle (FOV) - (Alter by dragging mouse left-right.) 2. Near-Field Limit - (Alter by dragging mouse left-right.) 3. Far-Field Limit - (Alter by dragging mouse left-right.) 4. Toggle Fog On/Off 5. Increase/Decrease Fog by +/- m. Toggle back to non-meta mode.
Some other arcane commands are not listed, such as:
If you are connected to a socket, it will send a tag of the following format to your connected program:
<SelectedObject name=??? x=?? y=?? z=?? />... Where the question marks (?) represent the respective data, being the object's instance-name, and xyz-location.
You will want to go out-of "Identify-Object" mode to move around. Simply type "I" or "i" to toggle out-of, or back into, that mode.
Note - There could be some confusion if your objects were defined at an offset relative to the origin at definition time. For example, suppose an object-type was defined with all its vertices laying in the region 90-100 in X. Then you instantiate the object at 4500 in X. The object origin (original 0.0) will be at 4500, but the object vertices will appear at 4590-4600, due to the defined-in offset. Clicking near 4500 will select the object, because that is the object's assumed center. However, clicking out at 4600 may select another object and create some confusion. Two remedies follow:
You can change your viewing orientation relative to the object, or your viewing distance from the object by the normal mode keys (4) and (7), respectively, and then dragging the mouse.
If while selecting the object, you do not click close enough, then you may need to click again. Pointing accuracy improves as the object is closer to the center of the screen.
While designing 3D objects or scenes, the following features may aid in understanding coordinates and rotation angles, as well as how to find and set the correct values.
See also: WF3d