TOC PREV NEXT INDEX

DVbounds

Synopsis

generate a bounding box of a 3D structured field

module DVbounds {
Mesh_Struct+Iparam &in {
ndim+req;
dims+req;
xform+nonotify;
};
int+Iparam hull;
int+Iparam edges;
int+Iparam faces;
int+Iparam imin;
int+Iparam imax;
int+Iparam jmin;
int+Iparam jmax;
int+Iparam kmin;
int+Iparam kmax;
int+Iparam data;
int+notify+IPort2 component;
Mesh+Node_Data+Oparam out {
&xform+nowrite => in.xform;
}; /* output field */
method+notify_val+notify_inst upd_bounds<status=1> = "DVbounds_update";
};

Description

DVbounds generates lines and/or surfaces that show the bounding box of a 3D structured field.

Input

&in

The input is a reference to a field with a structured mesh. Mesh_Struct, Mesh_Rect, and Mesh_Unif are all accepted. If you toggle the data input, then the field must also have a Node_Data, but this is not normally required.

hull

An integer. When this is not 0, DVbounds draws a wireframe around the perimeter extents of the input mesh.

edges

An integer. When this is not 0, the imin/imax, jmin/jmax, kmin/kmax buttons will produce a wireframe representation of the mesh grid at that plane.

faces

An integer. When this is not 0, the imin/imax, jmin/jmax, kmin/kmax buttons will produce a solid face representing the location of that plane extent.

imin imax jmin jmax kmin kmax

Integers. When they are not 0, each of these switches displays the grid (edges turned on) or plane (faces turned on) on one of the six faces of the hull. imin produces edges/faces at the i=0 plane. imax produces edges/faces at i=dims[0] - 1. jmin produces edges/faces at the j=0 plane. jmax produces edges/faces at the j=dims[1] - 1 plane. kmin/kmax control the third dimension.

data

An integer. When this is not 0, DVbounds will copy the selected component's Node_Data values at node points along the output mesh to the output field. Because the data is present, the bounds lines can be colored by the interpolated data values of the selected Node_Data component. Otherwise, the lines will display as white.

component

An integer. Sets which component's data values to copy to the output field. A Node_Data must be present in the input field.

Output

out

The output is a new object. Its mesh is an unstructured Mesh with cell type Polyline (edges, first cell set) and/or Quad (faces, second cell set) representing the boundings. Its Node_Data, if present and data was selected, contains the selected component's values at nodes on the output mesh.

Example

Libraries.Main.Mappers.bounds

File

v/dv.v modules/bounds.c Utility DVM macros DVMbounds_param

See also

DVext_edge
DVext_face

TOC PREV NEXT INDEX