VPT WF-3D-Viewer Command Line Options

• -v xx     - Set verbosity to level xx.
  Default = 0. Higher values produce more diagnostic printouts.

• -h     - Show summary of these options.

• -soc xx     - Open socket connection for input on socket xx.

• -windowsz_x     - Initial window width.

• -windowsz_y     - Initial window height.

• -aspect_ratio xx     - Aspect ratio.
  Fractional values stretch the scene horizontally. Values greater than 1.0 squeeze the scene horizontally.

• -rwfbd     - Read whole file before display.
  By default, WF3d begins displaying files containing time-based animations while still reading the file(s). It reads several seconds ahead so as to maintain approximately 10 seconds buffer for smooth animation. This avoids a long start-up delay, as file reading can progress during display. However, on slower computers or with detailed animation files, the computer may not be able to maintain sufficient read-buffer while displaying. Forcing read completion before displaying, will cause a longer startup delay, but will restore smooth animation. (Note: This option is also useful for files containing animation commands which are not in time-order, or which are out of order by more than ten seconds.)

• -flt - File Lead Time. Alternative to -rwfbd above, but alters file-look-ahead time from the default 10-seconds. For example, you can specify a greater lead time, such as 40-seconds of look-ahead buffering. Specifying lead times which are greater than all times in the file(s), is equivalent to using -rwfbd.

• -fogdensity xx     - Set fog density. Default = 0.0002.

• -fogoff     - Turn fog off.   Or,
  -nofog

• -fogcolor r g b     - Set fog color.

• -movie     - Produce movie. This option places WF3D into a mode where it captures each frame to an image file for making movies. The image files are numbered sequentially so that any of several movie making tools, such as ppmtompeg, can compress them into .mpeg, .avi, animated .gif, etc.. See: Making Movies from WF-3D for more information about how to make movies.

• -speed xx     - Alter the animation speed by factor xx. Default is 1.0. A value of 2.0 doubles the animation speed, while 0.5 will slow it to half speed. Values greater than one speed up the animation rate. Values less than one slow down animation, or dilate time for slow-motion animations. Any positive non-zero value can be used.

• -camera_speed xx     - Alter the camera panning speed by factor xx. Default is 1.0. A value of 2.0 doubles the camera auto-pan speed, while 0.5 will slow it to half speed. This affects the auto-pan functions, such as s - slow pan around origin, z - zoom toward origin and circle at origin, t - tour around origin looking tangential to tour.

• -camera_min_alt yy     - Restrict camera view-point to be yy units above the ground level (in the Y-axis). When modeling land areas, the camera can be restricted from going below ground level with this option. Where yy becomes the minimum height above the terrain. This option is primarily useful when used with a terrain-elevation surface. The camera view-point can also be restricted with the camera_min_alt XML tag.

• -beam_y_offset xx     - Raise or lower the point that beams are drawn to/from objects (as drawn via the <beam obj1 obj2 ... command). The beam_y_offset value offsets the attachment point in the Y-dimension (usually up/down). The beam command normally draws to an object's defined origin point. However, many designers often tend to define vehicle objects starting at y=0.0 (where the tires meet the road), and work upward from there. If left alone, beams will be drawn to the bottom of the object, and will often be obscured by terrain. Instead, you may wish the beam to be drawn toward the top of the vehicle, where the antenna is. Accomplish this by providing a positive Y offset. This is a global offset.

• -frame_rate_limit xx     - Changes the frame-rate-limit to xx. Normally WinFrame is capable of generating many more frames per second than could possibly be displayed or perceived by humans. For example, on a given computer, WinFrame may be capable of delivering hundreds or thousands of frames per second. Rather than waste computer resources generating excess frames than would not be viewed, WinFrame limits its frame-rate by default to about 45 frames per second. This reduces the total load on the computer and frees it up to do other processing while displaying. You can reduce the frame rate further to free more resources. Limiting below 10 frames per second may perceptibly reduce motion animation smoothness. Raising the limit, causes more computer resources to be devoted to WF3d.