Download as pdf or txt
Download as pdf or txt
You are on page 1of 120

Programming Guide

MEVInet-Q2 – DataViewer
Control-Reference
Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

Manufacturer IMS Messsysteme GmbH


Dieselstraße 55
42579 Heiligenhaus

Tel.: +49 (0) 2056 / 975-0


Fax: +49 (0) 2056 / 975-140

E-Mail: info@ims-gmbh.de
www.ims-gmbh.de

© IMS Messsysteme GmbH. All rights reserved. This documentation is protected in all
parts by copyright laws. Distribution and reproduction without the prior written authorisation
of IMS Messsysteme GmbH are prohibited. All company and product names used in this
documentation may be registered trademarks.

2/120 Vers.: 28.01.2021 MV_4108_03_en


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

Contents
1 Introduction ...................................................................................................................... 7
1.1 Layout ................................................................................................................................ 7
1.1.1 Properties........................................................................................................................... 7
1.1.2 Methods ............................................................................................................................. 7
1.1.3 Events ................................................................................................................................ 8

2 MultiChart ......................................................................................................................... 9
2.1 Control Elements ............................................................................................................. 11
2.1.1 Axes and Data Scaling .................................................................................................... 11
2.1.1.1 Manual Setting of the Scale in Runtime Mode ................................................................ 11
2.1.1.2 Automatic Setting of the Scale......................................................................................... 12
2.1.1.3 Data Display..................................................................................................................... 12
2.2 Description of Properties, Methods and Events .............................................................. 13
2.2.1 Chart ................................................................................................................................ 13
2.2.2 X-Axis............................................................................................................................... 15
2.2.3 Track ................................................................................................................................ 17
2.2.4 Y-Axis ............................................................................................................................... 21
2.2.5 Z-Axis ............................................................................................................................... 23
2.2.6 Length Profile Diagram (LengthProfile) ........................................................................... 26
2.2.7 Cross Profile Diagram (CrossProfile) .............................................................................. 29
2.2.8 Bar Chart (BarGraph) ...................................................................................................... 32
2.2.9 Horizontal Lines (HorizontalLine) .................................................................................... 36
2.2.10 Vertical Lines (VerticalLine) ............................................................................................. 37
2.2.11 False Colour Diagram (FalseColorPlot) ........................................................................... 38
2.2.12 Scatter diagram (ScatterPlot) .......................................................................................... 43
2.2.13 Digital Signal Diagram (BinaryLengthProfile) .................................................................. 45
2.2.14 Material Defects Diagram (MaterialDefects) .................................................................... 46
2.3 Unit Selection ................................................................................................................... 48
2.4 Display of Warnings ......................................................................................................... 49
2.5 Data Export ...................................................................................................................... 50
2.6 MultiChart and DataViewer in Runtime Mode ................................................................. 51
2.7 MultiChart and DataViewer in Designtime Mode ............................................................. 52
2.7.1 Display of Data Bindings .................................................................................................. 52
2.7.2 Drag & Drop ..................................................................................................................... 53
2.7.3 Long-Term Trends ........................................................................................................... 56

3 IMSChartLegend ............................................................................................................ 57
3.1 Control Elements ............................................................................................................. 57
3.2 Configuration in Designtime Mode .................................................................................. 58
3.3 Description of Properties ................................................................................................. 61

MV_4108_03_en Vers.: 28.01.2021 3/120


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

4 DefectLegend ................................................................................................................. 62
4.1 Control Elements ............................................................................................................. 63
4.2 Configuration in Designtime Mode .................................................................................. 64
4.3 Description of Properties ................................................................................................. 67

5 DefectTable..................................................................................................................... 68
5.1 Control Elements ............................................................................................................. 68
5.2 Configuration in Designtime Mode .................................................................................. 69
5.3 Description of Properties ................................................................................................. 70

6 DefectThumbnailBrowser ............................................................................................. 71
6.1 Control Elements ............................................................................................................. 71
6.2 Configuration in Designtime Mode .................................................................................. 72
6.3 Description of Properties ................................................................................................. 72

7 DefectPictureViewer ...................................................................................................... 73
7.1 Control Elements ............................................................................................................. 74
7.2 Configuration in Designtime Mode .................................................................................. 75
7.3 Description of Properties ................................................................................................. 76

8 SurfaceChart .................................................................................................................. 77
8.1 Control Elements ............................................................................................................. 77
8.2 Configuration in Designtime Mode .................................................................................. 80
8.3 Description of Properties ................................................................................................. 81

9 SurfaceChartLegend ..................................................................................................... 83
9.1 Control Elements ............................................................................................................. 83
9.2 Configuration in Designtime Mode .................................................................................. 84
9.3 Description of Properties ................................................................................................. 84

10 CoilDefectTable .............................................................................................................. 85
10.1 Control Elements ............................................................................................................. 85
10.2 Configuration in Designtime Mode .................................................................................. 86
10.3 Description of Properties ................................................................................................. 87

11 Data Types for Surface Defects ................................................................................... 88

12 CoilDefectControlSelector (CDCSelector) .................................................................. 90


12.1 Control Elements ............................................................................................................. 90
12.2 Configuration in Designtime Mode .................................................................................. 91
12.3 Description of Properties ................................................................................................. 93

13 PictureViewer ................................................................................................................. 94
13.1 Control Elements ............................................................................................................. 95
13.2 Configuration in Designtime Mode .................................................................................. 95
13.3 Description of Properties ................................................................................................. 95

4/120 Vers.: 28.01.2021 MV_4108_03_en


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

14 BarChart.......................................................................................................................... 96
14.1 Control Elements ............................................................................................................. 96
14.2 Configuration in Designtime Mode .................................................................................. 97
14.3 Description of Properties ................................................................................................. 98

15 IMSCP3DChart ............................................................................................................... 99
15.1 Control Elements ............................................................................................................. 99
15.2 Configuration in Designtime Mode ................................................................................ 100
15.3 Description of Properties ............................................................................................... 100

16 ExportTable .................................................................................................................. 102


16.1 Control Elements ........................................................................................................... 102
16.2 Configuration in Designtime Mode ................................................................................ 103
16.3 Description of Properties ............................................................................................... 104

17 TableControl ................................................................................................................. 105


17.1 Control Elements ........................................................................................................... 105
17.2 Configuration in Designtime Mode ................................................................................ 105
17.3 Description of Properties ............................................................................................... 105

18 CoilDataView ................................................................................................................ 106


18.1 Control Elements ........................................................................................................... 107
18.2 Configuration in Designtime Mode ................................................................................ 109
18.3 Description of Properties ............................................................................................... 109

19 FaultPositionTable ....................................................................................................... 110


19.1 Control Elements ........................................................................................................... 110
19.2 Configuration in Designtime Mode ................................................................................ 110
19.3 Description of Properties ............................................................................................... 111

20 StatisticDataPicker ...................................................................................................... 112


20.1 Control Elements ........................................................................................................... 112
20.2 Configuration in Designtime Mode ................................................................................ 113
20.3 Description of Properties ............................................................................................... 114

21 QueryControl ................................................................................................................ 115


21.1 Control Elements ........................................................................................................... 115
21.2 Configuration in Designtime Mode ................................................................................ 116

22 QueryResultTable ........................................................................................................ 117


22.1 Control Elements ........................................................................................................... 117
22.2 Configuration in Designtime Mode ................................................................................ 119
22.3 Description of Properties ............................................................................................... 119

23 BackColorExtender ..................................................................................................... 120


23.1 Control Elements ........................................................................................................... 120

MV_4108_03_en Vers.: 28.01.2021 5/120


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

23.2 Configuration in Designtime Mode ................................................................................ 120


23.3 Description of Properties ............................................................................................... 120

6/120 Vers.: 28.01.2021 MV_4108_03_en


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

1 Introduction

The IMS DataViewer is the central medium for the display, analysis and evaluation of data captured at
various measuring points during production and stored in the long-term storage system (SQL Server).
The data are presented to the user for examination in preconfigured display pages in which important
single measured values and series of measured values are shown by specialised controls.

This guide describes use of the specialised controls. It explains how to create display pages with
specialised controls and corresponding data bindings. It also explains the relevant properties of the
controls. General programming techniques for the DataViewer are explained in the programming guide.

1.1 Layout
The relevant properties, methods and events are always shown in a separate section in tabular form. A
table is always made up according to the following scheme.

1.1.1 Properties
A property is an attribute of a control that defines one of the features of the control, such as size, colour
or screen position, or an aspect of its behaviour or whether it is enabled or visible.

Column Meaning

Property Name of the property

Type Data or object type of the property

S The property can be the source of a data binding (source; source window).

B The property can be the target of a data binding (target; binding editor).

P The property is shown in the properties window.

Description Description of the property.

1.1.2 Methods
A method is an action that can be carried out by a control, e.g. resetting of a control to default values
(Reset()).

Column Meaning

Method Name of the method

The input parameter of a method could be the target of a data binding (target;
Parameters
binding editor). It is possible for a method to have no parameters.

Description Description of the method.

MV_4108_03_en Vers.: 28.01.2021 7/120


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

1.1.3 Events
An event is an action recognised by a control, e.g. mouse click (OnClick) or pressing of a key.

Column Meaning

Event Name of the event.

Description Description of the event.

8/120 Vers.: 28.01.2021 MV_4108_03_en


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

2 MultiChart

The MultiChart is a control for display of various diagrams.


All the diagrams have a common x-axis. The various diagrams can be plotted both in separate plot
areas and one on top of the other in a common plot area. Every plot area can have any number of y-
axes or z-axes.

Figure 1.1: Example with 2 plot areas and various diagrams

Properties and Possibilities

• Any number of plot areas (tracks) can be shown one underneath the other with a common x-
axis.

• Since all the plot areas have a common x-axis, it is not necessary to synchronise the axes,
which would be necessary in the case of single controls.

• The cursor position is synchronised automatically.

• Every plot area can have any number of y-axes and z-axes with or without colour scale.

• Various diagrams can be plotted one on top of the other in one and the same plot area.

• The plot areas are arranged automatically one under the other.

• Texts can be shown in a plot area (PlotAreaText).

• Texts can be shown above every plot area (PlotAreaTitles).

• New diagrams can be added very easily by drag & drop.

• Diagrams can also be added by drag & drop and shown immediately in runtime mode.

• It is possible to switch between US and SI units in runtime mode.

MV_4108_03_en Vers.: 28.01.2021 9/120


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

• It is possible to scale the diagrams to different types of display (deviation from nominal value,
0..100%).

• Display of warnings in the case of faulty configuration or invalid data.

• Display of bindings in DataViewer designtime mode.

Implemented Diagrams

• Length profiles

• Cross profiles

• Bar graphs

• Binary length profiles

• Scatter plots

• Material defects

• Horizontal lines

• Vertical lines

10/120 Vers.: 28.01.2021 MV_4108_03_en


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

2.1 Control Elements


2.1.1 Axes and Data Scaling
The axes can be scaled both manually and automatically. If the scale is changed manually, e.g. by
clicking a button, the axis switches automatically to the manual scale. If the axis is in an automatic
scaling mode, the buttons or sliders are shown in grey. The size of the buttons or sliders is adjusted
automatically to the font size of the axis.

2.1.1.1 Manual Setting of the Scale in Runtime Mode


• Dialogue:
Right-click the control to open the Axis Scale Dialog, with which all axis settings can be
changed and the data of the diagrams exported. When right-clicking the plot area or the x-
axis, the x-axis is pre-selected, and when right-clicking a y-axis or z-axis, the selected axis is
pre-selected.

Figure 2.1
• Buttons
The scale value can be changed by a graduation by clicking the buttons. If the button is kept
pressed, the scale is changed continuously.

• Sliders
The sliders can be used to change a single end scale value, or both scale end values
simultaneously by clicking between the two sliders and then changing the position of both
sliders by dragging with the mouse. With the sliders, it is only possible to set the range of the
scale on at most the last scale values entered. If you wish to enlarge the displayed area, you
must enter corresponding scale values with the dialogue.

• Mouse Wheel
When the mouse pointer is positioned on an axis, it is possible to zoom in or out by turning the
mouse wheel. Only the scale values of the selected axis are changed in this case. If the

MV_4108_03_en Vers.: 28.01.2021 11/120


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

mouse pointer is positioned on the plot area, the scale values of all axes of the plot area and
the x-axis are changed. The zoom steps can be refined by holding the CTRL button.

• Double-Click
A double-click on the axis restores the scale options (AutoScaleMode, ScaleMin, ScaleMax)
set on start. A double-click on the plot area executes the function for all axes of the plot area
and the x-axis.

• ALT Key + Double-Click


If you double-click an axis while pressing the ALT key, the axis switches to the automatic
scale DataMin / DataMax. A double-click on the plot area executes the function for all axes of
the plot area and the x-axis.

• CTRL Key + Mouse Zoom


You can zoom into a diagram by dragging a box in the plot area with the mouse while pressing
the CTRL key.

2.1.1.2 Automatic Setting of the Scale


• Min / Max
The scale is set automatically on the minimum and maximum values of the data contained.

• Database
The scale is set automatically on the values linked with DatabaseScaleMin and
DatabaseScaleMax. This setting can be disabled, and it is then not offered in the dialogue
(DisableDatabaseAutoScaleMode).

• Average +/- 3Sigma


The scale is set automatically on (Average Value - 3 * Standard Deviation) and (Average
Value + 3 * Standard Deviation) of the data contained.

2.1.1.3 Data Display


• Raw Data
The data are shown unchanged.

• Absolute Deviation (Only Y-Axis, Z-Axis)


The respective nominal value is subtracted from the data. This setting can be disabled, and it
is then not offered in the dialogue (DisableDeviationUsage).

• Relative Deviation (Only Y-Axis, Z-Axis)


The data are shown as deviation from the nominal value in percent. This setting can be
disabled, and it is then not offered in the dialogue (DisableDeviationUsage).

• 0 - 100% (Only Y-Axis, Z-Axis)


The data are scaled to the values specified under PercentScalationZero and
PercentScalation100 (properties of the respective diagram). This setting can be disabled, and
it is then not offered in the dialogue (DisableZeroToHundredPercentUsage).

• Data Attached to Zero (Only Y-Axis)


The data are scaled so that the middle of the curve runs through the zero point of the y-axis.
This setting can be disabled, and it is then not offered in the dialogue
(DisableDataAttachedToZeroUsage).

• DataCentered (Only X-Axis)


The data are shown on the x-axis centred around the zero point. This setting can be disabled,
and it is then not offered in the dialogue (DisableDataCenteredUsage).

12/120 Vers.: 28.01.2021 MV_4108_03_en


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

2.2 Description of Properties, Methods and Events


2.2.1 Chart

Property Type S B P Description


EnableRuntimeDragDrop Boolean × Enables adding of data bindings during
runtime.
EnableRuntimeEdit Boolean × × Enables the buttons for editing of properties
during runtime.
MinPlotAreaDistanceLeft Integer × Minimum distance of the plot area(s) from
the left edge of the control in pixels.
MinPlotAreaDistanceRight Integer × Minimum distance of the plot area(s) from
the right edge of the control in pixels.
ShowWarnings Boolean × × × Defines whether warnings are to be shown
during runtime. Warnings can also be
shown/hidden in runtime mode with the
scale dialogue (Options).
CanUndo Boolean × Defines whether restoration is possible.
CanRedo Boolean × Defines whether restoration can be
reversed.
ConfigFileName String × File name of the configuration loaded with
LoadConfig. See also Event
ConfigFilenameChanged.

Method Parameters Description


LoadConfig String defaultExtension Opens a file selection dialogue box and then
loads the selected configuration. All chart settings
are set as defined in the configuration. Saved
bindings are refreshed dynamically during
runtime.
SaveConfig String defaultExtension Opens the dialogue box for saving files. All chart
settings and all bindings added during runtime are
saved.
Reset Resets the chart to its original state (1 track with 1
y-axis).
Undo Restores the chart to its state before the last
change.
Redo Restores the chart to its state before the last
undo.
SuspendRefreshBegi Refreshing of the chart is suppressed until
n SuspendRefreshEnd is called.
SuspendRefreshEnd Cancels suppression of refreshing and initiates
replotting of the chart.

MV_4108_03_en Vers.: 28.01.2021 13/120


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

Event Description
CanUndoChanged Is triggered when the state of CanUndo has changed.
CanRedoChanged Is triggered when the state of CanRedo has changed.
ConfigFilenameChanged Is triggered when a configuration has been loaded with
LoadConfig.
ManualValueCursorChanged Is triggered when the cursor position has been changed with
the mouse. Is not triggered if the cursor position was changed
per control binding or the data have changed.
AfterManualValueCursorChanged Is triggered after ManualValueCursorChanged.
BeforeManualValueCursorChanged Is triggered before ManualValueCursorChanged.

14/120 Vers.: 28.01.2021 MV_4108_03_en


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

2.2.2 X-Axis

XAxis
Property Type S B P Description
AutoScaleMode × DataMinMax:
Automatic scaling to the maximum and
minimum values of the data.
ThreeTimeSigma:
Automatic scaling to the Average Value - 3
* Standard Deviation and Average Value +
3 * Standard Deviation.
Manual:
No automatic scaling, the scale is always
on ScaleMin and ScaleMax.
Database:
Automatic scaling to the values linked with
DatabaseScaleMin and
DatabaseScaleMax.

AutoScaleIgnoreHiddenPlot × In automatic scaling by DataMinMax and


Data ThreeTimeSigma invisible diagrams are not
considered.
DatabaseScaleMin Float × Minimum scale value when the axis is in
Database scaling mode.
DatabaseScaleMinUnit String × Unit of the value linked with
DatabaseScaleMin or entered there.
DatabaseScaleMax Float Maximum scale value when the axis is in
Database scaling mode.
DatabaseScaleMaxUnit String × Unit of the value linked with
DatabaseScaleMax or entered there.
DisableDatabaseAutoScale Boolean × Database scaling is not offered in the scale
Mode dialogue. When automatic scaling on the
basis of database values is not
parameterised, it is possible to remove it
from the scale dialogue with this property.
DisableDataCenteredUsag Boolean × Centred display of the data is not offered in
e the scale dialogue.
DisplayName String × Name displayed
Font Font × Font for the scale label.
Reversed Boolean × The positions of ScaleMin and ScaleMax
are reversed. The minimum scale value is
then shown on the right and the maximum
scale value on the left.
ManualScaleMode × Sliders:
Sliders are shown.
Buttons:
Buttons are shown.
ScaleMin Float × × × Lower end scale value

MV_4108_03_en Vers.: 28.01.2021 15/120


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

Property Type S B P Description


ScaleMax Float × × × Upper end scale value
Text String × Axis label. The following placeholders can
be used here:

@DIM@
This placeholder is replaced by the current
unit of the axis.
@UNIT@
This placeholder is replaced by the current
unit of the axis.
@NAME@
This placeholder is replaced by the
DisplayName of the axis.
UnitSI String × Unit of the axis when the chart is to show SI
units.
UnitUS String × Unit of the axis when the chart is to show
US units.
Usage × RawData:
Absolute display of the data.
DataCentered:
The data are shown centred around the
zero point.
Visible Boolean × Axis visible or invisible.

Event Description
ScaleChanged Is triggered when the scale of axis has changed.

16/120 Vers.: 28.01.2021 MV_4108_03_en


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

2.2.3 Track
Tracks[n]
Property Type S B P Description
BackColor Color × Background colour
BorderColor Color × Border colour
BorderWidth Integer × Border width in pixels
DisplayName String × Name displayed

Tracks[n].PlotAreaText
Property Type S B P Description
BackColor Color × Background colour
Font Font × Font
ForeColor Color × Text colour
TextBottomCenter String × Text in the plot area, bottom centre. The
following identifiers can be used as
placeholders for the current unit of an axis:
@DIMX@, @DIMY1@, @DIMY2@...,
@DIMZ1@, @DIMZ2@...
TextBottomLeft String × Text in the plot area, bottom left. The
following identifiers can be used as
placeholders for the current unit of an axis:
@DIMX@, @DIMY1@, @DIMY2@...,
@DIMZ1@, @DIMZ2@...
TextBottomRight String × Text in the plot area, bottom right. The
following identifiers can be used as
placeholders for the current unit of an axis:
@DIMX@, @DIMY1@, @DIMY2@...,
@DIMZ1@, @DIMZ2@...
TextTopCenter String × Text in the plot area, top centre. The
following identifiers can be used as
placeholders for the current unit of an axis:
@DIMX@, @DIMY1@, @DIMY2@...,
@DIMZ1@, @DIMZ2@...
TextTopLeft String × Text in the plot area, top left. The following
identifiers can be used as placeholders for
the current unit of an axis: @DIMX@,
@DIMY1@, @DIMY2@..., @DIMZ1@,
@DIMZ2@...
TextTopRight String × Text in the plot area, top right. The following
identifiers can be used as placeholders for
the current unit of an axis: @DIMX@,
@DIMY1@, @DIMY2@..., @DIMZ1@,
@DIMZ2@...

Tracks[n].PlotAreaTitles
Property Type S B P Description
BackColor Color × Background colour

MV_4108_03_en Vers.: 28.01.2021 17/120


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

Font Font × Font


ForeColor Color × Text colour
TextCenter String × Text above the plot area, centre.
The following identifiers can be used as
placeholders for the current unit of an axis:
@DIMX@, @DIMY1@, @DIMY2@...,
@DIMZ1@, @DIMZ2@...
TextLeft String Text above the plot area, left.
The following identifiers can be used as
placeholders for the current unit of an axis:
@DIMX@, @DIMY1@, @DIMY2@...,
@DIMZ1@, @DIMZ2@...
TextRight String Text above the plot area, right.
The following identifiers can be used as
placeholders for the current unit of an axis:
@DIMX@, @DIMY1@, @DIMY2@...,
@DIMZ1@, @DIMZ2@...

Layout of the texts PlotAreaText and PlotAreaTitle

18/120 Vers.: 28.01.2021 MV_4108_03_en


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

Tracks[n].ValueCursor
Property Type S B P Description
FillColor Color × Fill colour of the rectangle when
Style=LassoRectangle
ForeColor Font × Colour of the cursor line or border colour of
the cursor rectangle.
Style × VerticalLine:
The cursor is a vertical line.

VerticalLineSnap:
The cursor is a vertical line that is
positioned automatically and exactly on the
closest data point.

LassoRectangle:
The cursor is a rectangle that can be
positioned by dragging with the mouse.

CrossHairs:
The cursor is a cross hairs that can be
positioned with the mouse.
Visible Boolean × × Defines whether the cursor is to be shown.
SelectionXMax Float × Maximum position of the cursor rectangle
on the x-axis, in the current unit of the x-
axis.
SelectionXMin Float × Minimum position of the cursor rectangle on
the x-axis, in the current unit of the x-axis.
SelectionYMax Float × Maximum position of the cursor rectangle
on the 1st y-axis, in the current unit of the
1st y-axis.
SelectionYMin Float × Minimum position of the cursor rectangle on
the 1st y-axis, in the current unit of the 1st
y-axis.
X Float × × Cursor position on the x-axis, in the current
unit of the x-axis.
XUnit String × Current unit of the x-axis.
XPos Float × × Cursor position in the unit defined under
XPosUnit.
XPosUnit String × Unit in which XPos, XPosMin and XPosMax
are given.
XPosMin Float × Cursor position (LassoRectangle) in the unit
defined under XPosUnit.
XPosMax Float × Cursor position (LassoRectangle) in the unit
defined under XPosUnit.
Y Float × × Cursor position of the horizontal line
(CrossHairs) in the unit of the 1st y-axis.

MV_4108_03_en Vers.: 28.01.2021 19/120


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

Property Type S B P Description


YPos Float × × Cursor position of the horizontal line
(CrossHairs) in the unit defined under
YPosUnit.
YPosUnit String × Unit in which YPosMin and YPosMax are
given.
YUnit String × Current unit of the cursor position of the
horizontal line (CrossHairs)
YPosMin Float × Cursor position (LassoRectangle) in the unit
defined under YPosUnit.
YPosMax Float × Cursor position (LassoRectangle) in the unit
defined under YPosUnit.

Event Description
SelectionChanged Is triggered when the cursor position has changed or the data have
been refreshed.
AfterSelectionChanged Is triggered after SelectionChanged.
BeforeSelectionChanged Is triggered before SelectionChanged.
ManualSelectionChanged Is triggered when the cursor position has been changed with the
mouse. Is not triggered if the cursor position was changed, for
example, per control binding or the data have changed.

Method Parameters Type Description


SetVerticalLineCursorPosition xPos Float This method is used to set the position of
xUnit String the VerticalLine cursor.
SetCrossHairsCursorPosition xPos Float This method is used to set the position of
xUnit String the CrossHairs cursor.
yPos Float
yUnit String
SetLassoCursorPosition x1Pos Float This method is used to set the position of
y1Pos Float the Lasso cursor.
x2Pos Float
y2Pos Float
xUnit string
yUnit string

20/120 Vers.: 28.01.2021 MV_4108_03_en


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

2.2.4 Y-Axis

Tracks[n].YAxis[n]
Property Type S B P Description
AutoScaleMode × DataMinMax:
Automatic scaling to the maximum and
minimum values of the data.
ThreeTimeSigma:
Automatic scaling to the Average Value - 3
* Standard Deviation and Average Value +
3 * Standard Deviation.
Manual:
No automatic scaling, the scale is always
on ScaleMin and ScaleMax.
Database:
Automatic scaling to the values linked with
DatabaseScaleMin and
DatabaseScaleMax.
AutoScaleIgnoreHiddenPlot × In automatic scaling by DataMinMax and
Data ThreeTimeSigma invisible diagrams are not
considered.
DatabaseScaleMin Float × Minimum scale value when the axis is in
Database scaling mode.
DatabaseScaleMinUnit String × Unit of the value linked with
DatabaseScaleMin or entered there.
DatabaseScaleMax Float × Maximum scale value when the axis is in
Database scaling mode.
DatabaseScaleMaxUnit String × Unit of the value linked with
DatabaseScaleMax or entered there.
DisableDataAttachedToZer × Display mode Data Attached to Zero is not
oUsage offered in the scale dialogue.
DisableDatabaseAutoScale Boolean × Database scaling is not offered in the scale
Mode dialogue. When automatic scaling on the
basis of database values is not
parameterised, it is possible to remove it
from the scale dialogue with this property.
DisableDeviationUsage Boolean × The display modes Absolute Deviation and
Relative Deviation are not offered in the
scale dialogue.
DisableZeroToHundredPer Boolean × The display mode 0-100% is not offered in
centUsage the scale dialogue.
DisplayName String × Name displayed
Font Font × Font for the scale label.
Position × Right:
The axis is shown on the right.
Left:
The axis is shown on the left.

MV_4108_03_en Vers.: 28.01.2021 21/120


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

Property Type S B P Description


Reversed Boolean × The positions of ScaleMin and ScaleMax
are reversed. The minimum scale value is
then shown at the top and the maximum
scale value at the bottom.
ManualScaleMode × Sliders:
Sliders are shown.
Buttons:
Buttons are shown.
ScaleMin Float × × × Lower end scale value
ScaleMax Float × × × Upper end scale value
ShowNominal Boolean × In the display modes Absolute Deviation
and Relative Deviation, the nominal value is
shown at the scale instead of zero.
Text String × Axis label. The following placeholders can
be used here:

@DIM@
This placeholder is replaced by the current
unit of the axis.
@UNIT@
This placeholder is replaced by the current
unit of the axis.
@NAME@
This placeholder is replaced by the
DisplayName of the axis.
UnitSI String × Unit of the axis when the chart is to show SI
units.
UnitUS String × Unit of the axis when the chart is to show
US units.
Usage × RawData:
Absolute display of the data.
AbsoluteDeviation:
The data are shown as deviation from the
nominal value.

RelativeDeviation
The data are shown as deviation from the
nominal value in percent.
ZeroToHundredPercent:
The data are scaled to 0 to 100 as defined
at PercentScalationZero and
PercentScalation100 (properties of the
respective diagram).
Visible Boolean × Axis visible or invisible.

Event Description
ScaleChanged Is triggered when the scale of axis has changed.

22/120 Vers.: 28.01.2021 MV_4108_03_en


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

2.2.5 Z-Axis

Tracks[n].ZAxis[n]
Property Type S B P Description
AutoScaleMode × DataMinMax:
Automatic scaling to the maximum and
minimum values of the data.
ThreeTimeSigma:
Automatic scaling to the Average Value - 3
* Standard Deviation and Average Value +
3 * Standard Deviation.
Manual:
No automatic scaling, the scale is always
on ScaleMin and ScaleMax.
Database:
Automatic scaling to the values linked with
DatabaseScaleMin and
DatabaseScaleMax.
AutoScaleIgnoreHiddenPlot × In automatic scaling by DataMinMax and
Data ThreeTimeSigma invisible diagrams are not
considered.
DatabaseScaleMin Float × Minimum scale value when the axis is in
Database scaling mode.
DatabaseScaleMinUnit String × Unit of the value linked with
DatabaseScaleMin or entered there.
DatabaseScaleMax Float × Maximum scale value when the axis is in
Database scaling mode.
DatabaseScaleMaxUnit String × Unit of the value linked with
DatabaseScaleMax or entered there.
DisableDatabaseAutoScale Boolean × Database scaling is not offered in the scale
Mode dialogue. When automatic scaling on the
basis of database values is not
parameterised, it is possible to remove it
from the scale dialogue with this property.
DisableDeviationUsage Boolean × The display modes Absolute Deviation and
Relative Deviation are not offered in the
scale dialogue.
DisableZeroToHundredPer Boolean × The display mode 0-100% is not offered in
centUsage the scale dialogue.
DisplayName String × Name displayed
Font Font × Font for the scale label.
Position × Right:
The axis is shown on the right.
Left:
The axis is shown on the left.

MV_4108_03_en Vers.: 28.01.2021 23/120


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

Property Type S B P Description


Reversed Boolean × The positions of ScaleMin and ScaleMax
are reversed. The minimum scale value is
then shown at the top and the maximum
scale value at the bottom.
ManualScaleMode × Sliders:
Sliders are shown.
Buttons:
Buttons are shown.
ScaleMin Float × × × Lower end scale value
ScaleMax Float × × × Upper end scale value
ShowNominal Boolean × In the display modes Absolute Deviation
and Relative Deviation, the nominal value is
shown at the scale instead of zero.
ColorList List of the colours in the colour scale.
ShowColorScale Boolean × Colour scale is shown.
ColorInterpolation Full:
Linear colour gradient.

None:
No colour gradient, the colours are shown
in fixed segments.
Text String × Axis label. The following placeholders can
be used here:

@DIM@
This placeholder is replaced by the current
unit of the axis.
@UNIT@
This placeholder is replaced by the current
unit of the axis.
@NAME@
This placeholder is replaced by the
DisplayName of the axis.
UnitSI String × Unit of the axis when the chart is to show SI
units.
UnitUS String × Unit of the axis when the chart is to show
US units.

24/120 Vers.: 28.01.2021 MV_4108_03_en


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

Property Type S B P Description


Usage × RawData:
Absolute display of the data.
AbsoluteDeviation:
The data are shown as deviation from the
nominal value.

RelativeDeviation
The data are shown as deviation from the
nominal value in percent.
ZeroToHundredPercent:
The data are scaled to 0 to 100 as defined
at PercentScalationZero and
PercentScalation100 (properties of the
respective diagram).
Visible Boolean × Axis visible or invisible.

Event Description
ScaleChanged Is triggered when the scale of axis has changed.

Method Parameters Type Description


SetColors colors Color[] This method is used to set the colours of the
colour scale.

MV_4108_03_en Vers.: 28.01.2021 25/120


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

2.2.6 Length Profile Diagram (LengthProfile)

Figure 3.1 Example of a length profile diagram

Tracks[n].PlotData.LengthProfile[n]
Property Type S B P Description
DataCompression × Sets the mode of data compression. In the
case of length profiles with very many data
points (> 5000) it is possible to improve the
performance of the display considerably by
reducing the data volume before it is
displayed. This optimisation is only effective
in the case of equidistant data.

None:
No compression

Auto:
Automatic compression
DataReductionMethod × × Min:
If there are more than one data points at a
pixel, only the lowest is plotted.
Avg:
If there are more than one data points at a
pixel, the average of these data points is
plotted.
Max:
If there are more than one data points at a
pixel, only the highest is plotted.
DisplayName String × Name displayed. This name is shown, for
example, in the legend control.
LineColor Color × × Line colour

26/120 Vers.: 28.01.2021 MV_4108_03_en


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

Property Type S B P Description


Linestyle × Line style
Solid
Dash
DashDot
Dot
DashDotDot
LineWidth Integer × Line width in pixels
NominalValue Float × × Nominal value
This value is needed for the display modes
Absolute Deviation and Relative Deviation.
NominalValueUnit String × Unit of the value given at NominalValue.
PercentScalation100 Float × × This value corresponds to 100 percent in
display mode 0..100%.
PercentScalation100Unit String × Unit of the value given at
PercentScalation100.
PercentScalationZero Float × × This value corresponds to 0 percent in
display mode 0..100%.
PercentScalationZeroUnit String × Unit of the value given at
PercentScalationZero.
ShowInLegend Boolean × Defines whether this diagram is to be
shown in the legend control.
SymbolColor Color × Colour of the data point symbol.
SymbolSize Integer × Size of the data point symbol in pixels.
SymbolStyle × Style of the data point symbol.
No symbol None
Dot

Box
Triangle

Diamond

Cross

DiagCross
UnitX String × Unit of the data in x-direction
UnitY String × Unit of the data in y-direction
Value Object × × Display data

Valid data types:


CrossProfile
LengthProfile
float[n]
float[2, n]
float[2][n]
PointF[]

MV_4108_03_en Vers.: 28.01.2021 27/120


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

Property Type S B P Description


Visible Boolean × × × Defines whether the diagram is to be
shown.
XOffset Float × × × The diagram can be moved in x-direction
with this property.
XOffsetUnit String × × Unit of the value given at XOffset.
XReversed Boolean × × × Turns the display on the x-axis.
YAxisName String × The name of the y-axis assigned to this
diagram.
CursorValueYAbsoluteDevi Float × Absolute deviation from the nominal value
ationConverted at the current cursor position. The value is
given in the current unit of the y-axis.
CursorValueYAbsoluteDevi Float × Absolute deviation from the nominal value
ationRaw at the current cursor position. The value is
given in the unit of the data.
CursorValueYConverted Float × Y-value of the data at the current cursor
position. The value is given in the current
unit of the axis.
CursorValueYRaw Float × Y-value of the data at the current cursor
position. The value is given in the unit of the
data.
CursorValueYRelativeDevi Float × Relative deviation from the nominal value at
ation the current cursor position.
ValueX Float × Current cursor position on the x-axis. The
value is given in the unit defined under
ValueXUnit.
ValueXUnit String × Unit in which ValueX is available.
ValueYDisplayed Float × Y-value at the current cursor position in axis
units. This takes both unit selection and the
current selected data display (deviation
from nominal value etc.) into consideration.
Tag Object × Contains the dataset index in a display of
trends (All As XY Pairs).

28/120 Vers.: 28.01.2021 MV_4108_03_en


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

2.2.7 Cross Profile Diagram (CrossProfile)

Figure 3.2 Example of a cross profile diagram

Tracks[n].PlotData.CrossProfile[n]
Property Type S B P Description
DisplayName String × Name displayed. This name is shown, for
example, in the legend control.
HoleValue Float × If the data contain the value given here, this
data point is not shown and the line is
broken.
LineColor Color × × Line colour
Linestyle × Line style
Solid
Dash
DashDot
Dot
DashDotDot
LineWidth Integer × Line width in pixels
NominalValue Float × × Nominal value
This value is needed for the display modes
Absolute Deviation and Relative Deviation.
NominalValueUnit String × Unit of the value given at NominalValue.
PercentScalation100 Float × × This value corresponds to 100 percent in
display mode 0..100%.
PercentScalation100Unit String × Unit of the value given at
PercentScalation100.
PercentScalationZero Float × × This value corresponds to 0 percent in
display mode 0..100%.

MV_4108_03_en Vers.: 28.01.2021 29/120


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

Property Type S B P Description


PercentScalationZeroUnit String × Unit of the value given at
PercentScalationZero.
ProfileSelectionMethod × Defines how the single cross profile is
selected from the array.
First:
The first profile from the cross profile array
is shown.
ByIndex:
The profile defined under ProfileAtIndex is
shown from the cross profile array.
ByPosition:
The profile lying at the position defined
under ProfileAtPosition is shown from the
cross profile array.
ProfileAtIndex Integer × × × Index of the single cross profile in the cross
profile array.
ProfileAtPosition Float × × × Single cross profile at this position.
ProfileCount Integer × Number of individual cross profiles.
RelatedPlotData × The diagram can be assigned to another
diagram so that the position in Data
Attached to Zero display mode in
comparison to the other diagram is
retained.
ShowInLegend Boolean × × × Defines whether this diagram is to be
shown in the legend control.
SymbolColor Color × Colour of the data point symbol.
SymbolSize Integer × Size of the data point symbol in pixels.
SymbolStyle × Style of the data point symbol.
No symbol None
Dot

Box
Triangle

Diamond

Cross

DiagCross
UnitX String × Unit of the data in x-direction
UnitY String × Unit of the data in y-direction

30/120 Vers.: 28.01.2021 MV_4108_03_en


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

Property Type S B P Description


Value Object × Display data

Valid data types:


CrossProfile
LengthProfile
float[n]
float[2, n]
float[2][n]
PointF[]
Visible Boolean × × × Defines whether the diagram is to be
shown.
XOffset Float × × × The diagram can be moved in x-direction
with this property.
XOffsetUnit String × Unit of the value given at XOffset.
XReversed Boolean × × × Turns the display on the x-axis.
YAxisName String × The name of the y-axis assigned to this
diagram.
CursorValueYAbsoluteDevi Float × Absolute deviation from the nominal value
ationConverted at the current cursor position. The value is
given in the current unit of the y-axis.
CursorValueYAbsoluteDevi Float × Absolute deviation from the nominal value
ationRaw at the current cursor position. The value is
given in the unit of the data.
CursorValueYConverted Float × Y-value of the data at the current cursor
position. The value is given in the current
unit of the axis.
CursorValueYRaw Float × Y-value of the data at the current cursor
position. The value is given in the unit of the
data.
ValueX Float × Current cursor position on the x-axis. The
value is given in the unit defined under
ValueXUnit.
ValueXUnit String × Unit in which ValueX is available.
ValueYDisplayed Float × Y-value at the current cursor position in axis
units. This takes both unit selection and the
current selected data display (deviation
from nominal value etc.) into consideration.
Tag Object × Contains the dataset index in a display of
trends (All As XY Pairs).

MV_4108_03_en Vers.: 28.01.2021 31/120


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

2.2.8 Bar Chart (BarGraph)

Figure 3.3 Example of a bar chart

32/120 Vers.: 28.01.2021 MV_4108_03_en


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

Tracks[n].PlotData.BarGraphs[n]
Property Type S B P Description
BarDisplayMode × Defines how the width of the individual bars
is determined.

AutoWidth:
The gaps between the individual data
points are filled completely with the bar.

AutoWidthSymetric:
If the distances between the data points are
not equidistant, the bar is plotted with the
smaller width.

TwoPointsPerBar:
A bar is determined by 2 points.

Area:
The complete area underneath the data
points is filled.

DisplayName String × Name displayed. This name is shown, for


example, in the legend control.
FillColor Color × × × Fill colour of the bar

MV_4108_03_en Vers.: 28.01.2021 33/120


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

Property Type S B P Description


FillStyle × Solid:
The bars are filled with the FillColor.
DiagonalHatch:
The bars are hatched with the FillColor.
HoleValue Float × If the data contain the value given here, this
data point is not shown and the line is
broken.
NominalValue Float × × Nominal value
This value is needed for the display modes
Absolute Deviation and Relative Deviation.
NominalValueUnit String × Unit of the value given at NominalValue.
PercentScalation100 Float × × This value corresponds to 100 percent in
display mode 0..100%.
PercentScalation100Unit String × Unit of the value given at
PercentScalation100.
PercentScalationZero Float × × This value corresponds to 0 percent in
display mode 0..100%.
PercentScalationZeroUnit String × Unit of the value given at
PercentScalationZero.
ProfileSelectionMethod × Defines how the single cross profile is
selected from the array.
First:
The first profile from the cross profile array
is shown.
ByIndex:
The profile defined under ProfileAtIndex is
shown from the cross profile array.
ByPosition:
The profile lying at the position defined
under ProfileAtPosition is shown from the
cross profile array.
ProfileAtIndex Integer × × × Index of the single cross profile in the cross
profile array.
ProfileAtPosition Float × × × Single cross profile at this position.
ProfileCount Integer × Number of individual cross profiles.
RelatedPlotData × The diagram can be assigned to another
diagram so that the position in Data
Attached to Zero display mode in
comparison to the other diagram is
retained.
ShowInLegend Boolean × Defines whether this diagram is to be
shown in the legend control.
UnitX String × Unit of the data in x-direction
UnitY String × Unit of the data in y-direction
Visible Boolean × × × Defines whether the diagram is to be
shown.

34/120 Vers.: 28.01.2021 MV_4108_03_en


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

Property Type S B P Description


XOffset Float × × × The diagram can be moved in x-direction
with this property.
XOffsetUnit String × × Unit of the value given at XOffset.
XReversed Boolean × × × Turns the display on the x-axis.
YAxisName String × The name of the y-axis assigned to this
diagram.
Value Object × × Display data
Valid data types:
CrossProfile
LengthProfile
float[n]
float[2, n]
float[2][n]
Visible Boolean × × × Defines whether the diagram is to be
shown.
YAxisName String × The name of the y-axis assigned to this
diagram.
CursorValueYAbsoluteDevi Float × Absolute deviation from the nominal value
ationConverted at the current cursor position. The value is
given in the current unit of the y-axis.
CursorValueYAbsoluteDevi Float × Absolute deviation from the nominal value
ationRaw at the current cursor position. The value is
given in the unit of the data.
CursorValueYConverted Float × Y-value of the data at the current cursor
position. The value is given in the current
unit of the axis.
CursorValueYRaw Float × Y-value of the data at the current cursor
position. The value is given in the unit of the
data.
CursorValueRelativeDeviati Float × Relative deviation from the nominal value at
on the current cursor position.
ValueX Float × Current cursor position on the x-axis. The
value is given in the unit defined under
ValueXUnit.
ValueXUnit String × Unit in which ValueX is available.
ValueYDisplayed Float × Y-value at the current cursor position in axis
units. This takes both unit selection and the
current selected data display (deviation
from nominal value etc.) into consideration.
Tag Object × Contains the dataset index in a display of
trends (All As XY Pairs).

Event Description
DataChanged Is triggered when the Value property has changed.
ValueChanged Is triggered when the Value property has changed.

MV_4108_03_en Vers.: 28.01.2021 35/120


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

2.2.9 Horizontal Lines (HorizontalLine)

Tracks[n].PlotData.HorizontalLines[n]
Property Type S B P Description
DisplayName String × Name displayed. This name is shown, for
example, in the legend control.
Interactive Boolean × Defines whether the line can be selected
and moved with the mouse. To move the
line, it is necessary to press the Shift key
when the line is selected with a left-click.
LineColor Color × × × Line colour
Linestyle × Line style
Solid
Dash
DashDot
Dot
DashDotDot
LineWidth Integer × Line width in pixels
RelatedPlotData × The line can be assigned to another
diagram so that the position of the line in
comparison to the other diagram is retained
in the different display modes.
Unit String × Unit of the value given at Value.
Value Float × × × Position of the line.
ValueType × Absolute:
The line is shown at the position given at
Value.
PositiveTolerance:
The value given at Value is interpreted as
the positive deviation from the nominal
value of the assigned diagram
(RelatedPlotData) in percent.
NegativeTolerance:
The value given at Value is interpreted as
the negative deviation from the nominal
value of the assigned diagram
(RelatedPlotData) in percent.
Visible Boolean × × × Defines whether the diagram is to be
shown.
YAxisName String × The name of the y-axis assigned to this
diagram.

Event Description
ValueChanged Is triggered when the Value property has changed.

36/120 Vers.: 28.01.2021 MV_4108_03_en


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

2.2.10 Vertical Lines (VerticalLine)

Tracks[n].PlotData.HorizontalLines[n]
Property Type S B P Description
DisplayName String × Name displayed. This name is shown, for
example, in the legend control.
Interactive Boolean × Defines whether the line can be selected
and moved with the mouse. To move the
line, it is necessary to press the Shift key
when the line is selected with a left-click.
LineColor Color × × × Line colour
Linestyle × Line style
Solid
Dash
DashDot
Dot
DashDotDot
LineWidth Integer × Line width in pixels
RelatedPlotData × The line can be assigned to a diagram so
that the position of the line in comparison to
the diagram is retained in Data Centered
display mode.
Unit String × Unit of the value given at Value.
Value Float × × × Position of the line.
Visible Boolean × × × Defines whether the diagram is to be
shown.

Event Description
ValueChanged Is triggered when the Value property has changed.
DataChanged Is triggered when the Value property has changed.

MV_4108_03_en Vers.: 28.01.2021 37/120


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

2.2.11 False Colour Diagram (FalseColorPlot)

Figure 3.4 Example of a false colour diagram

Tracks[n].PlotData.FalseColorPlots[n]
Property Type S B P Description
DisplayName String × Name displayed. This name is shown, for
example, in the legend control.
GapFillMode × Defines how the gaps between the
individual cross profiles in the display are to
be filled.
NoFill:
The gaps are not filled.
FillWithPrevious:
The gaps are plotted as in the previous
profile.
HoleValue Float × If the data contain the value given here, this
data point is not shown. There is then a gap
in the display.
NominalValue Float × × Nominal value
This value is needed for the display modes
Absolute Deviation and Relative Deviation.
NominalValueUnit String × Unit of the value given at NominalValue.
PercentScalation100 Float × × This value corresponds to 100 percent in
display mode 0..100%.
PercentScalation100Unit String × Unit of the value given at
PercentScalation100.
PercentScalationZero Float × × This value corresponds to 0 percent in
display mode 0..100%.
PercentScalationZeroUnit String × Unit of the value given at
PercentScalationZero.

38/120 Vers.: 28.01.2021 MV_4108_03_en


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

Property Type S B P Description


UnitX String × Unit of the data in x-direction (coil length)
UnitY String × Unit of the data in y-direction (coil width)
UnitZ String × Unit of the data
Value Object × × Display data

Valid data types:


CrossProfile
CrossProfileArray
Value Tooltip × Display of x,y,z at the current mouse
position
Visible Boolean × × × Defines whether the diagram is to be
shown.
YCompression × Defines how data points are to be shown if
multiple points lie on the same pixel
position (y-direction).
Avg:
The average value of the data points is
shown.
Min:
The lowest of the data points is shown.
Max:
The highest of the data points is shown.
AbsMin:
The lowest of the absolute values of the
data points is shown.
AbsMax:
The highest of the absolute values of the
data points is shown.
YDisplayMode × Defines how the colours between 2 data
points in y-direction are to be shown (cf.
figure 3.6 + figure 3.7).
StepCentered:
The area between 2 points is half-filled with
the colour for data point 1 and the other half
with the colour for data point 2.
Step:
The area is filled with the colour for data
point 1.
Interpolation:
A colour value is calculated per linear
interpolation for every pixel position
between the two points.
YReversed × The data are reversed in y-direction.
YAxisName × The name of the y-axis assigned to this
diagram.

MV_4108_03_en Vers.: 28.01.2021 39/120


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

Property Type S B P Description


ZAxisName × The name of the z-axis assigned to this
diagram (colour scale is defined for this
axis).
CursorValue × Single cross profile at the current cursor
position.
CursorValueHorizontal × Delivers the longitudinal track along the
cross hair cursor.
CursorProfileIndex int × Index of the single cross profile at the
current cursor position. The value is -1 if
there is no profile available at the position.
UpdateCursorIfHidden Boolean × If Visible = False, the cursor values are
updated nevertheless.

40/120 Vers.: 28.01.2021 MV_4108_03_en


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

Tracks[n].PlotData.FalseColorPlots[n].ValueTooltip
Property Type S B P Description
ShowXValue Boolean × The tool tip shows the x-value at the current
mouse position.
ShowYValue Boolean × The tool tip shows the y-value at the current
mouse position.
ShowZValue Boolean × The tool tip shows the z-value at the current
mouse position.

Figure 3.5 Example of ValueTooltip

Example of display with identical data but different YDisplayMode

YDisplayMode: Step YDisplayMode: Interpolation

Example of display GapFillMode = NoFill. The gaps between the individual cross profiles are not filled.

MV_4108_03_en Vers.: 28.01.2021 41/120


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

Example of display ColorInterpolation = None, colour scale with fixed colour segments, no colour
gradient.

42/120 Vers.: 28.01.2021 MV_4108_03_en


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

2.2.12 Scatter diagram (ScatterPlot)

Figure 3.5 Example of a scatter diagram

To show values in a scatter diagram, both the XValue and YValue properties must be supplied with
values. If these properties are supplied with two-dimensional input data types (e.g. length profile, cross
profile or PointF), the y-value of the respective type is used for display in each case.

Tracks[n].PlotData.ScatterPlot[n]
Property Type S B P Description
DisplayName String × Name displayed. This name is shown, for
example, in the legend control.
PercentScalation100 Float × × This value corresponds to 100 percent in
display mode 0..100%.
PercentScalation100Unit String × Unit of the value given at
PercentScalation100.
PercentScalationZero Float × × This value corresponds to 0 percent in
display mode 0..100%.
PercentScalationZeroUnit String × Unit of the value given at
PercentScalationZero.
SymbolColor Color × × × Colour of the data point symbol.
SymbolSize Integer × Size of the data point symbol in pixels.
SymbolStyle × Style of the data point symbol.
No symbol None
Dot

Box
Triangle

Diamond

Cross

DiagCross

MV_4108_03_en Vers.: 28.01.2021 43/120


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

Property Type S B P Description


UnitX String × Unit of the data in x-direction
UnitY String × Unit of the data in y-direction
XValues Object × × Display data

Valid data types:


CrossProfile
LengthProfile
float[n]
PointF[]
YValues Object × × Display data

Valid data types:


CrossProfile
LengthProfile
float[n]
PointF[]
Visible Boolean × × × Defines whether the diagram is to be
shown.
YAxisName String × The name of the y-axis assigned to this
diagram.

Event Description
DataChanged Is triggered when the Value property has changed.

44/120 Vers.: 28.01.2021 MV_4108_03_en


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

2.2.13 Digital Signal Diagram (BinaryLengthProfile)

Figure 3.6 Example of digital signals

The display and font size are adjusted automatically to the available height of the plot area. Since the
signals are recorded on a length basis at a fixed interval, it can happen that the signal state changes
several times within an interval. This state is marked separately; the signal is plotted with a dotted line
and the background filled with SignalFillColor (orange).

Tracks[n].PlotData.BinarylengthProfiles
Property Type S B P Description
BackColor1 Color × × × Background colour for the signal; is shown
alternatingly with BackColor2.
BackColor2 Color × × × Background colour for the signal; is shown
alternatingly with BackColor1.
LineBackColor Color × × × Background colour of the area between
signal state low and high.

Tracks[n].PlotData.BinarylengthProfiles.Profiles[n]
Property Type S B P Description
DisplayName String × Name displayed
LineColor Color × × Line colour
LineWidth Integer × Line width in pixels
SignalFillColor Color × × Background colour of the signal when the
state has changed multiple times within the
recording interval.
UnitX × Unit of the data in x-direction
Value Object × Display data

Valid data types:


BitLenProfile
int[n]

MV_4108_03_en Vers.: 28.01.2021 45/120


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

Property Type S B P Description


Visible × × Defines whether the diagram is to be
shown.

2.2.14 Material Defects Diagram (MaterialDefects)

Figure 3.6.1 Example of material defects

46/120 Vers.: 28.01.2021 MV_4108_03_en


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

Tracks[n].PlotData.MaterialDefects[n]
Property Type S B P Description
DisplayName String × Name displayed
DisplaySettings Object × × The display properties of material defects.
They are taken from the DefectLegend
control.
MinDefectSize Size × × × The minimum size of a rectangle to show
defects.
SelectedDefect Object × The object containing the material defect.
ShapeBackColor Color × × × The background colour of the selection
rectangle.
ShapeBorderColor Color × × × The colour of the border of the selection
rectangle.
ShapeVisible Boolean × × × Defines whether the selection rectangle is
to be shown.
UnitX String × × Unit of the data in x-direction
UnitY String × × Unit of the data in y-direction
Value Object × × Display data
Valid data type: MaterialDefects
Visible Boolean × × × Show diagram
YAxisName String × The name of the y-axis assigned to this
diagram.

Event Description
DataChanged Is triggered when the Value property has changed.

MV_4108_03_en Vers.: 28.01.2021 47/120


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

2.3 Unit Selection


The unit must be specified for every value.

For every value that is linked to a property of the chart or for which a property is defined, there are one
or more properties where the unit(s) of the value must be specified. The chart then converts the data to
the axis unit also taking the display mode into consideration.

Example:
In a length profile, the unit of the data in x and y-direction must be specified (UnitX, UnitY) so that the
data can be converted to the units of the x and y-axis.

If the data are to be displayed as Deviation from Nominal Value, the unit of the nominal value must of
course also be defined (NominalValueUnit).

The units can either be entered directly or selected in a dialogue.

The dialogue lists all units available, i.e. all units defined in UnitDefines.xml. Conversion is only possible
for these units.

Unknown units are marked with a warning symbol .


Valid units are marked with .

48/120 Vers.: 28.01.2021 MV_4108_03_en


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

2.4 Display of Warnings


If, for example, units cannot be converted or the data are invalid, a warning symbol is shown in the
chart. A dialogue with details on the warnings can be opened by clicking the symbol.

The display of warnings can be switched on/off with the property ShowWarnings.

MV_4108_03_en Vers.: 28.01.2021 49/120


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

2.5 Data Export


The data of the charts shown in the control can be exported to CSV files or an Excel workbook (XSLX)
during runtime. To do so, right-click the control to open the scale dialogue and then select the tab Export.

During export, every curve is saved in a separate CSV file or a separate worksheet in an Excel workbook
in the specified target directory. The name configured in the property DisplayName is used as file name.
If the option Group 2D-diagrams is selected, all two-dimensional diagrams are grouped in the file 2D-
Diagrams.csv or worksheet 2D-Diagrams.

Example of length profile export:

50/120 Vers.: 28.01.2021 MV_4108_03_en


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

Example of cross profile export:

2.6 MultiChart and DataViewer in Runtime Mode


If the property EnableRuntimeDragDrop is true, data bindings can be added to the MultiChart during
runtime. This is done by drag & drop (cf. 2.7.2).

A page can be created easily and configured during runtime with the help of the methods LoadConfig,
SaveConfig, Undo and Redo.

MV_4108_03_en Vers.: 28.01.2021 51/120


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

2.7 MultiChart and DataViewer in Designtime Mode


2.7.1 Display of Data Bindings
In DataViewer designtime mode, the data bindings linked to the chart are shown in the corresponding
plot area. This gives you a quick overview of which data are to be shown in the chart.
The different diagram types are symbolised by icons. A property dialogue for the selected diagram can
be opened by clicking the corresponding icon. In addition to the icons for the configured diagrams, an
icon is shown on every axis and every track with which the corresponding properties can be edited
easily.
Icons to delete the respective element are also shown.

Icons for the different diagrams:


LengthProfile
CrossProfile
BarGraph
Scatter Plot
BinaryLengthProfile
MaterialDefects
FalseColor Plot
Horizontal Line
Vertical Line

Properties dialogue for a diagram:

52/120 Vers.: 28.01.2021 MV_4108_03_en


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

2.7.2 Drag & Drop

Drag & drop should be the preferred method for configuration of a MultiChart in DataViewer. In this
method the database fields required are simply dragged into the chart with the mouse. The chart then
adds a new plot area and new axes automatically. The database field can then be assigned to a y-axis
directly by moving the mouse to the required axis and then letting the mouse key go.

A selection dialogue is then opened:

In it select the required diagram and confirm with Ok. A dialogue is then opened for configuration of the
new diagram.

MV_4108_03_en Vers.: 28.01.2021 53/120


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

The following settings have already been applied automatically from the additional information of the
database field:

• unit of the database field


• name of the database field

If the configuration dialogue for the diagram is closed with Ok, the corresponding data binding is added
automatically.

If the option Trend was selected, the data binding is created as Trend data binding (All of Selection). In
this way it is also possible to generate a long-term trend very easily during runtime.

It is not only possible to add new diagrams by drag & drop, but also bindings of scalar values. For
example, it is very easy to link the nominal value to one or more length profiles. To do so, select the
nominal value from the database fields and drag it to the chart. Then drop the nominal value on the axis
of the required length profile.

Then select the button and close the dialogue with Ok.

54/120 Vers.: 28.01.2021 MV_4108_03_en


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

The required targets for the data binding are then selected in the next dialogue.

MV_4108_03_en Vers.: 28.01.2021 55/120


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

2.7.3 Long-Term Trends

In the MultiChart, long-term trends are, like all other data bindings, also linked to the Value property. A
separate ListValue property is not needed.

In false colour diagrams, a trend can be shown on top of length profiles. A length profile is then shown
as a single bar.

Long-term trends can also be generated during runtime by drag & drop.

56/120 Vers.: 28.01.2021 MV_4108_03_en


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

3 IMSChartLegend

IMSChartLegend is a control that supplements the MultiChart with a tabular legend for length profiles.

Properties and Possibilities:


• Display of curve values at a cursor position in the MultiChart.
• Show/Hide curves in the MultiChart.
• Selection and display from a predefined list of curve values.
• Simple dialogue-based configuration.

3.1 Control Elements


Show/Hide Curves

The legend offers the possibility to show/hide curves in the MultiChart. This is done by
selecting/deselecting the option in the line of the required curve. The MultiChart accepts this change
and shows/hides the selected curve accordingly.

MV_4108_03_en Vers.: 28.01.2021 57/120


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

3.2 Configuration in Designtime Mode


Configuration of the Legend

The legend is linked to one or all plot areas (tracks) of the MultiChart in designtime mode. This is done
by positioning a legend on a DataViewer page. The dialogue for selection of tracks and serial values is
then opened.

One or all tracks of the MultiChart with which the legend is to be linked are selected on the left side of
the dialogue. All serial values made available by the MultiChart are shown on the right side. The values
required can be selected with the checkboxes.

58/120 Vers.: 28.01.2021 MV_4108_03_en


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

The following serial values are available for selection:


• Curve ID (ID)
• Visibility of the curve (Visible)
• Name of the curve (Name)
• Cursor value (CursorValue)
• Absolute deviation from nominal value (CursorAbsDev)
• Relative deviation from nominal value (CursorRelDev)
• Nominal value of the deviation (NominalValue)
• Average value (AvgValue)
• Minimum (MinValue)
• Maximum (MaxValue)
• Standard deviation (StdDev)
• Variance (Variance)
• Position of the cursor on the x-axis (XPosition).

If the chart binding is to be reconfigured, this is done with the button to the right of the property
ChartName in the properties window. Clicking this button opens the configuration dialogue again. The
safety check informs that continuing will delete the configuration that already exists.

MV_4108_03_en Vers.: 28.01.2021 59/120


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

Configure Columns

The settings of the columns can be changed retrospectively. A click on the button on the right next to
the property Columns in the properties window opens the columns editor. The order and properties of
the serial values can be changed in it. The meaning of the individual properties is explained in chapter
0.

Hide Legend Headings

It is sometimes necessary to hide the headers for space reasons. To do so, set the legend property
ShowHeader to False.

Hide Serial Data

In the case of invisible curves in the MultiChart, i.e. the property Visible for a curve in the MultiChart is
set on False, the whole row of the serial data can be hidden with the property ReduceInvisiblePlotRows
(=True). If the line is to remain visible and only the serial data are not to be shown, the property
HideInvisiblePlotData (=True) is set.

60/120 Vers.: 28.01.2021 MV_4108_03_en


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

3.3 Description of Properties


IMSChartLegend

Property Type S B P Description


BackColor System.Color × Background colour
Font System.Font × Font
ChartName String × Name of the chart control or chart track
to which the legend is to be linked.
Columns ColumnCollection × Columns to be shown
HideInvisiblePlotData Boolean × × Values for invisible curves in the
diagram are shown or not.
ReduceInvisiblePlotRows Boolean × × Rows for invisible curves in the
diagram are shown or not.
ShowHeader Boolean × × Header is shown in the legend or not.

Columns

Property Type S B P Description


Alignment StringAlignment × Text justification
Caption String × Column header. This value can be
translated into various languages
(resources).
ColWidth String × Column width in pixels. If the value is 0,
the column width is calculated
automatically.
FormatString String × Format string for floating comma
numbers.
Name String × Column name. This is a unique
identifier, which may not be changed.
UseCurveColorAsBackColor Boolean × The respective curve colour is used as
background colour for all lines in this
column.
UseCurveColorAsForeColor Boolean × The respective curve colour is used as
foreground colour for all lines in this
column.
Visible Boolean × Column is shown in the legend or not.

MV_4108_03_en Vers.: 28.01.2021 61/120


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

4 DefectLegend
The DefectLegend is a control that shows classes of material defects. The classification of the defects
is defined in a configuration file.

Properties and Possibilities


• Configuration editor for editing of a configuration file with defect classes.
• Defect classes are freely configurable regarding colour and description.
• Interactive show/hide of defect classes in other controls.
• Display of the material defects as value and as bar in relation to the total defect count.
• Hide non-existent defect classes.
• Show/Hide pseudo classes.

62/120 Vers.: 28.01.2021 MV_4108_03_en


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

4.1 Control Elements


Show/Hide Defect Classes

In runtime mode it is possible to show/hide the defect classes in the MultiChart, DefectTable and
DefectThumbnailBrowser controls interactively. This is done by selecting/deselecting the individual
defect classes in the legend.

Context Menu

It is also possible select/deselect defect classes with the context menu.

Check all All defect classes are selected.


Uncheck all All defect classes are deselected.
Check only this The defect class where the cursor is positioned is selected.
Uncheck pseudos Pseudo defects such as water drops are deselected.
Hide empty defect classes Empty defect classes are removed from the legend.

Save Settings

The settings for the legend can be saved with the DataViewer runtime settings (*.dvs).

MV_4108_03_en Vers.: 28.01.2021 63/120


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

4.2 Configuration in Designtime Mode

Creating a Configuration File

To use defect classes in the legend, it is first necessary to create a new configuration file with defect
classes or to load an existing configuration file. The legend configuration is an XML file containing all
necessary information on the defect classes.

The file name of the configuration file is located in the property GlobalConfigurationFile in the properties
window. The file name can be entered there directly. The configuration file is then loaded from the project
directory or DataViewer directory. Alternatively, it is also possible to define the absolute path to the
configuration file.

Editing a Configuration File

The configuration dialogue is opened with the Edit button for the property GlobalConfigurationFile in the
properties window. If a configuration file has not yet been specified, the dialogue is still empty. Properties
can be edited in the configuration file using a context menu. Apart from editing defect classes, it is also
possible to predefine settings for the display of defect classes in runtime mode. Every defect class line
in the dialogue window begins with a selection box. It can be decided whether this class is to be shown
at runtime by checking/unchecking the box. It is also possible to select or deselect all defect classes via
the context menu.

64/120 Vers.: 28.01.2021 MV_4108_03_en


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

Context Menu for Editing the Configuration

Right-clicking opens a context menu with which the configuration can be edited.

Edit Used to edit the selected defect class with the help of the defect class
editor.
Add Opens the defect class editor and creates a new defect class.
Remove Removes the selected defect class.
Check all All defect classes are selected.
Uncheck all All defect classes are deselected.
Check only this The selected defect class is selected.
Uncheck pseudos All pseudo defects are deselected. A pseudo defect could be a water drop.
Pseudo defects are shown in the legend in grey type.
Load Config Loads a configuration file via the file selection dialogue.
Save Config Saves the current configuration via the file saving dialogue.

MV_4108_03_en Vers.: 28.01.2021 65/120


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

Editing a Defect Class with the Defect Class Editor

The menu options Add and Edit in the context menu open the defect class editor.

Color The colour of the defect class.


ID The ID of the defect class. The defect class IDs are specified by the surface
inspection device.
Short name The short name of the defect class.
Name (long) The long name of the defect class.
Status The status of the defect class.
Parent Classifies the defect class under a parent class in the tree.
is pseudo defect The defect class can be a pseudo defect such as a water drop.
may by periodic The class can be periodic.
Description The description of the defect class. It appears as tool tip above a class in
the configuration dialogue.
Apply Applies the changes to the defect class or creates a new defect class.
Reset Resets all fields in the editor to their defaults. Text boxes are emptied.
Cancel Closes the editor without applying the changes.

Binding the Configuration to Other Controls

The controls MultiChart, DefectTable and DefectThumbnailBrowser bind the property DisplaySettings
of the legend with their property DisplaySettings and in this way use the settings of the defect classes.

66/120 Vers.: 28.01.2021 MV_4108_03_en


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

4.3 Description of Properties

Property Type S B P Description


Format String × The format for the display of a class:
{0} = DefectClassID
{1} = ShortText
{2} = LongText
{3} = Name
Example:
The format “{0}: [{1}] {2}” results in
.
GlobalConfigurationFile String × Path or file name of the configuration file
DisplaySettings DisplaySettings × The class configuration that is passed on
to other controls.
SelectedClassIDs Int[] × The selected classes in the legend
HistogramBackColor Color × × × The colour in which the histogram bars
(defect count) are shown.
DefaultROITextColor Color × Colour of the labels of ROI markers in
DefectPictureViewer.
HideEmpty Boolean × × × Empty classes are shown in the legend or
not.

Method Parameters S B P Description


FilterDefects DefectMap × Filters a DefectMap according to the selected
defect classes.

MV_4108_03_en Vers.: 28.01.2021 67/120


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

5 DefectTable
The DefectTable is a control that shows information on material defects in tabular form.

Properties and Possibilities


• Configuration editor to edit the data columns.
• Display of any selection of predefined data.
• Random order of data columns.
• Selection of a defect and display in DefectPictureViewer.

5.1 Control Elements


Selection of a Material Defect

A complete line can be selected by clicking a material defect. Other controls such as
DefectPictureViewer can then process this material defect further.

Sorting of Columns

The DefectTable shows the material defects in a table. It is thus possible to sort the values in a table
column in ascending or descending order by clicking a header.

68/120 Vers.: 28.01.2021 MV_4108_03_en


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

5.2 Configuration in Designtime Mode


Creating a Table Configuration

When a DefectTable is dragged on to a DataViewer page from the toolbox in designtime mode, the
DefectTable has not yet been configured.

To create and edit data columns, the column editor must first be opened. It is opened with the Edit button
for the property Column in the properties window.

Any number of columns can be created with the help of the Add button. A new column is always added
at the end of the list. Existing columns can be selected with the mouse and then edited in the editor’s
properties window. The property DisplayType defines the data that are to be shown in a column. The
display type can be selected from a set specified by the system. The order of the columns can be
changed with the arrow buttons. The Remove button deletes the column selected in the editor.

The meaning of the properties of a column is described in chapter 5.3.

Interaction with Other Controls

To show material defects, a DefectTable must be supplied with data. For this, the MultiChart property
SelectedDefects must be linked to the property Defects and the DefectChartLegend property
DisplaySettings to the property DisplaySettings. So that the DefectTable also updates every change in
the MultiChart, the event SelectionChanged must also be linked to the property Defects.

The property SelectedDefect supplies the DefectThumbnailBrowser and the PictureViewer with the
currently selected material defect. A change to the selected material defect is made known by the event
SelectedDefectChanged.

MV_4108_03_en Vers.: 28.01.2021 69/120


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

5.3 Description of Properties


DefectTable

Property Type S B P Description


Columns DefectTableColumn × Definition of the columns to be
shown
DisplaySettings DisplaySettings × DisplaySettings from the
DefectLegend must be linked here
Defects IList<IDefect> × List with the selected defects (from
MultiChart)
SelectedDefect IDefect × Defect currently selected per
mouse click

Column

Property Type S B P Description


DisplayType String × Display types available for
selection:
EmptyString,ID, ClassID,
DistanceEdgeMax,
DistanceEdgeMin, Intensity,
IntensityClass, PositionLength,
PositionWidth, Remark, Side,
SizeArea, SizeLength, SizeWidth,
FilterLevel, Description, LongText,
ShortText, Name, PeriodID,
PeriodLength, ParentID
FormatString String × Data format
HeaderText String × Header that is shown
UnitSI String × Display in SI units
UnitUS String × Display in US units
UseBackColor Boolean × Use the colour defined in the
legend as background colour
UseForeColor Boolean × Use the colour defined in the
legend as text colour

70/120 Vers.: 28.01.2021 MV_4108_03_en


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

6 DefectThumbnailBrowser
The DefectThumbnailBrowser is a control that shows previews of all material defects.

Properties and Possibilities


• Preview of material defects
• Navigation via scrollbars
• Selection of a defect and display in DefectPictureViewer

6.1 Control Elements


Navigation

The area of the visible material defects can be moved with the scrollbars.

Selection of a Material Defect

A material defect can be selected in the browser by clicking and then made available to other controls
such as the DefectPictureViewer.

MV_4108_03_en Vers.: 28.01.2021 71/120


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

6.2 Configuration in Designtime Mode

Multiple Databases

If more than one database link has been configured in the DataViewer file dclconfig.xml, the correct
database name must be specified with the property CatalogName. If only one database with material
defect data exists, the control connects to it automatically and CatalogName can remain empty. If
several servers are accessed at the same time, the server name ServerName.DatabaseName must
also be specified.

Interaction with Other Controls

To show material defects, a DefectThumbnailBrowser must be supplied with data. For this, the
MultiChart property SelectedDefects must be linked to the property SelectedDefects and the
DefectChartLegend property DisplaySettings to the property DisplaySettings. So that the DefectTable
also updates every change in the MultiChart, the event SelectionChanged must also be linked to the
property SelectedDefects.

The property SelectedDefect supplies the DefectTable and the PictureViewer with the currently selected
material defect and changes to it are made known via the event SelectedDefectChanged.

6.3 Description of Properties


Property Type S B P Description
DisplayText Boolean × Show defect class name at the
thumbnails
DisplayTextPosition Enum × Position of the label
RoiFrameColor Color × Default colour of the defect selection
frame
RoiFrameColorFromClassColor Boolean × Use colour definition from the
legend, otherwise default colour
ThumbnailSize Size × Size of the thumbnails in pixels
ThumbnailSizeMode Enum × Scaling mode for the thumbnails
CatalogName String × Database name in the case of more
than one database
DisplaySettings DisplaySettings × DisplaySettings from the
DefectLegend must be linked here
SelectedDefects IList<IDefect> × List with the selected defects from
MultiChart
SelectedDefect IDefect × Material defect selected in browser

72/120 Vers.: 28.01.2021 MV_4108_03_en


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

7 DefectPictureViewer
The DefectPictureViewer is a control that shows the pictures of the material defects.

Properties and Possibilities


• Zoom in/out of a picture with the mouse wheel.
• Selection of a region in a picture with a Lasso cursor.
• Move picture with the cursor.
• Switch defect marking on/off.
• 2D and 3D display of pictures.

MV_4108_03_en Vers.: 28.01.2021 73/120


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

7.1 Control Elements

Navigation in a Picture

The DefectPictureViewer shows the picture of a material defect. To navigate in a picture, the
DefectPictureViewer offers a toolbox with buttons with the following functions (from left to right):

- Fit complete picture in the control


- Zoom with the mouse wheel
- Move picture with the mouse while left-clicking
- Zoom a rectangular selection
- Switch automatic defect marking and labelling on/off
- Selection box for X2Dvision or X3Dvision pictures. The selection box is only shown if both
types of picture are available.

In the case of X3Dvision pictures, a black and white height scale is shown on the right to set more
contrast in the display. The following buttons are added to the toolbox:

- Export an XY curve along a line; is only shown if the curve is bound to a chart
- Scale via the min/max values along a line
- Switch automatic min/max scaling on/off

74/120 Vers.: 28.01.2021 MV_4108_03_en


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

Scaling of 3D Pictures:

The pictures of 3D surface inspection systems are height matrices. They are shown as grey scale image,
with high values displayed brightly and low values displayed darkly. When min/max scaling is active,
black corresponds to the lowest value of the matrix and white to the highest value. The sliders on the
right side can be used to raise the value for black and lower it for white, resulting in a higher contrast in
the area in between.

The button to the left of Min/Max activates a drawing pen, which can be used to draw a blue line
through the picture. A new scale is formed from the min/max values along this line, which then results
in the maximum contrast in the area of the line. Pressing the button again makes the line disappear
again; the new scale is retained.

7.2 Configuration in Designtime Mode

Multiple Databases

If more than one database link has been configured in the DataViewer file dclconfig.xml, the correct
database name must be specified with the property CatalogName. If only one database with material
defect data exists, the control connects to it automatically and CatalogName can remain empty. If
several servers are accessed at the same time, the server name ServerName.DatabaseName must
also be specified.

Interaction with Other Controls

The DefectPictureViewer shows the picture of the material defect selected in the DefectTable or
DefectThumbnailBrowser. So that a picture is shown, the DefectPictureViewer property SelectedDefect
must be linked to the property SelectedDefect in the DefectThumbnailBrowser and DefectTable and
triggered by the event SelectedDefectChanged.

MV_4108_03_en Vers.: 28.01.2021 75/120


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

Display of the XY Curve

If you bind the property XYCurve with the event XYCurveChanged to the Value property of a
LengthProfile in a MultiChart, you can display the float values along a line as an XY diagram.

7.3 Description of Properties

Property Type S B P Description


CatalogName String × Database name in the case of more
than one database
SelectedDefect IDefect × Material defect selected in a control
DisplaySettings DisplaySettings × DisplaySettings from the legend
ScaleMin Float × × Black value for 3D pictures
ScaleMax Float × × White value for 3D pictures
XYCurve XYProfile × Height profile curve along a line
XYCurveChanged × Is triggered when XYCurve has
changed. If this event is not used
anywhere, then the corresponding
button is not shown in the toolbox.

76/120 Vers.: 28.01.2021 MV_4108_03_en


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

8 SurfaceChart
The SurfaceChart is a control that shows the surface defects on a coil graphically. This chart is used,
for example, with hole detectors.

Properties and Possibilities:


• Display of various types of coil defects such as holes and edge cracks.
• Selection of a region with a Lasso cursor.

8.1 Control Elements

Manual Setting of the Scale

• Dialogue
Right-click the control to open the axis scaling dialogue, with which all settings for the x-axis,
y-axis and cursor can be made.

• Text input
Clicking the scale edges opens a text box in which a scale value can be entered.

• Sliders
The sliders can be used to change a single end scale value, or both scale end values
simultaneously by clicking between the two sliders and then changing the position of both
sliders by dragging with the mouse. With the sliders, it is only possible to set the range of the
scale on at most the last scale values entered. If the displayed region is to be enlarged, the
corresponding scale values must be entered via the dialogue.

MV_4108_03_en Vers.: 28.01.2021 77/120


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

Axis Scaling Dialogue

X-axis:

Scalation modes Manual:


The scale is set manually with the sliders or by text input.

Max / Min:
The scale is set automatically on the minimum and maximum values of the
data contained.

Database:
The scale is set automatically on the values linked with the properties
DatabaseScaleMin and DatabaseScaleMax.
Manual scalation Manual scaling can be set with the sliders or by text input.

78/120 Vers.: 28.01.2021 MV_4108_03_en


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

Y-axis:

Scalation modes Manual:


The scale is set manually with the sliders or by text input.

Max / Min:
The scale is set automatically on the minimum and maximum values of the
data contained.

Database:
The scale is set automatically on the values linked with the properties
DatabaseScaleMin and DatabaseScaleMax.
Manual scalation Manual scaling can be set with the sliders or by text input.
Track usage Raw Data
The data are shown unchanged.

Absolute Deviation
The respective nominal value is subtracted from the data.

Relative Deviation
The data are shown as deviation from the nominal value in percent.

MV_4108_03_en Vers.: 28.01.2021 79/120


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

Cursor:

Cursor visible The cursor is visible when the option is selected.

Cursor type The control offers the following types of cursor: Line, Rectangle, Cross,
Circle, Cross And Circle, Lasso Rectangle.
Zoom+/Zoom- The zoom buttons enlarge or reduce the surface display.

8.2 Configuration in Designtime Mode

Creation of Defect Series

The creation of surface defects depends on the surface defects saved in the database.

For defect series, it is necessary to create an object of the type CoilDefectSeries. This is done by
opening the editor with the Edit button for the property CoilDefectSeriesList in the properties window
and creating an element with the Add button. In the bindings window, the series data of the surface
defects from the database can then be linked to the property CoilDefects and the icon list from the
SurfaceChartLegend to the property SymbolDefList.

Apart from the defect series, it is also possible to display coil edge series.

For coil edge series, it is necessary to create an object of the type CoilEdgePairSeries (measured
absolutely) or CoilGeometrySeries (measured relative to centerline deviation). This is done by opening
the editor with the Edit button for the property CoilEdges or CoilGeometry in the properties window and
creating an element with the Add button.

In the bindings window, the corresponding database fields can then be linked to the property Value for
positive and negative coil edge series for an object of the type CoilEdgePairSeries or
CoilGeometrySeries.

80/120 Vers.: 28.01.2021 MV_4108_03_en


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

8.3 Description of Properties

Property Type S B P Description


ChartCursor ChartCursorProperties × × Cursor
→ BackColor Color × × Colour of the cursor
→ RefreshMode eCursorRefreshMode × Cursor refresh mode
(AfterSelectionDone, Always)
→ Style flexChartCursorStyle × Type of cursor (Line, Rectangle,
Cross, Circle, Cross And Circle, Lasso
Rectangle)
→ Visible Boolean × × Shows/Hides the cursor
ChartArea ChartAreaProperties × × Area of the control
→ BackColor Color × × Colour of the area
PlotArea PlotAreaProperties × × Plot area enclosed by the x-axis and y-
axis
→ BackColor Color × × Colour of the plot area
→ GridHorizontal Int32 × × Horizontal grid
→ GridVertical Int32 × × Vertical grid
→ PosBottom Int32 × Position of the bottom side of the plot
area
→ PosLeft Int32 × Position of the left side of the plot area
→ PosRight Int32 × Position of the right side of the plot
area
→ PosTop Int32 × Position of the top side of the plot area
CoilDefectSeriesList CoilDefectSeriesList × × × Defect series to be shown
CoilEdges CoilEdgePairSeriesList × × × Coil edges absolute
CoilGeometry CoilGeometrySeriesList × × × Coil edges relative to centerline
deviation
XAutoScaleMode AutoScaleOptions × Automatic scaling mode for the x-axis
(DataMinMax, Database Scaling,
Manual Scaling).
XAxisFont Font × × Font for the x-axis
XManualScaleMode ManualScaleOptions × × Manual scaling mode for the x-axis
(sliders, text input)
XScaleMax Single × × × Scale maximum for the x-axis
XScaleMin Single × × × Scale minimum for the x-axis
XSlidersVisible Boolean × × Shows/Hides the sliders for the x-axis
XUnitImperial String × × US unit of the x-axis
XunitMetric String × × Metric unit of the x-axis

MV_4108_03_en Vers.: 28.01.2021 81/120


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

Property Type S B P Description


YAutoScaleMode AutoScaleOptions × Automatic scaling mode for the y-axis
(DataMinMax, Average Value +/- 3
Sigma, Database Scaling, Manual
Scaling)
YAxisFont Font × × Font for the y-axis
YManualScaleMode ManualScaleOptions × × Manual scaling mode for the y-axis
(sliders, text input, buttons)
YScaleMax Single × × × Scale maximum for the y-axis
YScaleMin Single × × × Scale minimum for the y-axis
YSlidersVisible Boolean × × Shows/Hides the sliders for the y-axis
YUnitImperial String × × US unit of the y-axis
YUnitMetric String × × Metric unit of the y-axis

82/120 Vers.: 28.01.2021 MV_4108_03_en


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

9 SurfaceChartLegend
The SurfaceChartLegend is a control that manages classes of surface defects. Defects can be classified
individually.

Properties and Possibilities


• Individual creation of a list of defect classes.
• Free selection of symbols and colours for coil defect types.
• Display of the selected classes of surface defects in the SurfaceChart and CoilDefectTable.

9.1 Control Elements


Show/Hide Defect Classes

In runtime mode it is possible to show/hide individual defect classes in the SurfaceChart and
CoilDefectTable controls interactively. This is done by selecting/deselecting the defect classes in the
legend.

MV_4108_03_en Vers.: 28.01.2021 83/120


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

9.2 Configuration in Designtime Mode


Creation and Editing of Coil Defect Type Lists

To create a new SymbolDefinitionList with defect classes or to edit an existing list, open the editor with
the Edit button for the property SymbolDefinitionList in the properties window

In this dialogue you can add new defect classes to the end of the list or delete existing classes with the
Add and Remove buttons on the left side. The order of the defect classes can be changed with the arrow
buttons.

The properties of a defect class can be edited on the right side. This is of the type SymbolDefinitionList
and the properties are described in chapter 0.

Interaction with Other Controls

The controls SurfaceChart and CoilDefectTable bind the property SymbolDefinitionList of the legend
with their property SymbolDefList and in this way use the settings of the defect classes.

9.3 Description of Properties

Property Type S B P Description


CellBackColor Color × Background colour of the legend
CellBorderColor Color × Grid colour of the legend
CellFont Font × Font in the legend
SymbolBackColor Color × × Background colour of the symbol cells
Symbol- SymbolDefList × × Symbol list of the surface defects
DefinitionList

84/120 Vers.: 28.01.2021 MV_4108_03_en


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

10 CoilDefectTable
The CoilDefectTable is a control that shows information on surface defects in tabular form. This chart is
used with hole detectors.

Properties and Possibilities


• Configuration editor to edit the data columns.
• Display of any selection of predefined data.
• Random order of data columns.
• Selection of a surface defect and display in PictureViewer.

10.1 Control Elements


Selection of a Surface Defect

A complete line can be selected by clicking a surface defect. Other controls such as PictureViewer can
then process this surface defect further.

Sorting of Columns

The CoilDefectTable shows the surface defects in a table. It is thus possible to sort the values in a table
column in ascending or descending order by clicking a header.

MV_4108_03_en Vers.: 28.01.2021 85/120


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

10.2 Configuration in Designtime Mode


Creating a Table Configuration

When a CoilDefectTable is dragged on to a DataViewer page from the toolbox in designtime mode, the
CoilDefectTable has not yet been configured.

To create and edit data columns, the column editor must first be opened. It is opened with the Edit button
for the property Cols in the properties window.

Any number of columns can be created with the help of the Add button. A new column is always added
at the end of the list. Existing columns can be selected with the mouse and then edited in the editor’s
properties window. The property DisplayItem defines the data that are to be shown in a column. The
display type can be selected from a set specified by the system. The order of the columns can be
changed with the arrow buttons. The Remove button deletes the column selected in the editor.

The meaning of the properties of a column of the type Column is described in chapter 10.3.

Interaction with Other Controls

To show surface defects, a CoilDefectTable must be supplied with data. For this, the SurfaceChart
property ActCursorValues must be linked to the property CoilDefects and the SurfaceChartLegend
property DisplaySettings to the property DisplaySettings. So that the CoilDefectTable also updates
every change in the SurfaceChart, the event ValueCursorChanged must also be linked to the property
ActCursorValues.

The property SelectedCoilDefectIdx supplies the PictureViewer with the currently selected surface
defect as index. A change to the selected defect is made known by the event SelectionChanged.

86/120 Vers.: 28.01.2021 MV_4108_03_en


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

10.3 Description of Properties


CoilDefectTable

Property Type S B P Description


CellBackColor Color × Background colour of the cells
CellBorderColor Color × Grid colour of the cells
CellFont Font × Font for the cells
CoilDefect- CoilDefect- × × × Defect series
SeriesList SeriesList
Cols ColumnList × Table columns
SelectedCoilDefect Int32 × Surface defect currently selected in the table
Selected- Int32 × Delivers the index of the currently selected
CoilDefectIdx surface defect
Selected- Int32 × Delivers the active defect series
CoilDefectSeries
Selected- Int32 × Start position coil length for the selected
CoilDefectXBegin CoilDefect
Selected- Int32 × End position coil length for the selected
CoilDefectXEnd CoilDefect
Selected- Int32 × Start position coil width for the selected
CoilDefectYBegin CoilDefect
Selected- Int32 × End position coil width for the selected
CoilDefectYEnd CoilDefect
SortColumn Int32 × × × Column for sorting
SortOrder Int32 × × × Sorting order
SymbolBackColor Color × Background colour of the symbol column

Column

Property Type S B P Description


→ DisplayItem DefectValueDispla × Source data column to be displayed, selected
y from the data source per browser
→ FormatString × Formatting string
→ Headline String × Column header.
→ SortOrder ColumnSortOrder × Column sorting order
→ Width Int32 × Column width

MV_4108_03_en Vers.: 28.01.2021 87/120


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

11 Data Types for Surface Defects

Special data types are needed to display surface defects.

SymbolDefinitionList

The data type SymbolDefinitionList defines a symbol list used to display defects such as holes and edge
crackets in the controls SurfaceChart, SurfaceChartLegend and CoilDefectTable.
Property Type Description
Description String Descriptive text
SymbolType SymbolType Symbol type – There are several shapes available for this
(circle, square, triangle, etc.)
SymbolColor Color Symbol colour
SymbolSize Int32 Symbol size in pixels
SymbolVisible Boolean Shows/Hides the symbol
DefType Int32 Defect type number
DefType- Int32 Defect classification
Classification
DefSourceId Int32 Defect gauge ID
DefStripSide Int32 Strip side of the defect
DefIntensityClass Int32 Intensity of the defect

CoilDefectSeriesList

The data type CoilDefectSeriesList is a list containing any number of defect series of the type
CoilDefectSeries.

CoilDefectSeries

The data type CoilDefectSeries is a container object to assign the coil direction and symbol list
to a defect series.
Property Type Description
CoilDefects Object Defect series data
XReversed Boolean Reverses the position of the x-values (left→right = false,
right→left = true).
SymbolDefList SymbolDefList Symbol list for display of the coil defects

88/120 Vers.: 28.01.2021 MV_4108_03_en


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

CoilEdgePairSeriesList

The data type CoilEdgePairSeriesList is a list containing any number of coil edge series of the type
CoilEdgePairSeries.

CoilEdgePairSeries

The data type CoilEdgePairSeries is a container object used to group coil edge series for
display in the SurfaceChart. It is used when the coil edges are measured absolutely.
Property Type Description
PositiveEdge CoilEdgeSeries Top (positive) coil edge
→ Value Object Coil edge series
→ Xoffset Single Offset of measured values in x-direction
→ Yoffset Single Offset of measured values in y-direction
NegativeEdge CoilEdgeSeries Bottom (negative) coil edge
→ Value Object Coil edge series
→ Xoffset Single Offset of measured values in x-direction
→ Yoffset Single Offset of measured values in y-direction
FillStyle CoilFillStyle Fill style of the area between the coil edges
FillColor Color Fill colour of the area between the coil edges
LineStyle LineStyle Line style used to display the coil edges
→ Width Int32 Line thickness in pixels
→ Color Color Line colour
→ Visible Boolean Sets whether the control is displayed or not
(true=visible; false=hidden).

CoilGeometrySeriesList

The data type CoilGeometrySeriesList is a list containing any number of coil edge series of the type
CoilGeometrySeries.

MV_4108_03_en Vers.: 28.01.2021 89/120


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

CoilGeometrySeries

The data type CoilGeometrySeries is a container object used to group coil edge series for display in
the SurfaceChart. It is used when the coil edges are measured relatively to centerline deviation.
Property Type Description
PositiveEdge EdgeData Coil edge series
NegativeEdge EdgeData Coil edge series
Width Object Coil width series
CenterlineDeviation Object Centerline deviation series
FillStyle CoilFillStyle Fill style of the area between the coil edges
FillColor Color Fill colour of the area between the coil edges
LineStyle LineStyle Line style used to display the coil edges
→ Width Int32 Line thickness in pixels
→ Color Color Line colour
→ Visible Boolean Sets whether the control is displayed or not.

12 CoilDefectControlSelector (CDCSelector)
The CoilDefectControlSelector is a control that shows/hides other controls on a DataViewer page in
dependence on the selected type of coil defect.

Properties and Possibilities:


• Show/Hide controls depending on the type of coil defect

12.1 Control Elements


The CoilDefectControlSelector is not visible in runtime mode.

90/120 Vers.: 28.01.2021 MV_4108_03_en


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

12.2 Configuration in Designtime Mode


If a CoilDefectControlSelector is placed on a DataViewer page, the designtime view appears. The
CoilDefectControlSelector must then be configured.

Creation and Editing of a Control List

To create or edit a control list, the control editor must first be opened. It is opened with the Edit button
for the property ControlList in the properties window.

Any number of controls can be created with the help of the Add button. A new control is always added
at the end of the list. Existing controls can be selected with the mouse and then edited in the editor’s
properties window. The property CoilDefectTypes is used to manage the defects for which the control
is to show something. The name of the control for which the defect list is valid is defined in the property
ControlName. The order of the columns can be changed with the arrow buttons. The Remove button
deletes the column selected in the editor.

MV_4108_03_en Vers.: 28.01.2021 91/120


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

Creation of a Defect List

The editor for editing a defect list is opened by pressing the Edit button for the property CoilDefectTypes
in the control editor.

The defect types that make a control visible are identified by the following properties:
• IntensityClass
• SourceId
• StripSide
• Type
• TypeClassification.
The value -1 can be used as wildcard, meaning all values are permitted.

Any number of defect types can be created with the help of the Add button. A new column is always
added at the end of the list. Existing defect types can be selected with the mouse and then edited in the
editor’s properties window. The Remove button deletes the column selected in the editor.

The meaning of the properties of a column of the type cCoilDefectType is described in chapter 12.3.

92/120 Vers.: 28.01.2021 MV_4108_03_en


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

12.3 Description of Properties


CoilDefectControlSelector

Property Type S B P Description


CoilDefectValue CoilDefect × Currently selected defect
ControlList cControlPrope × List of controls and corresponding defects
rties

cControlProperties

Property Type S B P Description


CoilDefectTypes Collection × A list of the selected defects
ControlName String × Name of the control

MV_4108_03_en Vers.: 28.01.2021 93/120


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

13 PictureViewer
The PictureViewer is a control that shows pictures from various sources.

An extended scope of tool functions is offered specifically for the display of surface defects.

Properties and Possibilities

• Display of pictures in various file formats such as JPG.


• Display of AVI frames.
• Display of surface defects with extended toolbox.

94/120 Vers.: 28.01.2021 MV_4108_03_en


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

13.1 Control Elements

The buttons and selection boxes in the toolbox have the following meaning from left to right:

- Fit complete picture in the control


- Show original size
- Invert picture

The following settings are additionally available for surface defects:

- Display of a horizontal grid with defined distance


- Display of a vertical grid with defined distance
- Zoom factor for enlargement of the picture
- Only selected surface defects are shown
- The surface defect is shown in the picture

13.2 Configuration in Designtime Mode


Display of a Picture

A picture or film can be bound to the PictureViewer with the property ImgPath. If it is a film in AVI format,
the frame that is to be displayed can be defined with the property AviFrameIndex.

Display of a Surface Defect

For display of a surface defect, the database fields of the surface defects with and without pictures must
be bound to the properties CDwoPics and CurrentCoilDefects. The picture that is to be shown is then
selected with the property SelCoilDefIndex, which is bound to the property SelectedCoilDefectIdx of the
CoilDefectTable. It is further necessary to bind the event CoilDefectTableChanged to this property so
that the PictureViewer accepts a new index when the table is changed.

13.3 Description of Properties

Property Type S B P Description


AviFrameIndex Integer × × Frame index of an AVI film
CDwoPics Object × Surface defects without pictures
CurrentCoilDefects Object × Surface defects with pictures
FlipHorizontal Boolean × × Rotate picture horizontally
FlipVertical Boolean × × Rotate picture vertically
ImgPath String × × File name including file path
MaxZoomFactor Integer × × Maximum zoom factor
SelCoilDefIndex Integer × × Index of the surface defect
ShowStripPos Boolean × × Show the surface defect

MV_4108_03_en Vers.: 28.01.2021 95/120


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

14 BarChart
The BarChart is a control that shows data as bar or candlestick chart.

Properties and Possibilities


• The colour and labelling of the bars is individually adjustable.
• Automatic display as candlesticks in the case of StatisticDataPicker.

14.1 Control Elements


No control elements are presented in a bar chart display. In candlestick chart display, by contrast, it is
possible to select a candlestick in the chart and pass the contents on to other controls.

96/120 Vers.: 28.01.2021 MV_4108_03_en


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

14.2 Configuration in Designtime Mode


Creation of Bars

To create or edit bars, the bar editor must first be opened. It is opened with the Edit button for the
property Bars in the properties window.

Any number of bars can be created with the help of the Add button. A new bar is always added at the
end of the list. Existing bars can be selected with the mouse and then edited in the editor’s properties
window. The order of the columns can be changed with the arrow buttons. The Remove button deletes
the column selected in the editor. The meaning of the properties of a bar is described in chapter 14.3.

Create Data Bindings to Bars

When the bars have been created, they appear in the bindings window under the property Bars. So that
the bars are also filled with data, the bar property Values is bound to a database field.

Use of the StatisticDataPicker

The control StatisticDataPicker fills the BarChart with data and selects the candlestick chart as display
type. The interaction between the BarChart and the StatisticDataPicker is described in chapter 20.2.

MV_4108_03_en Vers.: 28.01.2021 97/120


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

14.3 Description of Properties


BarChart

Property Type S B P Description


Bars BarItemCollection × × List of bars
Candles ChartCandleColle × × List of candles, is generated automatically by
ction StatisticDataPicker
ContentMode Enum × Display of the data as bar (SimpleBarChart) or
candlestick chart (CandleChart)
PlotAreaBackCol Color × Background colour of the chart
or
PlotAreaBackStyl Style × Display of the background as completely filled in
e (solid) or as gradient (gradient)
PlotAreaDistance Integer × Distance of the chart from the bottom
Bottom
PlotAreaDistance Integer × Distance of the chart from the left
Left
PlotAreaDistance Integer × Distance of the chart from the right
Right
PlotAreaDistance Integer × Distance of the chart from the top
Top
PlotAreaSecond Color × Second colour for the gradient
Gradient
SelectedCandle Candle × × The selected candle in a candlestick chart

BarItem

Property Type S B P Description


BarItemName String × × Name of the bar, is obtained from the x-axis of
the diagram
FillColor Color × × Fill colour of the bar
fillStyle Style × × Display of the bar as completely filled in (solid)
or as gradient (gradient)
FrameColor Color × Colour of the bar border
FrameWidth Integer × Width of the bar border
hasFrame Boolean × Display has a frame
secondGradient × Second colour for the gradient
Value Integer × × Displayed value as bar

98/120 Vers.: 28.01.2021 MV_4108_03_en


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

15 IMSCP3DChart

The IMSCP3DChart is a control that shows cross profile data in three dimensions (3D).

15.1 Control Elements


In runtime mode the IMSCP3DChart presents a row of setting possibilities that can be enabled via the
button bar.

The buttons X, Y and Z make it possible to change the axis scale, where X is the length, Y the width
and Z the measured value (thickness, flatness, temperature, etc.).

The selection box underneath the buttons is used to select the scaling mode for the selected axis. It is
possible to choose between min/max, manual and database scaling. If manual scaling is selected, the
minimum and maximum scale values must be entered in the following two text boxes. The axis can be
moved manually with the “+” and “-” buttons. The step width is given in the text box next to the buttons.

The Size button opens two text boxes where the stretch factor can be entered manually for the x and y-
axes behind Factor x and Factor y.

The Rot button opens three scroll bars where the rotation around the x, y and z-axes can be set.

The display can be rotated around all axes by moving the mouse while pressing the left mouse button.

MV_4108_03_en Vers.: 28.01.2021 99/120


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

15.2 Configuration in Designtime Mode


The IMSCP3DChart shows cross profile data. These data are bound to the chart via the property
Dataseries.Values. The data source can be database fields or other controls of the data type
IMSQDBDataTypes.CrossProfiles.

Further setting possibilities for the chart are described in chapter 15.3.

15.3 Description of Properties

Property Type S B P Description


Perspective Float × Perspective
RotX Integer × × X-axis rotation
RotY Integer × × Y-axis rotation
RotZ Integer × × Z-axis rotation
XScale Float × X-axis stretch factor
YScale Float × Y-axis stretch factor
AxisXScaleMode × × DataMinMax:
Automatic scaling to the maximum and minimum
values of the data.
Manual:
No automatic scaling, the scale is always on
XMinMan and XMaxMan.
Database:
Automatic scaling to the values linked with
XMinDB and XMaxDB.
AxisXTitle String × X-axis label
XMaxMan Float × × Upper end scale value
XMinMan Float × × Lower end scale value
XMaxDB Float × Upper end scale value from the database
XMinDB Float × Lower end scale value from the database
XScaleStepWidth Float × Step width of the shift on the x-axis
AxisYScaleMode × × DataMinMax:
Automatic scaling to the maximum and minimum
values of the data.
Manual:
No automatic scaling, the scale is always on
YMinMan and YMaxMan.
Database:
Automatic scaling to the values linked with
ZMinDB and ZMaxDB.
AxisYTitle String × Y-axis label
YMaxMan Float × × Upper end scale value

100/120 Vers.: 28.01.2021 MV_4108_03_en


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

Property Type S B P Description


YMinMan Float × × Lower end scale value
YMaxDB Float × Upper end scale value from the database
YMinDB Float × Lower end scale value from the database
YScaleStepWidth Float × Step width of the shift on the y-axis
AxisZScaleMode × × DataMinMax:
Automatic scaling to the maximum and minimum
values of the data.
Manual:
No automatic scaling, the scale is always on
ZMinMan and ZMaxMan.
Database:
Automatic scaling to the values linked with
ZMinDB and ZMaxDB.
AxisZTitle String × Z-axis label
ZMaxMan Float × × Upper end scale value
ZMinMan Float × × Lower end scale value
ZMaxDB Float × Upper end scale value from the database
ZMinDB Float × Lower end scale value from the database
ZScaleStepWidth Float × Step width of the shift on the z-axis
Dataseries.Values × Cross profile data

MV_4108_03_en Vers.: 28.01.2021 101/120


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

16 ExportTable
The ExportTable is a control that exports the contents of a configured table to a CSV file.

Properties and Possibilities


• Export of data to a text file
• Use of data bindings over multiple datasets
• Editing of data values in expressions
• Formatting of data values
• Different colouring of the cells through binding of colour information

16.1 Control Elements

In runtime mode the ExportTable can save the displayed table values in a file. To save data, the context
menu must first be opened by right-clicking.

After selecting the menu item Export, the Save dialogue is opened, where the storage location and file
name are specified. After pressing the Save button, the CSV file with the data from the table is saved.

102/120 Vers.: 28.01.2021 MV_4108_03_en


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

16.2 Configuration in Designtime Mode


Any number of data columns can be created in a table in designtime mode.

Create Columns

A column is created with the button to the right of the property ColumnValues in the properties window.
Clicking this button opens the column dialogue.

In this dialogue you can add new columns to the end of the list or delete existing columns with the Add
and Remove buttons on the left side. The order of the columns can be changed with the arrow buttons.

The properties of a column can be edited on the right side.

Acceptance of Data Bindings

When the columns have been configured, the columns must be supplied with data. To do so, open the
property ColumnValues in the bindings window. It contains a collection of columns. A database field can
then be bound to the property Value in a column. The data binding must either be a trend binding over
multiple datasets or the data are packed in an array list by an expression.

Binding to Other Controls

The properties SelectedIndex and SelectedValue in the source editor make the current index and
corresponding line object available to other controls. The event SelectionChanged makes the change
available to the other controls.

Apart from the context menu, the method DoExport can also be executed with a button control. For this,
the button event Click must be bound to the method, as a result of which the method is executed when
the button is pressed.

MV_4108_03_en Vers.: 28.01.2021 103/120


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

16.3 Description of Properties


Property Type S B P Description
ColSeperator String × The column separator for the CSV file
ColumnValues ColumCollection × × Collection of columns that can be filled in
designtime mode in accordance with the
number of columns needed.
SelectionBackColor Color × Background colour of a selected line
SelectedRow Int × × Index of the selected line

Methods Type S B P Description


DoExport Bool × Starts the export to a CSV file

ColumnCollection
Property Type S B P Description
Headline String × Column header
FormatString String × Format string for the display of floats
Values ArrayList × Data binding
BackColor ArrayList × Data binding for the background colours of
the cells
SelectedValue Object × × Setting of the line selection over a value or
reading out of the value of the selected line
SelectedIndex Int × Index of the selected dataset
Visible Bool × Make column invisible, e.g. QueryIndex

104/120 Vers.: 28.01.2021 MV_4108_03_en


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

17 TableControl
The TableControl is a control that shows contents from an IMS database in a table.

Properties and Possibilities:


• Display of data in a table
• Line and column headings

17.1 Control Elements


In runtime mode the TableControl only shows data and offers no other setting possibilities.

17.2 Configuration in Designtime Mode

Fill Columns

Using the property ColArrays, it is possible to bind an array element, e.g. as database field from the
database, to every column.

17.3 Description of Properties


Property Type S B P Description
ColArrays String × × Column data
ColCaptions Q2Lib.Table.CaptionCollection × Column headers
RowCaptions Q2Lib.Table.CaptionCollection × Line headers
DisplayOnlySelectedRow Boolean ×

MV_4108_03_en Vers.: 28.01.2021 105/120


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

18 CoilDataView

The CoilDataView is a control that shows and exports contents from an IMS database.

Properties and Possibilities


• Display of data
• Export of data to CSV and XLSX format

106/120 Vers.: 28.01.2021 MV_4108_03_en


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

18.1 Control Elements


When the DataViewer is running in runtime mode, the CoilDataView control is filled automatically with
data from the main query being executed.

These data can be scalar values as well as length and cross profiles. To show the profiles, check Show
Blobs. The system whose data are shown is selected with the selection box System.

The list on the left lists the time stamps of all datasets selected in the main query, while the section on
the right shows the values of the selected time stamp. The values that are to be exported can also be
selected here. If the selection box Hide null values is checked, all empty scalar values are hidden.

The Export button opens a dialogue with which the selected data can be exported.

The Export dialogue first shows the storage location of the file that is to be exported. The storage
directory can be entered directly in the text box or defined with the dialogue Find folder. The file name
always begins in the format Year-Month-Day-Hour-Minute-Second of the current date. The file name
can be extended optionally with scalar values if the corresponding names are selected in the selection
box.

MV_4108_03_en Vers.: 28.01.2021 107/120


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

The export type defines the file format as well as the type of data to be exported:

Excel (*.CSV) Export all datasets of the selected values to a CSV file. A
CSV file with all selected length profiles is generated per
dataset. A CSV file with a cross profile is generated per
dataset. Every cross profile is saved in a separate file.

Excel (*.CSV) Trend Export all datasets of the selected values to a CSV file. All
datasets of every selected length profile are exported to a
file. Cross profiles are not exported.

Excel Workbook (*.XLSX) Exports the selected values to an XLSX file for every
dataset. The values, length profiles and cross profiles each
appear in a separate Excel worksheet.

Excel Workbook Trend (*.XLSX) Exports all datasets of the selected values to a XLSX file.
The length profiles appear in a separate Excel worksheet.
Cross profiles are not exported.

IMS Data File (*.TM1) Exports all values to a TM1 file. The selected length and
cross profiles are also saved in the TM1 file. A TM1 file is
generated for every dataset.

Value formats are defined next:

CSV column delimiter The column separator for CSV files.

Decimal places The number of decimal places for a fixed-point number.

Date format The following date formats are possible:


• ISO8601 (yyyy-MM-ddTHH:mm:ss)
• Short date
• Long date
• Long date and time without seconds
• Long date and time with seconds
• Short date and time without seconds
• Short date and time with seconds

Export culture Culture for the format of numbers and date/time values.

The length unit of the length profiles and the width and length units of the cross profiles are not saved
in MEVInet-Q. If a specific unit is needed for the export data, it can be defined manually. It must be
noted that definition of a unit applies to all the profiles that are to be exported.

108/120 Vers.: 28.01.2021 MV_4108_03_en


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

18.2 Configuration in Designtime Mode


The default settings of the export dialogue can be modified in designtime mode. For this, the properties
from chapter 18.3 must be adjusted.

18.3 Description of Properties

Property Type S B P Description


CSVColumnDelimiter String × Column separator for CSV files
ExportCulture String × Culture that determines the format of
numbers and date/time values, e.g. de-DE
or en-US.
FormatString String × Format for numerical values The default is
F6, a fixed-point number with 6 decimal
places.
ExportFileType String × File format in which the data are exported.
The following formats are supported:
CSV
CSVTrend
XLSX
XLSXTrend
TM1
ExportFolder String × Directory to where the data are exported.

MV_4108_03_en Vers.: 28.01.2021 109/120


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

19 FaultPositionTable

The FaultPositionTable is a control that shows three coil regions in a table.

Properties and Possibilities


• Display of three regions limited by a lower and upper limit value.
• Percentages inside and outside the limits.

19.1 Control Elements


In runtime mode the FaultPositionTable only shows data and offers no other setting possibilities.

19.2 Configuration in Designtime Mode

Create Data Bindings

It is first necessary to bind the nominal value and the lower and upper limits from the database to the
properties NominalValue, RelLowerLimit and RelUpperLimit. Then the measured value series can be
bound to the property Value as length profile. Since the units are processed in the control, no units may
be defined in the bindings because otherwise the values will be calculated incorrectly.

110/120 Vers.: 28.01.2021 MV_4108_03_en


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

19.3 Description of Properties


Property Type S B P Description
DestLengthUnitImpe String × US destination unit of the coil length
rial
DestLengthUnitMetri String × Metric destination unit of the coil length
c
DestValueUnitImperi String × US destination unit of the measured value
al
DestValueUnitMetric String × Metric destination unit of the measured value
SrcLengthUnit String × Source unit of the coil length
SrcValueUnit String × Source unit of the measured value
NominalValue Float × × Nominal value
RelLowerLimit Float × × Relative lower limit
RelUpperLimit Float × × Relative upper limit
UseOnlyFilets Boolean × × Shows only the filet of the coil
Value LengthProfiles × Material as length profile

MV_4108_03_en Vers.: 28.01.2021 111/120


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

20 StatisticDataPicker
The StatisticDataPicker is a control that performs a statistical evaluation of measured values over time.

Properties and Possibilities


• Grouping of measured values over time with display in a candlestick chart.
• Display of the measured values of a candlestick in MultiChart.
• Display of the raw data in MultiChart.

20.1 Control Elements


The StatisticDataPicker performs a statistical evaluation when a dataset in the DataViewer changes or
when started with the Update property.

The Clear button deletes the text in the information box.

112/120 Vers.: 28.01.2021 MV_4108_03_en


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

20.2 Configuration in Designtime Mode

Configuration of StatisticDataPicker and BarChart

The StatisticDataPicker processes its evaluation as candlesticks. To display the candlesticks, a


BarChart must be placed on the DataViewer page and the name of the BarChart entered at the
StatisticDataPicker property Chart. The BarChart is then supplied automatically with data from the
StatisticDataPicker.

The necessary time stamps and measured values are taken over with a data binding at the properties
TimeStamps and Values. Here it must be ensured that the selection in the binding is set on All of
selection (*-binding) so that all datasets of the current query are included.

Display of Raw Values

The StatisticDataPicker property CompleteValues can be used as source for a MultiChart. For this, a
length profile chart must be created in the MultiChart and the property CompleteValues bound to the
property Value. So that the new result is taken over when there is a change in the StatisticDataPicker,
the event gotNewData must also be bound to the property Value.

Display of the Values of a Candlestick

The measured values of a selected candlestick are obtained from the BarChart as LengthProfile. For
this, select the BarChart as source and use the property SelectedCandle. You can then, for example,
create a histogram using an expression. The event selectedCandleChanged must also be used in the
binding.

Recalculation of Statistical Values

If the Click event of a button is bound to the method UpdateStatisticData, the StatisticDataPicker will
restart its calculations when the event occurs.

MV_4108_03_en Vers.: 28.01.2021 113/120


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

20.3 Description of Properties


Property Type S B P Description
Interval Enum × × The time interval for a candle:
Year Year
HalfYear Half year
QuartYear Quarter year
Month Month
Week Week
Day Day
Shift Shift
Hour Hour
NoiseReduction Float × × Percentage of the values that are not shown in
the candlestick. The largest and smallest x% are
ignored.
useMainQuery Boolean × The main query is used.
Chart String × Name of the BarChart where the data are to be
shown.
LegacyChartCom Boolean × × Invalid values in the result of CompleteData
patibility contain float.NaN. If this switch is set to true,
values are replaced by 0 to achieve compatibility
with old charts that cannot process NaN.
RemoveEmptyCa Boolean × × Empty candlesticks are not shown
ndles
Begin DateTime × × Start date for an own query
End DateTime × × End date for an own query
MainQueryConfig String × Configuration file with the ending QRY
uration
masterTable String × Database table for an own query
TimeStamps DateTime × Date values
Values ArrayList × Candlestick values
CompleteValues LengthProfile × Raw values

Method Parameters Description


UpdateStatisticDataPicker Executes the statistical calculations.

Event Description
gotNewData Is triggered when a new statistical calculation has been
executed.

114/120 Vers.: 28.01.2021 MV_4108_03_en


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

21 QueryControl
The QueryControl is a control with which a main query can be created and executed to retrieve data
from the long-term data storage system.

Properties and Possibilities


• Freely configurable database query.
• The result of the query is taken over automatically by other controls.

21.1 Control Elements

Create Query

To carry out a data query, at least one data field must be pulled on to the QueryControl from the
DataViewer field selection area by drag & drop or a predefined query must be loaded via the File menu
of the context menu. Creation of a query is described in detail in the user manual.

Context Menu in Query Area

Settings for the main query can be made in the QueryControl context menu.

Execute query Runs the current query.


Mark all for output Switches the output selection marks for all fields on.
Date preview Sets all date fields with the operator “>=” to the current date and 00:00
when the query is opened. As a result it is possible to always query the
current day.
Join tables Generates the complete cross product of the data for queries over several
gauges. This setting is used for service purposes.
Display Submenu for selection of various display options.
Load Query File... Opens a dialogue for loading of a query.

MV_4108_03_en Vers.: 28.01.2021 115/120


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

Submenu Display

Show gauge column Shows or hides the column with the gauge name.
Show display names Shows the alternative field names. These names can be stored in the
of fields database for every field for better understandability. If this option is
disabled, the name of the database field is shown instead.

21.2 Configuration in Designtime Mode


The QueryControl is not configured in designtime mode. The database query is only created or loaded
in runtime mode.

116/120 Vers.: 28.01.2021 MV_4108_03_en


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

22 QueryResultTable
The QueryResultTable is a control that shows the result of a main query on a DataViewer page.

Properties and Possibilities


• Sorting of columns in ascended and descending order.
• Selection and export of datasets.

22.1 Control Elements


The datasets of the QueryResultTable can be selected/deselected in a selection box. With this function
it is possible to select a single dataset or a number of datasets. The buttons in the top part of the results
area support simultaneous selection and deselection of all datasets and inversion of the selected
datasets. Further settings are possible with the QueryResultTable context menu.

Context Menu in Results Area

Edit format string... Opens a dialogue for formatting of numerical and date values. If this option
is dimmed, the content of the column cannot be formatted. The column
concerned is shown in green.
Show Submenu for gauges.
Columns Submenu to enable/disable automatic arrangement and width of columns.
Extras Submenu for various additional functions.

MV_4108_03_en Vers.: 28.01.2021 117/120


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

Submenu Show

Gauges Adds the names of gauges in the table headings. This makes it possible to
distinguish between identical variables of different measuring systems.

Submenu Columns

Sort automatical When this option is enabled, the columns are arranged in the same order
as configured in the query. This option is disabled when columns are
moved.
Autosize Sizes the columns so that all values in them are shown completely. This
function is disabled when column widths are changed manually.

Submenu Extras

Export all results... Exports the results being shown to a CSV file.
Export selected Exports only selected datasets to a CSV file.
results...
Restore default settings Resets all column sorting, widths and formatting to the default settings.

118/120 Vers.: 28.01.2021 MV_4108_03_en


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

22.2 Configuration in Designtime Mode


The menu items in the context menu can be configured directly in designtime mode via their properties
(see chapter 22.3).

A column separator can additionally be defined for table export to a CSV file with the property
ColumnSeparator.

22.3 Description of Properties


Property Type S B P Description
AutoSizeColmns Boolean × Automatic adjustment of the column width to the
column contents
AutoSortColmns Boolean × Automatic column sorting
ColumnSeperator String × Column separator for CSV export
ShowGaugeName Boolean × Display of the gauge name in the header

MV_4108_03_en Vers.: 28.01.2021 119/120


Programming Guide – MEVInet-Q2 – DataViewer – Control-Reference

23 BackColorExtender

The BackColorExtender is a component that provides other controls with an additional property for
printing. The background colour of the controls is normally not printed to save printing costs. The
BackColorExtender makes it possible to decide whether the background colour of a control is to be
printed or not.

23.1 Control Elements


The BackColorExtender is not shown in runtime mode.

23.2 Configuration in Designtime Mode


The BackColorExtender component does not have any properties of its own that need to be configured.
By dragging the BackColorExtender on to a DataViewer page, all controls on the page are given the
additional property PrintBackColor. The default setting for this property is False, i.e. the background
colour on printing is white. If the property is set to True, the property BackColor of the control is used.

23.3 Description of Properties

Property Type S B P Description


PrintBackColor Boolean × Additional property for a control with the values:
False: The background colour is white on
printing.
True: The colour of the property BackColor is
used on printing.

120/120 Vers.: 28.01.2021 MV_4108_03_en

You might also like