Bargraph / instruments #I

Command group to show bar graphs, sliders and rotary / pointer instruments


Bargraph

Place rectangular Bargraph

(Instrument Bar Rectangle)

#IBR

Obj-ID, DrawStyle-Filling, DrawStyle-Background, x, y, Anchor, Width, Height, Radius(0), StartValue(0), EndValue(100), Direction (1), Angle(0)

Place triangular Bargraph

(Instrument Bar Triangle)

#IBT

Obj-ID, DrawStyle-Filling, DrawStyle-Background, x, y, Anchor, Width, Height, Tip(0), StartValue(0), EndValue(100), Direction(1), Angle(0)

Place curved Bargraph

(Instrument Bar Arc)

#IBA

Obj-ID, DrawStyle-Filling, DrawStyle-Background, x, y, Anchor, Radius, Thickness, StartAngle, EndAngle, StartValue(0), EndValue(100), Direction (1)

Slider

Define Slider along path

(Instrument Group Slider)

#IGS

Group-ID, Path-ID, Controller-ID, Tangential(0), StartValue(0), EndValue(100)

Rotary / pointer instruments

Define pointer instrument from objects

(Instrument Group Meter)

#IGM

Group-ID, Indicator-ID, StartAngle, DeltaAngle, StartValue(0), EndValue(100)

Place a instrument from the eDIP series

(Instrument Picture Place)

#IPP

Object-ID, 'InstrumentName'; x, y, Anchor, Width(0), Height(0), StartValue(0), EndValue(100), Angle(0)

Setting Bargraph / instrument

Set value of Bargraph/Instrument

(Instrument Value Set)

#IVS

Obj-ID, Value, Time(0), ActionCurve-No.(0)

Change Start-/End-value of a Bargraph/Instrument

(Instrument Value New)

#IVN

Obj-ID, StartValue, EndValue(no change)

Set Bargraph/Instrument value to calculation value with AutoUpdate

(Instrument Value Autochange)

#IVA

Obj-ID, (Calculation), Time(0), ActionCurve-No.(0)

Change Bargraph/Instrument calculation for AutoUpdate

(Instrument Value Calulation)

#IVC

Obj-ID, (Calculation)


Bargraph

Bargraphs can be used for displaying or for entering values. Please note that after definition (#IBR, #IBT, #IBA), the Bargraph can neither be operated by touch nor does it display a predefined value. To activate it for touch input, you need the command #TID. Values can be set with the #IVS command. The #IVA function is required if the Bargraph should change automatically when changing a calculation value (e.g. analog input, register value, ...). In the following example, a rectangular Bargraph is placed, pre-assigned to the value 30 and activated by touch.

...

#IBR 1,2,1,20,20,7,150,30,10

#IVS 1,30

#TID 1,1

...


Place rectangular Bargraph

#IBR

Obj-ID, DrawStyle-Filling, DrawStyle-Background, x, y, Anchor, Width, Height, Radius(0), StartValue(0), EndValue(100), Direction (1), Angle(0)

The command places a rectangular Bargraph with the Anchor, Width and Height at the position x, y. The filling color is taken from the DrawStyle-Filling. The DrawStyle-Background specifies the background and frame color. The structure of the DrawStyle sub-chapter is explained in more detail. A Radius can optionally be specified. This rounds off the corners. The StartValue and EndValue determine the two limits of the Bargraph. The running direction is determined by Direction:

Direction

0

Right to left

1

Left to right


Rotation around the anchor (Angle) can also be set.


...

#IBR 1,2,1,20,20,7,150,30,10

...


Place triangular Bargraph

#IBT

Obj-ID, DrawStyle-Filling, DrawStyle-Background, x, y, Anchor, Width, Height, Tip(0), StartValue(0), EndValue(100), Direction(1), Angle(0)

The command places a triangular Bargraph with the Anchor, Width and Height at the position x, y. The filling color is taken from the DrawStyle-Filling. The DrawStyle-Background specifies the background and frame color. The structure of the DrawStyle sub-chapter is explained in more detail. The tip is on the left side. The optional parameter Tip specifies the position of the tip:

Tip

0

Bottom

1

Top

2

Middle


StartValue and EndValue determine the two limits of the Bargraph. The running direction is determined by Direction:

Direction

0

Towards tip

1

Away from tip


Rotation around the anchor (Angle) can also be set.


...

#IBT 1,2,1,20,20,7,150,30

...


Place curved Bargraph

#IBA

Obj-ID, DrawStyle-Filling, DrawStyle-Background, x, y, Anchor, Radius, Thickness, StartAngle, EndAngle, StartValue(0), EndValue(100), Direction (1)

The command places a curved Bargraph with the Anchor and given Thickness at the position x, y. The size is determined by the parameters Radius, StartAngle and EndAngle. The filling color is taken from the DrawStyle-Filling. The DrawStyle-Background specifies the background and frame color. The structure of the DrawStyle sub-chapter is explained in more detail. The StartValue and EndValue determine the two limits of the Bargraph. The running direction is determined by Direction:

Direction

0

Counterclockwise

1

Clockwise


Rotation around the anchor (Angle) can also be set.


...

#IBA 1,2,1,20,20,7,100,40,0,180

...


Slider

A slider consists of a path (#GPL, #GPP) and a knob (e.g. #GRR, #PPP, ...). Both objects have to be defined in advance and grouped (#OGA). The start position of the controller (value 0) coincides with the construction point of the path. Nevertheless, it makes sense to position the controller in the right place, since the group limitation (bounding box) does not adapt automatically.

To activate the slider for touch input, you need the command #TID. Values can be set with the #IVS command.

...

#GPL 1,1,20,40,150,40

#GRR 2,2,20,40,4,10,20

#OGA 3,1,2

#IGS 3,1,2

#IVS 3,30

#TID 1,3

...



...

#GPP 1,1,20,40,?E0,100,50,0,200,200

#GRR 2,2,20,40,4,10,20

#OGA 3,1,2

#IGS 3,1,2,1

#IVS 3,60

#TID 1,3

...


Define slider along path

#IGS

Group-ID, Path-ID, Controller-ID, Tangential(0), StartValue(0), EndValue(100)

The command converts an existing group Group-ID into a slider. The group must contain at least two existing objects:


  • A path (#GPL, #GPP) Path-ID
  • A controller (z.B. #GRR, #PPP, ...) Regler-ID


The controller moves along the path:

Tangential

0

Controller does not turn

1

Controller rotates tangentially to the path


StartValue and EndValue determine the two limits of the slider.


Rotary / pointer instruments

A rotary / pointer instrument consists of a background (scale) and a pointer. Both objects have to be defined in advance and grouped together (#OGA). When designing the pointer, make sure that it is positioned in the zero position of the scale. To activate the instrument for touch inputs, the command #TID is required. Values can be set with the #IVS command. With the help of the Meter Editor instruments can be easily created.

...

#PPP 1,<P:picture/Voltmeter.evg>,20,20,7,150,150,0

#PPP 2,<P:picture/Voltmeter_Needle.evg>,66,91,5,6,100,70

#OAO 3,20,2

#OAA 0,2

#OGA 3,1,2

#IGM 3,2,160,-140,0,100

#IVS 3,60

#TID 1,3

...


Alternatively, instruments from the eDIP series can also be placed directly (see #IPP)


Define pointer instrument from objects

#IGM

Group-ID, Indicator-ID, StartAngle, DeltaAngle, StartValue(0), EndValue(100)

The command converts an existing group Group-ID into a pointer instrument. The parameter Indicator-ID determines the pointer. The pointer must be positioned in a way that it points to the value 0. The StartAngle parameter specifies the start angle of the scale. The DeltaAngle determines the direction of rotation (positive: counterclockwise; negative: clockwise) and the total angle of rotation (from the start angle). Optionally, the start and end values (input and output values) can also be specified.


Place a instrument from the eDIP series

#IPP

Object-ID, 'InstrumentName'; x, y, Anchor, Width(0), Height(0), StartValue(0), EndValue(100), Angle(0)

This command is available for compatibility reasons. Finished instruments from the eDIP series, which were created with the LCDTools, can be displayed directly. The instrument must be converted to the * .epi format beforehand using EAconvert.exe. The size is determined by the parameters Width and Height. If width = 0 and height = 0, the original size of the instrument is adopted. If only one of the two parameters is 0, the instrument is adjusted proportionally. Optionally, the start and end values (input and output values) and the rotation around the anchor (Angle) can be specified.

...

#IPP 1,<P:instrument/instrument.epi>,20,20,7,200

...

...

#IPP 1,"instrument";20,20,7,200

...


Setting Bargraph/Instrument


Set value of Bargraph/Instrument

#IVS

Obj-ID, Value, Time(0), ActionCurve-No.(0)

With the command, a bar graph or instrument is set to a new Value. The Time parameter is specified in 1/100s. If the value is positive, the time period is used for the total deflection, meaning a constant speed. A negative value determines the time until the new value is reached. The speed is depending on the distance. The ActionCurve-No. determines the chronological sequence. This is explained in more detail in the subchapter Action Curves and Action Paths.


Change Start-/End-value of a Bargraph/Instrument (from V1.1)

#IVN

Obj-ID, StartValue, EndValue(no change)

The command assigns a new start and / or end value to the Bargraph or instrument.


Set Bargraph/Instrument value to a calculation with AutoUpdate

#IVA

Obj-ID, (Calculation), Time(0), ActionCurve-No.(0)

The value of a Bargraph or instrument is automatically calculated using the Calculation (e.g. analog input, register, calculation) and always changed when its value changes. The Time parameter is specified in 1/100s. If the value is positive, the time period is used for the total deflection, meaning a constant speed. A negative value determines the time until the new value is reached. The speed is depending on the distance. The ActionCurve-No. determines the chronological sequence. This is explained in more detail in the subchapter Action Curves and Action Paths.


Change Bargraph/Instrument calculation for AutoUpdate

#IVC

Obj-ID, (Calculation)

The command changes the Calculation for the AutoUpdate function. Now the value of the Bargraph / instrument is updated whenever the new calculation value changes. However, the old calculation (#IVA) is used for display value.