Table

Description: This statement displays an array of numbers or text on the screen with the same formatting capabilities as the Output statement.

Returns: Nothing

Usage: Steady State

Format: Table(ArrayElem, N, X, Y, DX, DY, Type, Width, Precision, Color, Fill, Background, Size, Rotation)

Parameters: ArrayElem { Array element } { required } { no default: }

Any numeric or text array element giving the starting point in the array from which to display the data. The subscript for the array may be any numeric expression. Unless specified, the lowest dimension of a multidimensional array is used.

N { numeric } { required } { no default: }

Any numeric expression giving the number of array elements to display starting at the element given by the first parameter.

X { numeric } { required } { no default: }

Any numeric expression giving the X screen coordinate of the lower left corner of the first number or text on the screen.

Y { numeric } { required } { no default: }

Any numeric expression giving the Y screen coordinate of the lower left corner of the first number or text on the screen.

DX { numeric } { required } { no default: }

Any numeric expression giving the X offset in screen coordinates between each successive array element displayed. This may be positive, negative or 0.

DY { numeric } { required } { no default: }

Any numeric expression giving the Y offset in screen coordinates between each successive array element displayed. This may be positive, negative or 0.

Type { numeric } { required } { no default: }

Any numeric expression giving the type of the data to display. The valid values for this parameter are:

Type	Display
1	Short
2	Long
3	Float
4	Text
5	Binary
6	Octal
7	Hexadecimal

Status variables can be output using a Type value of 1 which will produce either a 0 or 1 on the screen. The type of the Value parameter does not have to match the Type parameter except for text.

Width { numeric } { required } { no default: }

Any numeric expression giving the minimum number of characters to display. If fewer characters are required to produce the output, the area is filled with blank spaces on the left to make up the required number of characters. This is useful for aligning numbers up on the right. If more characters are required than the width parameter specifies, the extra characters are extended to the right. By making Width zero, the output will be aligned on the left.

If the Width parameter is greater than or equal to 100 and the Type parameter is 3, the format of the floating point number displayed is in the most compact form which may be in exponential form if the exponent is less than -4 or is greater than the specified Precision parameter. The actual width used in this mode is 100 less than the specified width. Trailing zeroes are not displayed in this mode.

Values of Width outside the range of 0 to 255 inclusive are invalid.

Precision { numeric } { required } { no default: }

Any numeric expression giving the precision of the output. This has different meanings for the different output types.

For types 1 and 2 (short and long), it gives the minimum number of digits to appear. If fewer digits are required to display the number, leading zeroes are added to the number.

For type 3 (float), it gives the number of digits to appear after the decimal point if Width is less than 100. If Width is greater than or equal to 100, it specifies the maximum number of significant digits to appear.

For type 4 (text), it gives the maximum number of characters to display. If the string is longer than this parameter, only the number of characters given by the Precision parameter are displayed.

Values of Precision outside the range of 0 to 255 are invalid.

Color { numeric } { required } { no default: }

Any numeric expression giving the color of the characters to be displayed.

Fill { numeric } { required } { no default: }

Any numeric expression giving the color of the interior of large characters. This parameter is ignored for small characters.

Background { numeric } { required } { no default: }

Any numeric expression giving the color of the background area for the output characters.

Size { numeric } { required } { no default: }

Any numeric expression giving the height of the characters in units of Y screen coordinates. If this value results in a specification of less than 12 screen pixels high, the text will be the small text (8 pixels high); otherwise, the text will be the large text.

Rotation { numeric } { required } { no default: }

Any numeric expression giving the orientation of the output. A value of 0 specifies normal left to right horizontal output. The number gives the multiples of 90 degree counterclockwise rotations for the output. For example, a value of 1 would have a vertical output reading from bottom to top. Only the portion of Rotation before the decimal point is significant.

Comments: For small characters, the statement is non-destructive (can change without destroying underlying image). Large character output is destructive. For non-destructive out put, care must be taken when choosing the colors on a colored (non-zero) background since the characters are exclusive ORed with the background.

Example:

Table(resinWeight[0] { Starting array element },

5 { Number of elements to display },

10, 10 { Lower left corner, first text line },

0, 10 { Display in descending vertical row },

3 { Floating point numbers },

7 { Minimum number of characters },

2 { Number of decimal places },

15, 0, 0 { White on black background },

0, 0 { Minimum text size, no rotation });

This displays a list of 5 numbers, each in the format $image\Number_Hatch.gif$ $image\Number_Hatch.gif$ $image\Number_Hatch.gif$ $image\Number_Hatch.gif$ . $image\Number_Hatch.gif$ $image\Number_Hatch.gif$ . The first number (resinWeight[0]) is shown with the lower left corner at (10, 10). The second number (resinWeight[1]) is shown with lower left corner at (10, 20).