DataObject

Synopsis

a renderable object that contains data plus attributes
DataObject

macro DataObject {
group &in {
GDxform_templ &xform;
method render;
};
Node_Data &texture_in;
Node_Data &texture_col_in;
imlink child_objs;

DefaultMinMax MinMax {
input => in;
};
DefaultDatamap Datamap {
datamap.dataMin => MinMax.min_value;
datamap.dataMax => MinMax.max_value;
};
DefaultProps+OPort Props;
DefaultModes+OPort Modes;
DefaultTexture+OPort Texture {
data => texture_in;
colormap => texture_col_in;
};
DefaultPickInfo+OPort PickInfo;
DefaultObject+OPort Obj {
input => in;
objects => child_objs;
dmap => Datamap;
props => Props;
modes => Modes;
xform => in.xform;
texture => Texture;
pick_info => PickInfo;
};
olink obj => Obj;
};

Description

DataObject is a renderable object that contains the data to be rendered and other subobjects that contain the attributes that control how the data is rendered.

This object is connected directly to one of the Graphics Display Kit viewers (for example, SimpleViewer3D) or to another DataObject or to GroupObject. DataObject is included in most of the macros in the Data Visualization Kit.

DataObject combines the following:

DefaultMinMax to calculate the minimum and maximum values of any node or cell data.

DefaultDatamap to convert scalar node or cell data to RGB color values. By default, the datamap is ranged to the values calculated by DefaultMinMax.

DefaultProps to control color, material, line attributes, and geometrical attributes.

DefaultModes to control point, line, surface, volume, and bounds rendering modes.

DefaultPickInfo to contain information when this object is picked.

DefaultTexture to control the texture mapping attributes.

DefaultObject to control visibility, pickability, caching, transform mode, surface conversion, and image display attributes.

Input

The data to be rendered. This can be any group that includes the following subobjects:

GDxform_templ xform; // Transform.
method render; // Render method

texture_in
texture_col_in

Optional input to the DefaultTexture object. texture_in is the texture-map data. texture_col_in is a colormap, which you include when the texture-map data is byte data rather than RGB.

child_objs

Optionally one or more objects to be children of this object. Multi-level object hierarchies can be built in this manner.

Output Ports

obj

The renderable object that can be connected directly to a Graphics Display Kit viewer.

Example

Any of the modules in Libraries.Main.Filters and Libraries.Main.Mappers

File