ENVISION commands


PROGRAM NAME

putplot3 - Non-Interactive 3D Plot Display

DESCRIPTION

Putplot3 is a visualization program that displays data as a 3D plot. There are many parameters which control how the plot is displayed. For example the plot type, line type, marker type, surface shade type, plot color, fill color, rotation about X, rotation about Z, and the eye distance may be specified.

When displaying a 3D plot, the plot type can be specified using the [-ptype3d] argument. There are nine valid plot types which are as follows:

"" 1 - Line
2 - Wire Frame
3 - Mesh
4 - Horizon
5 - Scatter
6 - Impulse
7 - Contour 2D
8 - Contour 3D
9 - Constant Shade

A line type can also be specified when displaying 3D plots using the [-ltype3d] argument. There are seven valid line types which are as follows:

"" 1 - Solid
2 - Dotted
3 - Dot Dash
4 - Short Dash
5 - Long Dash
6 - Odd Dashed
7 - Grid Dotted

A marker type can be specified when displaying 3D plots using the [-mtype3d] argument. Note that this only affects the plot when plot type is set to "Scatter." There are sixteen valid marker types which are as follows:

"" 1 - Arc
2 - Bow Tie
3 - Box
4 - Caret
5 - Circle
6 - Cross
7 - Dagger
8 - Diamond
9 - Dot
10 - Hexagon
11 - Point
12 - Square
13 - Triangle
14 - V
15 - X
16 - Pixel

A surface shade type can be specified when displaying 3D plots using the [-stype3d] argument. Note that a surface shade type only applies to 3D plots that are shaded such as Constant Shade, Phone Shade, and Ghouraud Shade. The surface shade type specifies what part of the data is to dictate shading and can be one of three values including:

"" 1 - Imagery
2 - Elevation
3 - Normals

The shade type "Imagery" specifies that shading is to be done on imagery (or color) data. The shade type "Elevation" specifies that shading is to be done on elevation data. The shade type "Normals" specifies that the normal to each data point be computed and that shading be done using these normals.

A plot foreground color can be specified when displaying 3D plots using the [-pcolor3d] argument. Note that the plot color is not used with plot types that are automatically colored such as Color Mesh plots, Contour plots, and Constant Shade plots. The plot color can be any valid color supported on your display. For a list of available colors, run the command % xcolors.

A plot fill color can be specified when displaying 3D plots using the [-fcolor3d] argument. Note that fill color is used with filled 3D plots such as Mesh and Horizon plots. The fill color can be any valid color supported on your display. For a list of available colors, run the command % xcolors.

A value which specifies an X rotation angle can be specified using the [-xrot3d] argument. This value controls how the camera (the eye) is rotated about the X axis. Rotation values are given in degrees ranging from 0 to 360.

A value which specifies an Z rotation angle can be specified using the [-zrot3d] argument. This value controls how the camera (the eye) is rotated about the Z axis. Rotation values are given in degrees ranging from 0 to 360.

A value which specifies the distance between the 3D plot and the eye may be provided using the [-edist3d] argument.

By default, the visualization display will share its colormap with all other applications running at the same time; that is, it does not not use a "private colormap", but rather makes use of the "default colormap". It is possible to specify that the visualization display allocate its own private colormap or "grab" all available colors for its own use. This is done using the [-priv] argument. When [-priv] is specified, moving the mouse pointer into the display window will cause the display to have its private colormap installed; moving the pointer out of the display window will cause the private colormap to be de-installed. This results in the "technoflashing" phenomenon characteristic of private colormap installation.

Color allocation can also be controlled and set to either "read-only" or "read/write" using the [-alloc] argument. When set to "read only", once a color cell has been allocated, it can have its color set only once; from then on, the color cell can be shared by multiple applications, but not changed. If the visualization display requires the color displayed to change, it must re-allocate the color cell, forcing a re-display of data. This can be an expensive procedure. In contrast, after a "read/write" color cell is allocated, it can have its color changed at any time without re-allocation; the data being displayed does not need to be redisplayed, and the color update process is much more efficient. However, the colors used in the visualization display cannot be shared by other applications.

The input file containing the data to be plotted is monitored by default; the file is checked every 2 seconds for change, and if it has been modified, the plot is updated accordingly. The interval at which the input file is checked for modification may be specified using the [-update] argument.

On creation, the plot display window may be placed manually (the default method), or placed automatically. For automatic placement of the plot window, specify the desired location in device (screen) coordinates using the [-x] and [-y] arguments.

While the image display window should be created with a default size that is appropriate to plot the data, a width and height for the window can be specified explicitly using the [-width] and [-height] arguments. Alternatively, you may allow the plot window to size itself initially, and then use the window manager interactively to modify its size as desired.

REQUIRED ARGUMENTS

-i
type: infile
desc: File containing 3D plot

OPTIONAL ARGUMENTS

-ptype3d
type: list
desc: Specifies the plot type for 3D plots
default: 20 "Line"
-ltype3d
type: list
desc: Specifies the line type for 3D plots
default: 1 "Solid"
-mtype3d
type: list
desc: Specifies the marker type for 3D plots
default: 12 "Square "
-stype3d
type: list
desc: Specifies the surface shade type for 3D plots
default: 1 "Imagery"
-pcolor3d
type: string
desc: Specifies the plot color for 3D plots
default: Red
-fcolor3d
type: string
desc: Specifies the fill color for 3D plots
default: Red
-xrot3d
type: float
desc: Specifies the rotation about the X axis
default: 100
bounds: 0 < [-xrot3d] < 360
-zrot3d
type: float
desc: Specifies the rotation about the Z axis
default: 100
bounds: 0 < [-zrot3d] < 360
-edist3d
type: float
desc: Specifies the eye distance
default: 0
bounds: -50 < [-edist3d] < 50
-priv
type: boolean
desc: Use private colormap
default: false
-alloc
type: cycle
desc: Color allocation policy
default: 1 "Read Only"
-x
type: integer
desc: X location for GUI autoplacement
default: -1
bounds: -1 < [-x] < 1000
-width
type: integer
desc: Window width
default: 512
bounds: -1 < [-width] < 1000
-y
type: integer
desc: Y location for GUI autoplacement
default: -1
bounds: -1 < [-y] < 1000
-height
type: integer
desc: Window height
default: 512
bounds: -1 < [-height] < 1000
-update
type: float
desc: How often to check input file for modification
default: 2
bounds: value >= 0.0

EXAMPLES

% putplot3 -i plot3d:flow

SEE ALSO

putdata(1), putplot2(1)

RESTRICTIONS

REFERENCES

COPYRIGHT

Copyright (C) 1993 - 1997, Khoral Research, Inc. ("KRI") All rights reserved.