Rotary Gauge Component - Maple Help

Home : Support : Online Help : Programming : Document Tools : Embedded Components : RotaryGaugeComponent

Rotary Gauge Component

 • The rotary gauge component defines a rotary gauge in a Standard Maple worksheet or document. This component performs an action or a series of actions to communicate with other embedded components when adjusting the needle in the gauge, although assigning an action to a component is not required.
 • To perform an action when the needle is adjusted, right-click (Control-click for Macintosh) the rotary gauge, and then select Edit Value Changed Action to open the Code Editor dialog for the rotary gauge. Enter the commands you want to perform in the Code Editor dialog.
 • You need to specify one or more embedded components that will display the output when adjusting the needle in the gauge. For more information, see the Rotary Gauge Component Example on this page.
 • The rotary gauge component is customized by setting options in the RotaryGauge Properties. To open the RotaryGauge Properties, right-click (Control-click for Macintosh) the rotary gauge, and then select Component Properties. Actions are associated with components using routines in the DocumentTools package.
 • The Name property is used to reference the rotary gauge when using the routines from the DocumentTools package.
 • The Show Axis Label and Show Axis Tick Marks properties displays an axis label and axis tick marks on the rotary gauge respectively when selected.
 • The Update Continuously while Dragging property performs a continuous action on one or more components when selected. The Maple commands in the Action When Value Changes property must be programmed as such to perform this continuous action.
 Image of the Components Palette Item
 Image of an Inserted Rotary Gauge

Rotary Gauge Properties

 • The following table describes the control and use of the rotary gauge component options.
 An x in the G column indicates that the option can be read, that is, retrieved by using the DocumentTools[GetProperty] tool.
 An x in the S column indicates that the option can be written, that is, set by using the DocumentTools[SetProperty] tool.

Option           G  S  Option Type

continuousupdate x  x  true or false
enabled          x  x  true or false
lower            x  x  integer or floating-point number
majorTicks       x  x  positive integer or positive floating-point number
minorTicks       x  x  positive integer or positive floating-point number
pixelHeight      x  x  positive integer
pixelWidth       x  x  positive integer
showLabels       x  x  true or false
showTicks        x  x  true or false
tooltip          x  x  string
upper            x  x  integer or floating-point number
value            x  x  integer or floating-point number
visible          x  x  true or false

 continuousupdate
 Indicates whether the component should update continuously during drag operations. By default, the value is false.
 enabled
 Whether the component is enabled. If enabled is set to true, the thumb can be moved with the mouse. By default, the value is false.
 lower
 The lower bound on the rotary gauge. By default, the value is 0.
 majorTicks
 The interval between the major ticks on the rotary gauge. By default, the value is 20.
 minorTicks
 The interval between the minor ticks on the rotary gauge. By default, the value is 10.
 pixelHeight
 The height of the rotary gauge image in pixels. By default, the value is 128
 pixelWidth
 The width of the rotary gauge image in pixels. By default, the value is 128.
 showLabels
 Indicates if range values are shown. By default, the value is true.
 showTicks
 Indicates if tick marks are shown. By default, the value is true.
 tooltip
 The text that appears when the user hovers the mouse over the component.
 upper
 The upper bound on the rotary gauge. By default, the value is 100.
 value
 The current position of the rotary gauge marker. By default, the value is 0.
 visible
 Specifies if the rotary gauge is visible. By default, the value is true.

Rotary Gauge Component Example

Note: To interact with the examples provided below, open this help page as a worksheet and then execute the worksheet.

This example alters the position of a  Rotary Gauge component by moving Meter and Slider components.

To insert the components:

 1 Type Time(h), Distance(km), and Velocity(km/h) on three separate lines.
 2 Insert a Meter beside Time, a Slider beside Distance, and a Rotary Gauge beside Velocity using the Components palette. For information on displaying the Maple palettes, see the Show Palettes help page.

To set up the range and action for the Meter:

 1 Right-click (Control-click for Macintosh) the Meter component, and then select Component Properties.
 2 Set the following values in the Meter Properties dialog:
 • Value at Lowest Position=1
 • Value at Highest Position=12
 • Current Position=4
 • Spacing of Major Tick Marks=2
 • Spacing of Minor Tick Marks=1
 • Select Enable Input
 • Select Update Continuously While Dragging
 3 Click OK to close the Meter Properties dialog.
 4 Right-click (Control-click for Macintosh) the Meter component, and then select Edit Value Changed Action.

This launches a dialog with preset statements and additional information on how to program actions between embedded components.

 5 Before the end use; statement in the dialog, enter the following commands:

t:=Do(%Meter0);

d:=Do(%Slider0);

v:=d/t;

Do(%RotaryGauge0=v);

Note: Ensure the names of the components are correct (that is, that they match the Name fields for their components).

 6 From the File menu, select Save Code to accept all changes.
 7 From the File menu, select Close Code Editor.

To change the appearance and action of the Slider:

 1 Right-click (Control-click for Macintosh) on the Slider component, and then select Component Properties.
 2 Set the following values in the Slider Properties dialog:
 • Value at Highest Position=1500
 • Current Position =200
 • Spacing of Major Tick Marks=750
 • Spacing of Minor Tick Marks=50
 • Select Show Axis Labels
 • Select Update Continuously While Dragging
 3 Click OK to close the Slider Properties dialog.
 4 Right-click (Control-click for Macintosh) on the Slider component, and then select Edit Value Changed Action.

This launches a dialog with preset statements and additional information on how to program actions between embedded components.

 5 Before the end use; statement in the dialog, enter the following commands:

t:=Do(%Meter0);

d:=Do(%Slider0);

v:=d/t;

Do(%RotaryGauge0=v);

Note: Ensure the names of the components are correct (that is, that they match the Name fields for their components).

 6 From the File menu, select Save Code to accept all changes.
 7 From the File menu, select Close Code Editor.

To change the appearance of the Rotary Gauge:

 1 Right-click (Control-click for Macintosh) on the Rotary Gauge component, and then select Component Properties.
 2 Set the following values in the RotaryGauge Properties dialog:
 • Value at Highest Position=500
 • Spacing of Major Tick Marks=100
 • Spacing of Minor Tick Marks=50
 • Select Update Continuously While Dragging
 3 Click OK to close the RotaryGauge Properties dialog.

Move the needles on the time or distance components and the Rotary Gauge representing velocity will respond.

Time(h)

Distance(km)

Velocity(km/h)

You can verify the syntax of the embedded component action by executing the command in the worksheet.

 > t:=DocumentTools[Do](%Meter0);
 > d:=DocumentTools[Do](%Slider0);
 > v:=d/t;
 > DocumentTools[Do](%RotaryGauge0=v);
 ${t}{:=}{4}$
 ${d}{:=}{200}$
 ${v}{:=}{50}$
 ${50}$ (4.1)