Track Widget Class

Overview

The Track widget class provides support for the display and editing of graphic objects that comprise a well log track. The Track widget class provides resources for tailoring the look and feel of a well log track.

Complex well log displays are easily created using one or more Track widgets along with a WellLog widget and multiple Axis widgets.

The Track widget class inherits the behavior of the EditObject class. All resources and actions defined in that widget class also are available in the Track widget.

Inherited Behavior and Resources

The Track widget inherits behavior and resources from the Core, Composite, Constraint, Motif Manager and EditObject classes.

The class pointer is xintTrackWidgetClass.
The class name is XintTrack.
The header file is included as <Xint/Track.h>.

The following resources are defined by the Track widget class:
Name	Type	Default	Access
XmNauxAxisCount	int	0	CSG
XmNauxAxisList	Widget *	NULL	CSG
XmNbottom	float *	100.0	CSG
XmNcolor	Pixel	foreground	CSG
XmNdepthAxis	Widget	NULL	CSG
XmNdepthResizePolicy	int	XintRESIZE_FIXED	CSG
XmNdepthScale	float *	5.0	CSG
XmNdepthUnit	int	XintFEET_PER_INCH	CSG
XmNframe	int	XintFRAME	CSG
XmNframeStyle	int	XintFRAME_SOLID	CSG
XmNframeThickness	int	2	CSG
XmNgridBelow	Boolean	True	CSG
XmNhorizontalAxis	Widget	NULL	CSG
XmNhorizontalAuxGrid	Boolean	True	CSG
XmNhorizontalMajorGrid	Boolean	True	CSG
XmNhorizontalMinorGrid	Boolean	False	CSG
XmNtop	float *	0.0	CSG
XmNvaluePercent	int	100	CSG
XmNvalueResizePolicy	int	XintRESIZE_SCALED	CSG
XmNverticalAuxGrid	Boolean	True	CSG
XmNverticalAxis	Widget	NULL	CSG
XmNverticalMajorGrid	Boolean	True	CSG
XmNverticalMinorGrid	Boolean	False	CSG

Resource Value Description
XintRESIZE_NONE The Track widget will not resize in the depth direction.
XintRESIZE_FIXED (default) The Track widget will resize in the depth direction and keep the same scale so that more or less data will be seen.
XintRESIZE_SCALED The Track widget will resize in the depth direction and always display the same amount of data. The depth scale will be adjusted accordingly.

Resource Value	Description
XintRESIZE_NONE	The Track widget will not resize in the depth direction.
XintRESIZE_FIXED (default)	The Track widget will resize in the depth direction and keep the same scale so that more or less data will be seen.
XintRESIZE_SCALED	The Track widget will resize in the depth direction and always display the same amount of data. The depth scale will be adjusted accordingly.

XmNdepthScale

Specifies the scale, in the depth direction, of the Track widget using the unit system specified in resource XmNdepthUnit. This resource only applies if resource XmNdepthAxis is set to NULL at creation time.

XmNdepthUnit

Specifies the unit system used by the Track widget in the depth direction, if resource XmNdepthAxis is NULL at creation time. You can specify one of the following constants:

Resource Value Description
XintINCHES_PER_SECOND The depth scale is specified in inches per second.
XintCM_PER_SECOND The depth scale is specified in centimeters per second.
XintFEET_PER_INCH (default) The depth scale is specified in feet per inch.
XintMETERS_PER_CM The depth scale is specified in meters per centimeter.

Resource Value	Description
XintINCHES_PER_SECOND	The depth scale is specified in inches per second.
XintCM_PER_SECOND	The depth scale is specified in centimeters per second.
XintFEET_PER_INCH (default)	The depth scale is specified in feet per inch.
XintMETERS_PER_CM	The depth scale is specified in meters per centimeter.

XmNframe

Specifies whether a frame or a portion of a frame is drawn inside the widget window. Specify one of the following constants as the value of this resource:

Defined Constant Description
XintFRAME (default) Draws a complete frame inside the widget window.
XintFRAME_NONE No frame will be drawn.
XintFRAME_LEFT Draws the left portion of the frame.
XintFRAME_RIGHT Draws the right portion of the frame.
XintFRAME_TOP Draws the top portion of the frame.
XintFRAME_BOTTOM Draws the bottom portion of the frame.

Defined Constant	Description
XintFRAME (default)	Draws a complete frame inside the widget window.
XintFRAME_NONE	No frame will be drawn.
XintFRAME_LEFT	Draws the left portion of the frame.
XintFRAME_RIGHT	Draws the right portion of the frame.
XintFRAME_TOP	Draws the top portion of the frame.
XintFRAME_BOTTOM	Draws the bottom portion of the frame.

The last four constants can be added together to form various combinations (e.g. specify XintFRAME_TOP + XintFRAME_BOTTOM to have the widget draw the top and bottom portions of the frame).

XmNframeStyle

Specifies the style of line used to draw the Track widget frame. Specify one of the following constants as the value of this resource:

Defined Constant Description
XintFRAME_SOLID (default) Frame is drawn with a solid line.
XintFRAME_DASHED Frame is drawn with a dashed line.
XintFRAME_DOUBLE_DASHED Frame is drawn with a double dashed line.

Defined Constant	Description
XintFRAME_SOLID (default)	Frame is drawn with a solid line.
XintFRAME_DASHED	Frame is drawn with a dashed line.
XintFRAME_DOUBLE_DASHED	Frame is drawn with a double dashed line.

XmNframeThickness

Specifies the width of the line used to draw the Track widget frame.

XmNgridBelow

Specifies whether the grid lines are displayed above or below Graphic objects drawn inside the Track widget.

XmNhorizontalAxis

Specifies a widget of class Axis that defines the Track widget horizontal coordinate system and controls the drawing of horizontal grid lines in the Track viewport window. If this resource is set to NULL, the default coordinate system (from 0 to 100) defined in superclass EditObject will be used.

XmNhorizontalAuxGrid

Specifies whether horizontal auxiliary grid lines from the widget specified in resource XmNhorizontalAxis are drawn or not. Attributes of the line are specified using resources defined in the Axis widget class.

XmNhorizontalMajorGrid

Specifies whether horizontal major grid lines, from the widget specified in resource XmNhorizontalAxis, are drawn or not. Attributes of the line are specified using resources defined in the Axis widget class.

XmNhorizontalMinorGrid

Specifies whether horizontal minor grid lines, from the widget specified in resource XmNhorizontalAxis, are drawn or not. Attributes of the line are specified using resources defined in the Axis widget class.

XmNtop

If resource XmNdepthAxis is NULL at creation time, the Track widget will create a depth Axis automatically. Resource XmNtop specifies the starting value of the Axis widget that will be created. This value represents the top value of the Track.

XmNvaluePercent

Specifies how much of the value Axis widget is visible as a percentage of the track widget's length. A value of 100 means that the entire value Axis widget is visible. A value of 50 means that half of the value space is visible and that the value Axis is scrollable.

XmNvalueResizePolicy

Specifies how a resize of the Track widget in the value direction is handled. You can specify one of the following constants:

Resource Value Description
XintRESIZE_NONE The Track widget will not resize in the value direction.
XintRESIZE_FIXED The Track widget will resize in the value direction and keep the same scale so that more or less data will be seen.
XintRESIZE_SCALED (default) The Track widget will resize in the value direction and always show the same amount of data. The scale will be adjusted accordingly.

Resource Value	Description
XintRESIZE_NONE	The Track widget will not resize in the value direction.
XintRESIZE_FIXED	The Track widget will resize in the value direction and keep the same scale so that more or less data will be seen.
XintRESIZE_SCALED (default)	The Track widget will resize in the value direction and always show the same amount of data. The scale will be adjusted accordingly.

XmNverticalAuxGrid

Specifies whether vertical auxiliary grid lines, from the widget specified in resource XmNverticalAxis, are drawn or not. Attributes of the line are specified using resources defined in the Axis widget class.

XmNverticalAxis

Specifies a widget of class Axis that controls the drawing of vertical grid lines in the VirtualGrid window. If this resource is set to NULL, the default coordinate system (from 0 to 100), defined in superclass EditObject, will be used.

XmNverticalMajorGrid

Specifies whether vertical major grid lines, from the widget specified in resource XmNverticalAxis, are drawn or not. Attributes of the line are specified using the resources defined in the Axis widget class.

XmNverticalMinorGrid

Specifies whether vertical minor grid lines, from the widget specified in resource XmNverticalAxis, are drawn or not. Attributes of the line are specified using the resources defined in the Axis widget class.