Surface3D Object Class

Surface3D Object

Overview

A Chart Object creates a Plot object of type Surface3D when the chart type resource is set to XintCHART_TYPE_SURFACE_3D. This plot type displays its data as a 3D surface.

Data

The Surface3D class accepts data objects of type Grid or DataSampled. It first looks for a Grid data object, if one is not found, it searches for DataSampled objects. All the DataSampled objects should have the same increment, but can have different starting values (see resource XmNsampledRange to specify a non default start and increment).

Transposition is supported for the case where a Surface3D object displays a set of DataSampled objects. If Chart resource XmNtranspose is False, DataSampled objects are plotted along the X direction. If XmNtranspose it True, DataSampled objects are plotted along the Y direction.

Inherited Behavior and Resources

The Surface3D object class inherits behavior and resources from the Xt Object, Graphic, Group and Plot3D object classes.

The class pointer is xintSurface3DObjectClass.
The class name is XintSurface3D.
The header file is included as <Xint/Surface3D.h>.

The following resources are defined by the Surface3D object class.
Name	Type	Default	Access
XmNcontourLineColor	Pixel	black	CSG
XmNcontourLineMode	int	XintNO_CONTOUR_LINE	CSG
XmNcontourLineThickness	int	1	CSG
XmNfillMode	int	XintCONTOUR_FILL	CSG
XmNmeshColor	Pixel	black	CSG
XmNmeshDrawX	Boolean	True	CSG
XmNmeshDrawY	Boolean	True	CSG
XmNmeshMode	int	XintMONOCHROME_MESH	CSG
XmNmeshLineThickness	int	1	CSG
XmNnumGridX	int	16	CSG
XmNnumGridY	int	16	CSG
XmNnumGridZ	int	16	CSG
XmNsolidSurface	Boolean	False	CSG
XmNsurfaceBottomColor	Pixel	gray	CSG
XmNsurfaceTopColor	Pixel	light grey	CSG

XmNcontourLineColor

Specifies the color used to draw contour lines when resource XmNcontourLineMode is set to XintCONTOUR_LINE.

XmNcontourLineMode

Specifies what type of contour lines to draw. You can use one of the following constants:

Resource Value Description
XintNO_CONTOUR_LINE (default) No contour line is drawn.
XintCONTOUR_LINE Draw the contour lines using color specified in resource XmNcontourLineColor.
XintCONTOUR_COLORED_LINE Draw the contour lines using the color based on the Z value.

Resource Value	Description
XintNO_CONTOUR_LINE (default)	No contour line is drawn.
XintCONTOUR_LINE	Draw the contour lines using color specified in resource XmNcontourLineColor.
XintCONTOUR_COLORED_LINE	Draw the contour lines using the color based on the Z value.

XmNcontourLineThickness

Specifies the line thickness in pixels used to draw the contour lines.

XmNfillMode

Specifies the surface fill mode. You can specify one of the following constants:

Resource Value Description
XintNO_FILL No fill.
XintSHADED_FILL Surface is drawn using two colors. One for the top of the surface (XmNsurfaceTopColor) and one for the bottom of the surface (XmNsurfaceBottomColor).
XintMOSAIC_FILL The surface is filled using a uniform color inside each grid cell. The color used is based on the average Z value for each cell.
XintCONTOUR_FILL The surface is filled along the contour lines. The color used is based on the contour value.

Resource Value	Description
XintNO_FILL	No fill.
XintSHADED_FILL	Surface is drawn using two colors. One for the top of the surface (XmNsurfaceTopColor) and one for the bottom of the surface (XmNsurfaceBottomColor).
XintMOSAIC_FILL	The surface is filled using a uniform color inside each grid cell. The color used is based on the average Z value for each cell.
XintCONTOUR_FILL	The surface is filled along the contour lines. The color used is based on the contour value.

Resource Value	Description
XintNO_MESH	No grid mesh is drawn.
XintCONTOUR_MESH	Grid mesh is drawn using colors based on the Z values.
XintMONOCHROME_MESH (default)	Mesh is drawn with color specified in resource XmNmeshColor.

Plot3D Object Inherited Resources

See section Plot3D Object Class for a complete listing of the inherited resources for the Surface3D object class.

Macro

Macro XintIsSurface3D returns True if the specified object is a Surface3D object.

     Boolean XintIsSurface3D (Object object)