DVbounds


Synopsis

generate a bounding box of a 3D structured field


group DVbounds {
Mesh_Struct+Iparam &in {
ndim+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<weight=-1> => in.xform;
}; /* output field */
method+notify_val+notify_inst upd_bounds = "bounds";
} ;

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.

Files

v/dv.v
modules/bounds.c

Utility DVM macros

DVMbounds_param

Example

Libraries.Main.Mappers.bounds

See also