Bar3D Object

Overview

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

Data

The Bar3D 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 Bar3D object displays a set of DataSampled objects. If Chart resource XmNtranspose is False, DataSampled objects are plotted along the X direction, with a different color for each data object. If XmNtranspose it True, DataSampled objects are plotted along the Y direction. with a different color for each sample (color is uniform along the Y direction).

Inherited Resources and Behavior

The Bar3D object class inherits behavior and resources from the Xt Object, Graphic, Group and Plot3D object classes.
The following resources are defined by the Bar3D object class.
NameTypeDefaultAccess
XmNbarColorModeintXintCOLOR_LIST_MODECSG
XmNbarLineColorPixel"black"CSG
XmNbarLineThicknessint1CSG
XmNclusterHeightint75CSG
XmNclusterWidthint75CSG
XmNdrawShadowBooleanTrueCSG

XmNbarColorMode

Specifies how to assign the bar colors. You can use one of the following constants:

Resource ValueDescription
XintCOLOR_LIST_MODE (default)Bar color is uniform in the X direction (or Y if transposed) and colors are taken from the list specified in Chart resource XmNcolorList.
XintZ_VALUE_MODEBar color is based on the the Z value and colors are assigned from the colors specified in Chart resource XmNzValueColorRecord.

XmNbarLineColor

Specifies the color pixel used to draw the bar outline.

XmNbarLineThickness

Specifies the bar line thickness in pixels.

XmNclusterHeight

Specifies the size of the bars along the Y direction as a percentage. The resource value must be an integer value between 0 and 100. The difference between the resource value and 100 corresponds to the space left between bars.

XmNclusterWidth

Specifies the size of the bars along the X direction as a percentage. The resource value must be an integer value between 0 and 100. The difference between the resource value and 100 corresponds to the space left between bars.

XmNdrawShadow

Specifies whether or not to draw the side of the bars using a darker color which simulates a shadow.

Plot3D Object Inherited Resources

See Plot3D Object class for a complete listing of the inherited resources for the Bar3D object class.

Macro

Macro XintIsBar3D returns True if the specified object is a Bar3D object. 

     Boolean XintIsBar3D (Object object)