Line Plot Widget (LinePlot.class)

The Line Plot Widget is a live 2-dimensional line plot that represents a byte (or word) returned from an href function call. The x and y-axis' are drawn based on the width and height. The line plots from left-to-right, continuously wrapping and does not get erased upon the wrap. The plot is updated at each new x-sample and the current location is kept via a vertical cursor that is the same height as the y-axis. The plot is scaled in the y-direction based on yMin and yMax.

Line Plot Parameter Attributes:

Parameter="invisible" value="CHECKED" or "UNCHECKED" — Specifies if the Line Plot is to start out invisible or not. If the attribute is not present, then by default the Line Plot is visible. If the Line Plot starts out invisible, the only way to make it visible again is via the IWC method reappear().

Parameter="axisColor" value= See color entry conventions — Specifies the desired lineplot axis color. See section on colors for more information. If no axis color is specified, the default color is black. If the alpha is FF, then the axis color is fully opaque.

Parameter="backgroundImage" value="image" — Image used as the Line Plot background image. Image dimensions should be the same as the dimensions of the Line Plot Widget. Image file must be of type .GIF , .JPG, or .PNG. If no image specified, the default background will be the color specified in fillColor.

Parameter="cursorColor" value= See color entry conventions — Specifies the desired lineplot cursor color. See section on colors for more information. If no cursor color is specified, the default color is black. If the alpha is FF, then the cursor color is fully opaque.

Parameter="fillColor" value= See color entry conventions — Specifies the desired lineplot line color. See section on colors for more information. If no fill color is specified, the default color is white. If backgroundImage specified, fillColor is not used. If the alpha is FF, then the fill color is fully opaque.

Parameter="href" value="function" — The function called to retrieve the widget input. See Appendix B for all available functions for the Line Plot Widget. The function is called at an update rate specified by the updateRate attribute.

Parameter="lineColor" value=See color entry conventions — Specifies the desired lineplot line color. See section on colors for more information. If no line color is specified, the default color is black. If the alpha is FF, then the line color is fully opaque.

Parameter="lineWeight" value="pixels" — Defines the weight (thickness) of the active line plot in pixels. The range is 1- 7 (0x01 - 0x07).

Parameter="updateFreq" value ="number" — Specifies the href function call frequency (specified in seconds, with a single floating-point number). The range is 0.00 - 655.35. A value of 0.00 means update never.

Parameter="updateDelay" value ="number" — Specifies the delay time from when the page is loaded until the first href function call (specified in seconds, with a single floating-point number). The range is 0.00 - 655.35. If this number is not specified, then the
delay time defaults to the value of updateFreq.

Parameter="xSamples" value="number" — Number of samples along the horizontal x-axis. The range is 2 - 638 (0x02 - 0x27E). NOTE: The value must be less than the value specified in the WIDTH attribute of the tag.

Parameter="yMax" value="number" — Maximum value returned from the href function; must be greater than yMin. If the function returns a byte, the range is 1 - 255 (0x01 - 0xFF). If the function returns a word, the range is 1 - 65535 (0x01 - 0xFFFF).

Parameter="yMin" value="number" — Minimum value returned from the href function; must be less than yMax. If the function returns a byte, the range is 0 - 254 (0x00 - 0xFE). If the function returns a word, the range is 0 - 65534 (0x00 - 0xFFFE).

Optional Line Plot Parameter Attributes:

Parameter="noAxis" value="CHECKED" or "UNCHECKED" — Specifies if the Line Plot is to have an x and y axis. If the attribute is not present, then by default the Line Plot has an x and y axis.