Welcome to the Harris Geospatial product documentation center. Here you will find reference guides, help documents, and product libraries.


Harris Geospatial / Docs Center / IDL Reference / Direct Graphics / CREATE_VIEW Procedure

CREATE_VIEW Procedure

CREATE_VIEW Procedure

The CREATE_VIEW procedure sets the various system variables required to define a coordinate system and a 3-D view. This procedure builds the system viewing matrix (!P.T) in such a way that the correct aspect ratio of the data is maintained even if the display window is not square. CREATE_VIEW also sets the “Data” to “Normal” coordinate conversion factors (!X.S, !Y.S, and !Z.S) so that center of the unit cube will be located at the center of the display window.

CREATE_VIEW sets the following IDL system variables:

!P.T

 

!Y.S

!Z.S

!P.T3D

!X.Style

!Y.Style

!Z.Style

!P.Position     

!X.Range

!Y.Range

!Z.Range

!P.Clip

!X.Margin     

!Y.Margin     

!Z.Margin     

!P.Region

 

 

 

This routine is written in the IDL language. Its source code can be found in the file create_view.pro in the lib subdirectory of the IDL distribution.

Examples


Set up a view to display an iso-surface from volumetric data. First, create some data:

vol = FLTARR(40, 50, 30)
vol(3:36, 3:46, 3:26) = RANDOMU(S, 34, 44, 24) 
FOR I = 0, 10 DO vol = SMOOTH(vol, 3)

Generate the iso-surface.

SHADE_VOLUME, vol, 0.2, polygon_list, vertex_list, /LOW

Set up the view. Note that the subscripts into the Vol array range from 0 to 39 in X, 0 to 49 in Y, and 0 to 29 in Z. As such, the 3-D coordinates of the iso-surface (vertex_list) may have the same range. Set XMIN, YMIN, and ZMIN to zero (the default), and set XMAX=39, YMAX=49, and ZMAX=29.

WINDOW, XSIZE = 600, YSIZE = 400 
CREATE_VIEW, XMAX = 39, YMAX = 49, ZMAX = 29, $
  AX = (-60.0), AZ = (30.0), WINX = 600, WINY = 400, $
  ZOOM = (0.7), PERSP = (1.0)

Display the iso-surface in the specified view.

img = POLYSHADE(polygon_list, vertex_list, /DATA, /T3D) 
TVSCL, img

Syntax


CREATE_VIEW [, AX=value] [, AY=value] [, AZ=value] [, PERSP=value] [, /RADIANS] [, WINX=pixels] [, WINY=pixels] [, XMAX=scalar] [, XMIN=scalar] [, YMAX=scalar] [, YMIN=scalar] [, ZFAC=value] [, ZMAX=scalar] [, ZMIN=scalar] [, ZOOM=scalar or 3-element vector]

Arguments


This procedure has no required arguments.

Keywords


AX

A floating-point value specifying the orientation (X rotation) of the view. The default is 0.0.

AY

A floating-point value specifying the orientation (Y rotation) of the view. The default is 0.0.

AZ

A floating-point value specifying the orientation (Z rotation) of the view. The default is 0.0.

PERSP

A floating-point value specifying the perspective projection distance. A value of 0.0 indicates an isometric projection (NO perspective). The default is 0.0.

RADIANS

Set this keyword if AX, AY, and AZ are specified in radians. The default is degrees.

WINX

A long integer specifying the X size, in pixels, of the window that the view is being set up for. The default is 640.

WINY

A long integer specifying the Y size, in pixels, of the window that the view is being set up for. The default is 512.

XMAX

A scalar specifying the maximum data value on the X axis. The default is 1.0.

XMIN

A scalar specifying the minimum data value on the X axis. The default is 0.0.

YMAX

A scalar specifying the maximum data value on the Y axis. The default is 1.0.

YMIN

A scalar specifying the minimum data value on the Y axis. The default is 0.0.

ZFAC

Set this keyword to a floating-point value to expand or contract the view in the Z dimension. The default is 1.0.

ZMAX

A scalar specifying the maximum data value on the Z axis. The default is 1.0.

ZMIN

A scalar specifying the minimum data value on the Z axis. The default is 0.0.

ZOOM

A floating-point number or 3-element vector specifying the view zoom factor. If zoom is a single value then the view will be zoomed equally in all 3 dimensions. If zoom is a 3-element vector then the view will be scaled zoom[0] in X, zoom[1] in Y, and zoom[2] in Z. The default is 1.0.

Version History


Pre 4.0

Introduced

See Also


SCALE3 Procedure, T3D Procedure



© 2017 Exelis Visual Information Solutions, Inc. |  Legal
My Account    |    Buy    |    Contact Us