XYMBX,TABLE_HELP, XY-Chart
    XY-Chart Configuration

Task description:
The XY-Chart task allows the user to 
define charts on graphic displays, with full 
control over the X- and Y-axis.

Table description:
Table for defining the input Mailbox for the
task XY-Chart.

$
XYMBX,XYMBX,Mailbox Tag
Input Mailbox for the task XYCHART.

Entry: Required

Entry type: Standard tag name
Valid type: MAILBOX

XY-Chart receives commands/settings from the 
Graphics task, as there are mode, pan and zoom.
The Graphics task places the commands in the 
mailbox, out of which the task the commands 
reads.

$
XYDISP,TABLE_HELP, XY-Chart
        XY-Chart Configuration

Task description:
The XY-Chart task allows the user to 
define charts on graphic displays, with full 
control over the X- and Y-axis.

Table description:
Table for defining the (graphic) display / ob-
ject names / IDs on which XY-plot(s) are active. 
This table also includes entries for global 
chart functions.

$
XYDISP,CHARTNAME,XY-chart name
User defined name for a XY-chart.

Entry: Required

Entry type: ASCII string of up to 16 characters

XY-chart name, user defined. The entry is a se-
lection field for XY-plots on this chart. The 
XY-plots are defined in the next table.

$
XYDISP,DISP_NAME,Display name
Display name of graphic on which a XY-chart is
active.

Entry: Required

Entry type: ASCII string of up to 8 characters

Display name of a specific graphics display as 
defined in the "Application Editor".

$
XYDISP,OBJECTNAME,Chart Object
Object ID for a XY-chart.

Entry: Required

Valid entry: ASCII string of up to 16 characters

Object ID for a chart on a specific graphics dis-
play as defined in the "Application Editor".

$
XYDISP,CLRDRAW,Drawing mode
Mode for (re)drawing a XY-Chart.

Entry: Required

Entry type: Keyword
Valid entries:
                 NORMAL
                 MODE

Default Entry: NORMAL

Redrawing of a chart is done if an XY-plot has
changed, or a zoom / pan factor has changed and
no mode tag (chart definition) is specified.
In case a mode tag is specified, the tag can be
interpreted as an ON / OFF digital tag or as a
Trigger. This depends on the entry in this 
field.
The description below assumes that a digital tag
has been defined for the 'mode'.
The mode tag is defined with the "Application Edi-
tor" for the chart object.
In normal mode a chart is redrawn after the 
user changed an Y-value, zoom factor or a pan 
factor. 
If needed the user can start the redrawing only
demand (MODE) by forcing the mode tag to ON. 

$
XYDISP,CLEAR,Clear XY-chart
Trigger used to clear the XY-chart.

Entry: Optional

Entry type: Standard tag name
Valid type: DIGITAL

A XY-chart is cleared if the DIGITAL tag is for-
ced to the state ON. Clearing means that the 
chart as it is visible on a drawing is 'blank-
ed'. All the points defined for the different 
XY-plots remain untouched. 

$
XYDISP,YPAN,Pan Y-Direction
Dynamical pan factor for the Y-direction of 
the chart.

Entry: Optional

Entry type: Standard tag name
Valid type: ANALOG, FLOAT, LONGANALOG

The pan factor for the Y-direction is effective 
for a complete chart (so all the XY-plots are 
drawn with the actual setting). The pan factor 
is expressed as a percentage (0% until +100%) 
off the original range of every XY-plot on the 
chart.

$
XYDISP,YZOOM,Zoom Y-Direction
Dynamical zoom factor for the Y-direction of 
the chart.

Entry: Optional

Entry type: Standard tag name
Valid type: ANALOG, FLOAT, LONGANALOG

The zoom factor for the Y-direction is effective 
for a complete chart (so all the XY-plots are 
drawn with the actual setting). The zoom factor
is expressed as a percentage (+0% until +100%)
off the original range of every XY-plot on the 
chart.

$
XYDISP,TGLMIN,X-Legend Minimum
Static/Dynamic minimum for X-legend.

Entry: Optional

Entry type: Standard tag name
            Decimal number
Valid type: ANALOG, FLOAT, LONGANALOG

The actual minimum value will be corrected with
pan / zoom factor and written to the 'start' tag
defined by the chart animation.

$
XYDISP,TGLMAX,X-Legend Maximum
Static/Dynamic maximum for X-legend.

Entry: Optional

Entry type: Standard tag name
            Decimal number
Valid type: ANALOG, FLOAT, LONGANALOG

The actual maximum value will be corrected with
pan / zoom factor and written to the 'end' tag
defined by the chart animation.

$
XYDISP,ERRORTAG,Status XY-chart
Status output for every command.

Entry: Optional

Entry type: Standard tag name
Valid type: ANALOG

Tag in which a status value is placed after eve-
ry drawing, define/undefine, retrieve or file 
operation command. A value not equal to zero in-
dicates an error.

$
XYDISP,COMPLTAG,Completion
Completion trigger for every drawing command.

Entry: Optional

Entry type: Standard tag name
Valid type: DIGITAL

Value of tag is forced to ON after every drawing
command.

$
XYDEF,TABLE_HELP,DelaLink XY-chart
        XY-Chart Configuration

Task description:
The XY-Chart task allows the user to 
define charts on graphic displays, with full 
control over the X- and Y-axis.

Table description:
Table for defining the characteristics of a spe-
cific XY-plot.

$
XYDEF,XYNAME,XY-Plot
User defined name for a XY-color schema to be u-
sed for the selected XY-plot.

Entry: Required

Entry type: ASCII string of up to 16 characters

XY-color schema, user defined. The entry is a se-
lection field for the color definitions of XY-points
on a XY-plot.

$
XYDEF,TGPEN,Line Style
Line style for the XY-plot.

Entry: Required

Entry type: Standard tag name or Keyword
Valid tag type: ANALOG
Valid entries keyword:
                 NONE
                 SOLID
                 DOT
                 DASH
                 DASHDOT
                 BAR
                 NUM
                 NUMBAR

Default entry: SOLID

Line style used for drawing the X,Y points on 
a XY-plot. 
For a dynamic line style the value of the tag
should be:  0 <= value <= 7

$
XYDEF,TGMARKER,Marker Style
Marker style for the XY-plot.

Entry: Required

Entry type: Standard tag name or Keyword
Valid tag type: ANALOG
Valid entries keyword:
                 NONE
                 CIRCLE
                 DIAMOND
                 BOX
                 TRIANGLE
                 PLUS
                 CROSS
                 SDIAMOND
                 SBOX

Default Entry: NONE

Marker style used for drawing the X,Y points on 
a XY-plot. 
For a dynamic marker the value of the tag should
be:        0 <= value <= 8

$
XYDEF,TGINTPOL,Interpolation
Interpolation mode between defined X,Y points.

Entry: Required

Entry type: Standard tag name, Keyword
Valid tag type: ANALOG
Valid entries keyword:
                NONE
                LINE
                LINE_SEC
                LINE_BEGIN
                LINE_END
                POW2
                POW2_SEC
                POW2_BEGIN
                POW2_END
                SQRT2
                SQRT2_SEC
                SQRT2_BEGIN
                SQRT2_END
                POLY3
                POLY3_SEC
                POLY3_BEGIN
                POLY3_END
                HOLD 
                HOLD_SEC
                HOLD_BEGIN
                HOLD_END
                STEP
                STEP_SEC
                STEP_BEGIN
                STEP_END

Default Entry: LINE

If between two defined X,Y points not all points 
are defined, the points can be connected using 
the combination of line style and interpolation 
mode. The basic interpolations are: NONE, LINE, 
SQRT2, POW2, POLY3, HOLD and STEP. Meaning: no 
interpolation, line, square root, polynomial of 
third order, power 2, step and hold function.
The begin and or end section can be excluded 
from the interpolation, with the next characters 
added to the interpolation: 
       _SEC, _BEGIN, _END

The tag values allowed for a dynamic interpo-
lation are 0, 10, 20, 30, 40, 50, 60 for the 
basic interpolations. Add 1 for '_SEC', add 2 
for '_BEGIN', add 3 for '_END'.

$
XYDEF,XMIN,Minimum X-value
Minimum X-value for the XY-plot.

Entry: required

Entry type: Numerical value

The value determines the minimum X-value allowed
on this XY-plot.

$
XYDEF,XMAX,Maximum X-value
Maximum X-value for the XY-plot.

Entry: Required

Entry type: Numerical value

The value determines the maximum X-value allowed 
on this XY-plot.

$
XYDEF,YMIN,Minimum Y-value
Minimum Y-value for the XY-plot.

Entry: Required

Entry type: Numerical value

The value determines the minimum Y-value allowed 
on this XY-plot.

$
XYDEF,YMAX,Maximum Y-value
Maximum Y-value for the XY-plot.

Entry: Required

Entry type: Numerical value

The value determines the maximum Y-value allowed 
on this XY-plot.

$
XYDEF,YMINLEG,Y-Legend minimum
Dynamic minimum Y-axis for the XY-plot.

Entry: Optional

Entry type: Standard tag name
Valid type: ANALOG, FLOAT, LONGANALOG

The actual value of the minimum for the Y-axis
is written to the specified tag. The tag can 
be used for 'legend' animation's.

$
XYDEF,YMAXLEG,Y-Legend maximum
Dynamic maximum Y-axis for the XY-plot.

Entry: Optional

Entry type: Standard tag name
Valid type: ANALOG, FLOAT, LONGANALOG

The actual value of the maximum for the Y-axis 
is written to the specified tag. The tag can 
be used for 'legend' animation's.

$
XYDEF,TGVISIBLE,XY-Plot Visible
XY-Plot visible, ON or OFF.

Entry: Optional

Entry type: Standard tag name, Keyword
Valid type: DIGITAL
Valid entries keyword:
                 YES
                 NO

The XY-Plot is visible if the value of the tag 
is ON, or the keyword YES is specified. 
The XY-Plot will not be drawn on the chart if 
a tag in this field is specified and the value
is OFF, or the keyword NO is specified. 

$
XYDEF,CURVAL,Cursor Value
Output value on the cursor position.

Entry: Optional

Entry type: Standard tag name
Valid type: ANALOG, FLOAT, LONG ANALOG

Tag in which the Y-value is returned for the 
cursor position on the XY-chart.

$
XYDEF,SETX,Set X-Position
TAG (array) used to specify the X-values on a 
XY-plot.

Entry: Optional

Entry type: Standard tag name
Valid type: ANALOG, FLOAT, LONG ANALOG

For a tag array the first tag is the tag speci-
fied here, the length of the tag array conside-
red is specified in the column 'Set Dimension'.

A special case is defining points for relative 
X-positions, the Y-position tag-array will be 
placed on the XY-plot, starting with the first 
point of the XY-plot untill the last point of 
XY-plot or end of the tag array.
The relative X-positions are selected by omit-
ting a tag specification in this field, or wri-
ting a value in the first tag (specified in 
this field) of: 
               value < XMIN
$
XYDEF,SETY,Set Y-Position
TAG (array) used to set the Y-values on a XY-
plot.

Entry: Optional

Entry type: Standard tag name
Valid type: ANALOG, FLOAT, LONG ANALOG

For a tag array the first tag is the tag speci-
fied here, the length of the tag array conside-
red is specified in the column 'Set Dimension'.

Defining a Y-value: value >= YMIN.
Undefining a Y-value: value < YMIN.

Defining/Undefining is started if the change 
flag of the specified tag is ON and no entry 
is present in the field 'Set point'.

$
XYDEF,TGSETDIM,Dim
Length of the TAG array for X- and Y-Positions.

Entry: Required

Entry type: Standard tag name, Decimal number 
Valid tag type: ANALOG
Valid decimal entry : 1 .. 3600

$
XYDEF,CLEARALL,Clear points
Trigger used to undefine all X,Y points.

Entry: Optional

Entry type: Standard tag name
Valid type: DIGITAL

For the XY-plot all X,Y points are undefined if 
the tag is forced to 1 (ON).

$
XYDEF,SETPOINT,Set point
Trigger used to set the Y-values on a XY-plot.

Entry: Optional

Valid Entry: Standard tag name
Valid type: DIGITAL

If the tag is forced to the state ON, value(s)
for X and Y points are defined/undefined. If 
an entry is specified, defining/undefining is 
not started if the change flag of the TAG for 
'Set Y-position' is forced to 1 (ON).

$
XYDEF,XYCOMPL,Completion
Completion trigger for every define/undefine 
command.

Entry: Optional

Entry type: Standard tag name
Valid type: DIGITAL

Value of tag is forced to ON after every define/
undefine command.

$
XYDEF,RETX,Retrieve X-Position
TAG (array) used to retrieve the X-values on a 
XY-plot.

Entry: Optional

Entry type: Standard tag name
Valid type: ANALOG, FLOAT, LONG ANALOG

For a tag array the first tag is the tag speci-
fied here, the length of the tag array conside-
red is specified in the column 'Retrieve Di-
mension'.

Retrieving is started if the change flag of 
the specified tag is set to 1 (ON) (see also 
'Retrieve Point').

A special case is retrieving points for relati-
ve X-positions, the Y-position tag-array will 
be filled starting with the first point of the 
XY-plot until the last point of XY-plot or end
of the tag array.
The relative X-positions are selected by omit-
ting a tag specification in this field, or wri-
ting a value in the first tag (specified in 
this field) of: 
               value < XMIN

$
XYDEF,RETY,Retrieve Y-Position
TAG (array) used to specify the Y-values on a XY-
plot.

Entry: Optional

Entry type: Standard tag name
Valid type: ANALOG, FLOAT, LONG ANALOG

For a tag array the first tag is the tag spe-
cified here, the length of the tag array con-
sidered is specified in the column 'TAG Dim'.

Defined Y-value: value >= 0.
Undefined Y-value: value <= YMIN - 1.

$
XYDEF,TGRETDIM,Dim
Length of the TAG array for X- and Y-Positions.

Entry: Required

Entry type: Standard tag name, Decimal number 
Valid tag type: ANALOG
Valid decimal entry : 1 .. 3600

$
XYDEF,RETPOINT,Retrieve Point
Trigger used to retrieve the Y-values on a XY-
plot.

Entry: Optional

Entry type: Standard tag name
Valid type: DIGITAL

If the DIGITAL is forced to the state ON, va-
lue(s) for X- and Y-points are retrieved. If 
an entry is specified, retrieving is not star-
ted if the change flag of the TAG for 'Retrie-
ve X-position' is set to 1 (ON).

$
XYDEF,RETCOMPL,Completion
Completion trigger for every retrieve command.

Entry: Optional

Entry type: Standard tag name
Valid type: DIGITAL

Value of tag is forced to ON after every retrie-
ve command.

$
XYDEF,PATH,File Spec.
Specification of a XY-plot save file.

Entry: Optional

Entry type: ASCII string of up to 128 characters

A XY-plot can be saved to or restored from a 
'Batch Recipe' compatible file. In this field 
the static part of the filename, including di-
rectory, is specified. One format specifier can 
be included for dynamic filenames.

$
XYDEF,NAMTAG,File Spec. Variable
Format specifier tag for a XY-plot save file.

Entry: Optional

Entry type: Standard tag name
Valid Type: DIGITAL, ANALOG, FLOAT, LONG ANALOG, MESSAGE

A XY-plot can be saved to or restored from a 
'Batch Recipe' compatible file. In this field 
the dynamic part of the filename is specified.
The tag value is substituted into the static
part of the filename at run-time.

$
XYDEF,SAVETYPE,Save Points
All points, or just the defined ones can written 
to a XY-plot save-file.

Entry: Optional

Entry type: Keyword
Valid entries: ALL, DEFINED

$
XYDEF,FORMAT,Format
Format specifier for a XY-plot save file.

Entry: Optional

Entry type: Standard tag name
Valid type: DIGITAL, ANALOG, FLOAT, LONGANA

A XY-plot can be saved to or restored from a 'Batch 
Recipe' compatible file. In this field the stora-
ge type of the save file is defined.

$
XYDEF,RDTRIG,Read File
Trigger to start reading a XY-plot from a save-
file.

Entry: Optional

Entry type: Standard tag name
Valid type: DIGITAL

A XY-plot can be saved to or restored from a 
'Batch Recipe' compatible file. In this field 
the read file trigger is defined.

$
XYDEF,WRTRIG,Write File
Trigger to start writing a XY-plot to a save-
file.

Entry: Optional

Entry type: Standard tag name
Valid type: DIGITAL

A XY-plot can be saved to or restored from a 
'Batch Recipe' compatible file. In this field 
the write file trigger is defined.

$
XYDEF,FILECOMPL,File Completion
Completion trigger for every read/write file 
command.

Entry: Optional

Entry type: Standard tag name
Valid type: DIGITAL

Value of tag is forced to ON after every read/
write file command.

$
XYCLR,TABLE_HELP, XY-chart
        XY-Chart Configuration

Task description:
The XY-Chart task allows the user to 
define charts on graphic displays, with full 
control over the X- and Y-axis.

Table description:
Table for defining the colors for a specific XY-
plot.

$
XYCLR,TGVALUE,Limit value
Color-limit(s) used for XY-plot.

Entry: minimum nr. of entries required is one

Entry type: Standard tag name, Decimal value
Valid tag type: ANALOG, FLOAT, LONGANA

The value entered in this field is used in com-
bination with the color field. If the value in 
the Y-direction >= value entered, the defined
color is used for drawing all of the XY-points.

$
XYCLR,TGCOLOR,Color value
Color(s) used for XY-plot.

Entry: minimum no. of entries required is one

Entry type: Standard tag name, Keyword
Valid tag type: ANALOG
Valid entries keyword:
                  RED
                  ORANGE-RED
                  ORANGE
                  YELLOW-ORANGE
                  YELLOW
                  GREEN-YELLOW
                  YELLOW-GREEN
                  PALE-GREEN
                  GREEN
                  LIME-GREEN
                  SEA-GREEN
                  AQUAMARINE
                  CYAN
                  LIGHT_BLUE
                  SKY_BLUE
                  MEDIUM-BLUE
                  BLUE
                  MIDNIGHT-BLUE
                  CORN-BLUE
                  ORCHID
                  MAGENTA
                  PINK
                  CORAL
                  FIREBRICK
                  INDIAN-RED
                  SIENNA
                  BROWN
                  SANDY-BROWN
                  KHAKI
                  LIGHT-OLIVE
                  MED-OLIVE
                  DARK-OLIVE
                  SPRING-GREEN
                  FOREST-GREEN
                  DARK-GREEN
                  DARK-AQUAMARINE
                  TURQUOISE
                  CADET-BLUE
                  SLATE-BLUE
                  STEEL-BLUE
                  NAVY-BLUE
                  BLUE-VIOLET
                  VIOLET
                  DARK-ORCHID
                  RED-VIOLET
                  PLUM
                  MAROON
                  DARK-MAROON
                  BLACK
                  DARK-GRAY4
                  DARK-GRAY
                  DARK-GRAY3
                  DARK-GRAY2
                  DARK-GRAY1
                  GRAY6
                  GRAY5
                  GRAY
                  GRAY4
                  GRAY3
                  GRAY2
                  GRAY1
                  LIGHT-GRAY4
                  LIGHT-GRAY
                  LIGHT-GRAY3
                  LIGHT-GRAY2
                  LIGHT-GRAY1
                  WHITE


Default Entry: RED

The value entered in this field is used in com-
bination with the Y-value field. If the value in 
the Y-direction >= value entered, the defined
color is used for drawing all of the XY-points.

