• No results found

DataFontSize is used to override the “default” font size specified from the Fonts property tab

data marker is off

6.3 Chart Control Description

This section describes the charting controls that can be used on iPendant.

6.3.1 Bar Chart Control

Explanation

A Bar Chart control presents data in the familiar format of 2-dimensional bars.

Each bar represents a separate channel with specific characteristics to uniquely identify it.

A legend is supplied to identify the channel by name and optionally show the current value.

The current limitation supports monitoring up to 6 channels simultaneously.

Each bar (channel) is scaled evenly across the sample axis.

DataScaleMarkers can be placed on the chart sample scale. These are independent, 4 for each channel.

Data types that can be monitored are specified by the channel source as native controller data type. These are monitored at set intervals and converted internally from their native data type to floating point.

Property

Property can be divided into the groups shown below.

This first group should be considered static and not changed once the control is created:

id Specifies an ID string.

height Specifies the height in pixels or %.

width Specifies the width in pixels or %.

CtlType Specifies chart control.

FastLoad used internally by property editor.

ChartType Specifies the chart type, Bar or Line FontSize Specifies the default font size.

101

Name Specifies the name to relate to a KAREL program.

Pipe Specifies the name of the pipe file.

Orientation Specifies orientation as horizontal or vertical.

ForeColor Specifies the default foreground color.

BackColor Specifies the background color.

TrueFont Indicates that enhanced font control is used The following may be change dynamically:

Annotate Specifies the annotation text string to display.

AnnotateFontSize Specifies the font size for the annotate text.

AnnotateFont Specifies multiple font characteristics . Caption Specifies the annotation text string to display.

CaptionFontSize Specifies the font size of the caption text.

CaptionFont Specifies multiple font characteristics for the caption LabelFontSize Specifies the font size of the channel label text.

LabelFont Specifies multiple font characteristics for the label DataFontSize Specifies the font size of the channel data value.

DataFont Specifies multiple font characteristics for the data Border Specifies the border thickness in pixels of the control.

DataScale Specifies the data scale extents.

GridType Specifies the grid type, whole lines or ticks.

GridColor Specifies the default gridline color.

DataGrid Specifies data scale grid increments.

DataShowValues Specifies that data value be displayed in the legend.

DataFormat Specifies the ‘C’ format for the display of the data values.

DataScaleFormat Specifies the ‘C’ format for the DataScale extents and markers.

ChanMonRate Specifies the default rate for channel monitors in milliseconds.

PipeMonRate Specifies the pipe file monitor rate in milliseconds.

CmdMonRate Specifies the CmdStr variable monitor rate in milliseconds. (Currently set the same as PipMonRate).

Verbose Specifies some verbose text if = 1.

ch_Data_N Specifies a comma separated data stream, N repeating channels per sample.

The following can occur 1 per channel N:

chN_Name Specifies the text label for the channel legend.

chN_Color Specifies color of the channel.

chN_Source Specifies the source to start a monitor on the controller.

chN_Rate Specifies the monitor rate in milliseconds.

chN_State Specifies if the channel is active, on or not.

chN_Spread not implemented.

chN_Data Specifies a comma separated data stream for the channel.

chN_AutoRange Specifies that the channel should auto range.

chN_DataMarkerN Specifies one of 4 markers along the data scale.

102

MAROBCG8304141E REV. A 6.3.2 Line Chart Control

Explanation

A Line Chart control presents data in the familiar format that is similar to an oscilloscope trace.

A chart can have independent graphs of each channel in a ‘stacked’

fashion, or can have all channels overlaid on one graph. When the channels are overlaid one channel can be selected to have its DataScale displayed, in this case the data scale is displayed in the color of the active channel. Otherwise, the DataScale is displayed in the Chart control’s default ForeColor.

When displayed in stacked mode, the channels are evenly sized and distributed over the display area of the control.

A legend is supplied to identify the channel by name and optionally show the current value.

The current limitation supports monitoring up to 6 channels simultaneously.

All channels share a common sample axis.

DataScaleMarkers can be placed on the chart sample scale. These are independent, 4 for each channel.

Up to 4 Sample Scale markers can be places on the Chart. These are common to all channels.

Data types that can be monitored are specified by the channel source as native controller data type. These are monitored at set intervals and converted internally from their native data type to floating point.

Property

Property can be divided into the groups shown below.

This first group should be considered static and not changed once the control is created:

id Specifies an ID string.

height Specifies the height in pixels or %.

width Specifies the width in pixels or %.

103

CtlType Specifies chart control.

FastLoad used internally by property editor.

ChartType Specifies the chart type, Bar or Line FontSize Specifies the default font size.

Name Specifies the name to relate to a KAREL program.

Pipe Specifies the name of the pipe file.

Orientation Specifies orientation as horizontal or vertical.

ForeColor Specifies the default foreground color.

BackColor Specifies the background color.

TrueFont Indicates that enhanced font control is used The following may be change dynamically:

Annotate Specifies the annotation text string to display.

AnnotateFontSize Specifies the font size for the annotate text.

AnnotateFont Specifies multiple font characteristics . Caption Specifies the annotation text string to display.

CaptionFontSize Specifies the font size of the caption text.

CaptionFont Specifies multiple font characteristics for the caption LabelFontSize Specifies the font size of the channel label text.

LabelFont Specifies multiple font characteristics for the label DataFontSize Specifies the font size of the channel data value.

DataFont Specifies multiple font characteristics for the data Border Specifies the border thickness in pixels of the control.

LineWeight Specifies line thickness.

GridType Specifies the grid type, whole lines or ticks.

GridColor Specifies the default gridline color.

SampleScale Specifies the sample scale extents.

SampleGrid Specifies sample scale grid line increments.

SampleScaleAspect Specifies a multiplier for the SampleScale.

DataShowValues Specifies that data value be displayed in the legend.

DataFormat Specifies the ‘C’ format for the display of the data values.

SampleScaleFormat Specifies the ‘C’ format for the SampleScale extents and markers.

DataScaleFormat Specifies the ‘C’ format for the DataScale extents and markers.

LineScaleActive Specifies if Line chart(s) are overlaid or stacked, and if overlaid which channel is selected as the data scale.

SampleMarkerN Specifies one of 4 markers along the SampleScale.

SampleMarkerColor Specifies the default SampleMarker colors.

ChanMonRate Specifies the default rate for channel monitors in milliseconds.

PipeMonRate Specifies the pipe file monitor rate in milliseconds.

CmdMonRate Specifies the CmdStr variable monitor rate in milliseconds. (Currently set the same as PipMonRate).

Verbose Specifies some verbose text if = 1.

ch_Data_N Specifies a comma separated data stream, N repeating channels per sample.

The following can occur 1 per channel N:

104

MAROBCG8304141E REV. A

chN_Name Specifies the text label for the channel legend.

chN_Color Specifies color of the channel.

chN_Digital Specifies the channel is digital if 1.

chN_Source Specifies the source to start a monitor on the controller.

chN_Rate Specifies the monitor rate in milliseconds.

chN_DataScale Specifies the channels data scale extents.

chN_DataGrid Specifies data scale grid line.

chN_State Specifies if the channel is active, on or not.

chN_Spread not implemented.

chN_Data Specifies a comma separated data stream for the channel.

chN_AutoRange Specifies that the channel should auto range.

chN_DataMarkerN Specifies one of 4 markers along the data scale.