Top  | Previous | Next

Linear Scale

Two linear scales<br>
flanking a level indicator

Two linear scales
flanking a level indicator

Description

The linear scale component has two main purposes. The first is to display a series of tick marks and labels that visually represent a linear range between a minimum value and a maximum value. The second purpose is to display indicators that represent a value or range of values, correctly positioned in on the linear scale. In the example above, two linear scales are used to flank a level indicator. The scale on the left has only tick marks, and no indicators. The scale on the right is used to display three indicators and no tick marks.

 

To configure the indicators, you use the Linea Scale's "Scale Indicators" customizer. To configure the tick marks, you use the scale's various properties that determine the minimum value, maximum value, and the various tick mark spans.

Properties

Appearance

Mirror

Mirror the scale so it paints against the opposite edge.

Scripting name

mirror

Data type

boolean

Reverse Range

Reverse the scale so that values go from high to low instead of low to high.

Scripting name

reverseRange

Data type

boolean

Label Angle

Changes the angle that the labels are drawn

Scripting name

labelAngle

Data type

int

Values

0

Right

90

Down

180

Left

270

Up

Margin

The margin to leave blank as a percentage of the total height or width of the scale.

Scripting name

margin

Data type

double

Major Tick Length

The line length for major ticks, in pixels.

Scripting name

majorTickLength

Data type

double

Major Tick Thickness

The line thickness for major ticks, in pixels.

Scripting name

majorTickStroke

Data type

float

Major Tick Color

The line color for major ticks.

Scripting name

majorTickColor

Data type

Color

Label Format

The label format string. Examples: "%.1f" will render numbers like "15.0", "%.0f" will render numbers like "15". Using the empty string "" will disable the labels.

Scripting name

majorTickLabelFormat

Data type

String

Label Font

The font used for drawing tick labels.

Scripting name

majorTickFont

Data type

Font

Label Color

The color used for drawing tick labels.

Scripting name

majorTickLabelColor

Data type

Color

Minor Tick Length

The line length for minor ticks, in pixels.

Scripting name

minorTickLength

Data type

double

Minor Tick Thickness

The line thickness for minor ticks, in pixels

Scripting name

minorTickStroke

Data type

float

Minor Tick Color

The line color for minor ticks.

Scripting name

minorTickColor

Data type

Color

Fine Tick Length

The line length for fine ticks, in pixels.

Scripting name

fineTickLength

Data type

double

Fine Tick Thickness

The line thickness for fine ticks, in pixels

Scripting name

fineTickStroke

Data type

float

Fine Tick Color

The line color for fine ticks.

Scripting name

fineTickColor

Data type

Color

Antialias

Draw with antialias on? Makes text smoother

Scripting name

antialias

Data type

boolean

Flags

expert

Common

Name

The name of this component.

Scripting name

name

Data type

String

Flags

bindable

Visible

If disabled, the component will be hidden.

Scripting name

visible

Data type

boolean

Flags

bindable

Border

The border surrounding this component. NOTE that the border is unaffected by rotation.

Scripting name

border

Data type

Border

Mouseover Text

The text that is displayed in the tooltip which pops up on mouseover of this component.

Scripting name

toolTipText

Data type

String

Cursor

The mouse cursor to use when hovering over this component.

Scripting name

cursorCode

Data type

int

Values

0

Default

1

Crosshair

2

Text

3

Wait

12

Hand

13

Move

4

SW Resize

5

SE Resize

6

NW Resize

7

NE Resize

8

N Resize

9

S Resize

10

W Resize

11

E Resize

Data

Min Value

The lower bound of the scale

Scripting name

minValue

Data type

double

Flags

bindable

Max Value

The upper bound of the scale

Scripting name

maxValue

Data type

double

Flags

bindable

Major Tick Span

The span length for major ticks. Should be a multiple of the minor and fine tick spans.

Scripting name

majorTickSpan

Data type

double

Minor Tick Span

The span length for minor ticks. Should be a factor of the major tick span and a multiple of the fine tick spans. Use zero to disable minor ticks.

Scripting name

minorTickSpan

Data type

double

Fine Tick Span

The span length for fine ticks. Should be a factor of the major and minor tick spans. Use zero to disable fine ticks.

Scripting name

fineTickSpan

Data type

double

Indicators

This dataset stores the indicators (if any) for the scale.

Scripting name

indicators

Data type

Dataset

Data Quality

The data quality code for any tag bindings on this component.

Scripting name

dataQuality

Data type

int

Flags

bindable | expert

Scripting

Events

The following event sets are fired by this component. See Component Event Handlers to learn more.

mouse
mouseMotion
propertyChange

 

Scripting Functions

This component has no special scripting functions.