Scale Track

The scale track component is a custom gradient aligned to a line or arc. You can use it when building a gauge widget.

To use this component, first you insert it by selecting Insert > Gauge > Scale Track. Then, you configure style and behavior using properties. You can customize the start angle and end angle, the start thickness and end thickness, the gradient, and other properties.

Gradient Customization

To edit the gradient for a scale track, click Track Fill. A dialog opens that includes a track for defining the gradient.

Any time you customize a gradient in DGLux5:

To change a color value, click the small square below the track in the dialog, and then use the color picker.
To add a color to the gradient, click below the track in the dialog.
To delete a color from the gradient, right-click the small square.
Drag colors to move them.

For more information about creating gauges, see Designing Gauges.

For a detailed reference of properties that affect gauge scales, see Common Properties and Gauge Scale Properties.

A gauge with a scale track in DGLux5

Gauge Scale Properties

These properties affect gauge scales. A gauge scale fits into one of three categories, based on whether it has ticks, labels, or a track. Each category has its own properties.

For a guide to using gauges, see Designing Gauges.

Gauges and gauge scales can also be affected using Common Properties.

Scale Ticks Renderer properties

Scale Labels Renderer properties

Scale Track Renderer properties

2019/07/17 19:17

Shared Gauge Scale Properties

These properties affect the shape of any type of gauge scale.

Scale Type

Scale Type
Specifies whether the shape of the scale is defined by a circle or a straight line.

The Scale Type property

Start Angle

Start Angle
Defines the start angle of the circular scale. A value of zero indicates the top of the circle. Valid values are between −180 and 180.

The Start Angle property

End Angle

End Angle
Defines the end angle of the circular scale. A value of zero indicates the top of the circle. Valid values are between −180 and 180.

The End Angle property

Radius

Radius
Defines the radius of the circle that defines the scale, as a percentage of either half the width or half the height of the container, whichever is larger.

The Radius property

Left Padding

Left Padding
Defines the distance between the left side of a linear scale and the container boundary, in pixels. If a border stroke is defined, defines the distance between the scale and the border stroke. See Borders, Padding, and Content Size.

The Left Padding property

Right Padding

Right Padding
Defines the distance between the right side of a linear scale and the container boundary, in pixels. If a border stroke is defined, defines the distance between the scale and the border stroke. See Borders, Padding, and Content Size.

The Right Padding property

2019/07/17 19:17

Gauge Scale Properties

These properties affect gauge scales. A gauge scale fits into one of three categories, based on whether it has ticks, labels, or a track. Each category has its own properties.

For a guide to using gauges, see Designing Gauges.

Gauges and gauge scales can also be affected using Common Properties.

Scale Ticks Renderer properties

Scale Labels Renderer properties

Scale Track Renderer properties

Shared Gauge Scale Properties

These properties affect the shape of any type of gauge scale.

Scale Type

Scale Type
Specifies whether the shape of the scale is defined by a circle or a straight line.

The Scale Type property

Start Angle

Start Angle
Defines the start angle of the circular scale. A value of zero indicates the top of the circle. Valid values are between −180 and 180.

The Start Angle property

End Angle

End Angle
Defines the end angle of the circular scale. A value of zero indicates the top of the circle. Valid values are between −180 and 180.

The End Angle property

Radius

Radius
Defines the radius of the circle that defines the scale, as a percentage of either half the width or half the height of the container, whichever is larger.

The Radius property

Left Padding

Left Padding
Defines the distance between the left side of a linear scale and the container boundary, in pixels. If a border stroke is defined, defines the distance between the scale and the border stroke. See Borders, Padding, and Content Size.

The Left Padding property

Right Padding

Right Padding
Defines the distance between the right side of a linear scale and the container boundary, in pixels. If a border stroke is defined, defines the distance between the scale and the border stroke. See Borders, Padding, and Content Size.

The Right Padding property

Scale Ticks Renderer Properties

These properties affect a scale with ticks.

Ticks Placement

Ticks Placement
Specifies whether the ticks are positioned on the inside, outside, or center of the circle or line that defines the scale.

The Ticks Placement property

Major Tick Count

Major Tick Count
Defines the total number of major ticks along this scale.

The Major Tick Count property

Major Tick Length

Major Ticks Length
Defines the length of each major tick, as a pixel value or a percentage. For circular scales, a percentage is a portion of the circle’s radius. For linear scales, a percentage is a portion of half the container width.

The Major Tick Length property

Major Tick Stroke Color

Defines the stroke color of the major ticks.

The Major Tick Color property

Major Tick Stroke Weight

Major Tick Stroke Weight
Defines the stroke weight of each major tick.

The Major Tick Weight property

Minor Tick Count

Minor Tick Count
Defines the number of minor ticks between each consecutive pair of major ticks.

The Minor Tick Count property

Minor Tick Length

Minor Tick Length
Defines the length of each minor tick, as a pixel value or a percentage. For circular scales, a percentage is a portion of the circle’s radius. For linear scales, a percentage is a portion of half the container width.

The Minor Tick Length property

Minor Tick Stroke Color

Minor Tick Stroke Color
Defines the stroke color of the minor ticks.

The Minor Tick Color property

Minor Tick Stroke Weight

Minor Tick Stroke Weight
Defines the stroke weight of each minor tick.

The Minor Tick Weight property

Scale Labels Renderer Properties

These properties affect a scale with number labels.

Justify

Justify
Specifies whether the labels appear on the inside, outside, or center of the circle or line that defines the scale.

The Justify property

Minimum

Minimum
Defines the lowest number on the scale.

The Minimum property

Maximum

Maximum
Defines the highest number on the scale.

The Maximum property

Labels Count

Labels Count
Defines the total number of labels along this scale. Must be an integer greater than or equal to 2. The Only Min/Max Labels property overrides this property.

The Labels Count property

Only Min/Max Labels

Only Min/Max Labels
Specifies whether the labels for the minimum and maximum of the scale are the only two labels that appear. This property overrides the Labels Count property.

The Only Min/Max Labels property

Format

Format
Defines the number format for scale labels, as a format string.

For example: 

,##0.00: Labels have a thousands separator and two decimal digits. 
000.00: Labels have three mandatory digits before the decimal, and two mandatory digits after the decimal.

For more information about supported formatting options, see Scripting and Syntax.

The Format property

Labels Font

Labels Font
Defines the font used for the labels along this scale. To add a font to this project and use it for this property, see Text Component Properties.

The Font property

Labels Size

Labels Size
Defines the height of the scale numbers, as a pixel value or percentage. For circular scales, a percentage is a portion of the circle's radius. For linear scales, a percentage is a portion of half the container width.

The Labels Size property

Italic

Italic
Defines whether the labels along this scale are italic.

The Italic property

Bold

Bold
Defines whether the labels along this scale are bold.

The Bold property

Underline

Underline
Defines whether the labels along this scale are underlined.

The Underline property

Character Spacing

Character Spacing
Specifies the horizontal spacing between characters in the scale labels, as a pixel value. A null value means the font's default spacing is used.

The Character Spacing property

Scale Track Renderer Properties

These properties affect a scale with a track.

Start Thickness

Start Thickness
Defines the thickness of the scale track at its start, as a pixel or percentage value. For circular scales, a percentage is a portion of the circle’s radius. For linear scales, a percentage is a portion of the entire container width.

The Start Thickness property

End Thickness

End Thickness
Defines the thickness of the scale track at its end, as a pixel or percentage value. For circular scales, a percentage is a portion of the circle’s radius. For linear scales, a percentage is a portion of the entire container width.

The End Thickness property

Track Fill

Track Fill
Defines the colors for the gradient fill for the scale track. To add colors, click below the track in the dialog. To delete colors, right-click on them in the dialog.

The Track Fill property