LogCurve Object Class

Inherited Behavior and Resources

The LogCurve object class inherits behavior and resources from the Xt Object, Graphic and MultiPoint classes.

The class pointer is xintLogCurveObjectClass.
The class name is XintLogCurve.
The header file is included as <Xint/LogCurve.h>.

The following resources are defined by the LogCurve object class.
Name	Type	Default	Access
XmNaxis	Widget	NULL	CSG
XmNaxisType	int	XintAXIS_LINEAR	CSG
XmNbottom	float *	NULL	CSG
XmNcreateAxis	Boolean	False	CSG
XmNdepthArray	float *	NULL	CSG
XmNfillAttachment	int	XintATTACH_NONE	CSG
XmNfillCurve	Widget	NULL	CSG
XmNfillType	int	XintFILL_ALL	CSG
XmNinterpolationMode	int	XintLINEAR_INTERPOLATION	CSG
XmNnullValue	float *	NULL	CSG
XmNnumBackup	int	0	CSG
XmNreferencePoint	float *	NULL	CSG
XmNregionActive	Boolean	False	CSG
XmNregionEndDepth	float *	NULL	CSG
XmNregionHighlightColor	Pixel	"red"	CSG
XmNregionHighlightThickness	int	3	CSG
XmNregionStartDepth	float *	NULL	CSG
XmNsampleArray	float *	{25, 50, 70}	CSG
XmNsampleCount	int	3	CSG
XmNsampleIncrement	int	1	CSG
XmNtop	float *	NULL	CSG

XmNaxis

Specifies an Axis widget that controls the scrolling and coordinate transformation in the value direction. If this resource is not specified and resource XmNcreateAxis is True, an Axis widget is automatically created, otherwise the parent default coordinate system in the value direction is used. The name of the axis created can be set using inherited resource XmNname (from the Graphic class).

XmNaxisType

Specifies the style of axis to be created if resource XmNcreateAxis is True. Valid choices for this resource are XintAXIS_LINEAR and XintAXIS_LOG.

XmNbottom

Specifies the bottom depth value associated with the first sample in the data array XmNsampleArray. If resource XmNbottom and XmNtop are both specified, the depth array controlled by resource XmNdepthArray is generated automatically.

XmNcreateAxis

Specifies whether or not an Axis widget is created in the value direction. This resource is taken into account only if resource XmNaxis is NULL. If no value axis is specified and this resource is set to False, the default parent coordinate system will be used. When the LogCurve object is destroyed, the created Axis widget will also be destroyed provided that no other objects make reference to it.

XmNdepthArray

Specifies an array of floating point values representing the depth values associated with the data points defined in resource XmNsampleArray. The size of this array must be XmNsampleCount. This array is generated automatically, assuming a constant sample interval, when resources XmNbottom and XmNtop are specified. This resource is set by the application when the LogCurve object contains irregularly sampled data. The depth array is always copied internally, so the application can free its copy after the LogCurve object is created.

XmNfillAttachment

Specifies how to perform the fill operation when the resource XmNfillStyle (from the Graphic class) is set to XintFILL_SOLID, XintFILL_STIPPLED or XintFILL_OPAQUE_STIPPLED. You can specify one of the following constants:

Resource Value Description
XintATTACH_NONE (default) Fill is disabled.
XintATTACH_START Fill is from start of LogCurve value coordinate system to the LogCurve points.
XintATTACH_END Fill is from the LogCurve points to ending value.
XintATTACH_CURVE Fill is between the LogCurve and another LogCurve specified using resource XmNfillCurve.
XintATTACH_REFERENCE_POINT Fill is from a reference value (specified by resource XmNreferencePoint) to the LogCurve points.

XmNfillCurve

Specifies the ID of a LogCurve object to which the fill pattern is clipped when resource XmNfillAttachment is set to XintATTACH_CURVE.

XmNfillType

Specifies where to fill the curve when resource XmNfillAttachment is set to XintATTACH_REFERENCE_POINT. You can specify one of the following constants:

Resource Value Description
XintFILL_ALL (default) Fill curve on both sides of the reference point.
XintPOSITIVE_FILL Fill only part of the curve greater than the reference point.
XintNEGATIVE_FILL Fill only part of the curve smaller than the reference point.

XmNinterpolationMode

Specifies the mode of interpolation used to draw a log curve. Specify XIntLINEAR_INTERPOLATION (default) or XintSTEP_INTERPOLATION to draw blocked curves.

XmNnullValue

Specifies a floating point value that, if found in the sample array, is treated as if no data is present at that location. Visually, lines and symbols become disjointed if a null value is encountered during the LogCurve drawing operation. Null value processing is not performed if the resource is set to NULL.

XmNnumBackup

Specifies if and how many times a curve which has points outside the visible range is allowed to wrap around a track. The scale used for each backup segment is identical to the primary scale. Specify 0 if you don't want a curve to wrap around.

XmNreferencePoint

Specifies a reference value for the fill operation when resource XmNfillAttachment is set to XintATTACH_REFERENCE. This resource must be within the min and max defined by the value coordinate system.

XmNregionActive

Specifies whether the region defined by resources XmNregionStartDepth and XmNregionEndDepth is drawn with the color and size attributes defined in resource XmNregionHighlightColor and XmNregionHighlightThickness.

XmNregionEndDepth

Specifies the ending depth of a subset of the LogCurve object that can be highlighted and edited using a set of special purpose functions.

XmNregionHighlightColor

Specifies the color, as a pixel value, used to draw the region defined by resource XmNregionStartDepth and resource XmNregionEndDepth when resource XmNregionActive is True.

XmNregionHighlightThickness

Specifies the line width used to draw the region defined by resource XmNregionStartDepth and resource XmNregionEndDepth when resource XmNregionActive is True.

XmNregionStartDepth

Specifies the starting depth of a subset of the LogCurve object that can be highlighted and edited using a set of special purpose functions.

XmNsampleArray

Specifies an array of floating point values representing the data values associated with the log curve.The size of this array must be at least as big as the value specified in XmNsampleCount.

XmNsampleCount

Specifies the number of data samples in array XmNsampleArray and array XmNdepthArray if it is not NULL.

XmNsampleIncrement

Specifies that every nth point will be displayed where n is the value of resource XmNsampleIncrement. This resource decimates the amount of data displayed. Note that this resource must be set to 1 when the points are edited, otherwise behavior is undefined. NOTE: This resource does not define the sample interval between points of the log curve. If the LogCurve is regularly sampled, the sample interval is calculated automatically from resources XmNtop, XmNbottom and XmNsampleCount.

XmNtop

Specifies the top depth value associated with the last sample in the data array XmNsampleArray. If resource XmNbottom and XmNtop are both specified, the depth array controlled by resource XmNdepthArray is generated automatically.