DVread_vol

Synopsis

read an AVS volume (.dat file) and output an AVS/Express field

group DVread_vol {
string+Iparam filename;
Field_Unif+Dim3+Space3+Scalar+Byte+Oparam out;
method+notify_val+notify_inst upd_read_vol = "read_vol";
} ;

Description

DVread_vol reads an Application Visualization System volume format file (.dat suffix) and converts it into an AVS/Express Field_Unif.

Input

filename

A string. Names the input file to be read as a .dat format file. The string can be either the complete absolute pathname, or a relative pathname. If it is relative, it will be interpreted relative to the user's working directory when AVS/Express was started.

Output

out

The output is a new Field_Unif object containing:

Node_Data

•      nnodes equal to the product of the dims array (X x Y x Z)
•      nnode_data equals 1 (one Data_Array component)

Data_Array

•      nvals equals nnodes
•      veclen equals 1
  values array contains the scalar node values
  primitive data type OM_TYPE_BYTE

Grid_Unif (portions derived from Grid_Struct)

•      ndims equal to 3 (from Dim3)
•      dims array equal to dims[0] = x dim; dims[1] = y dim; dims[2] = z dim
  points array equal to: points[0] = 0.0
  points[1] = 0.0
  points[2] = 0.0
  points[3] = (float) x - 1.0
  points[4] = (float) y - 1.0
  points[5] = (float) z - 1.0

Grid

•      nspace equal Space3

Files

v/dv.v
modules/rd_vol.c

Example

Not available.

See also

• •      DVread_image

 

 




---