sb.polyString

    sb.polyString(x_values, y_values)
// OR
    sb.polyString({{x:, y:}, ...})

This is a higher performance function for generating a polygon string based on a set of numeric data points maintained in JS arrays.In the two argument form, the function receives as inputs two JS arrays whose content represents the numeric x and y data points to be converted to a string.In the single argument form, the function receives as input a single JS array whose content are objects with an "x" and "y" member values.The string returned is designed to be compatible with the Storyboard polygon plugin and is in the form of X1:Y1 X1:Y2 ...

Parameters

Parameter	Type	Description
x_values	number[]	An array containing numeric data for the x points.
y_values	number[]	An array containing numeric data for the y points.

OR

Parameter	Type	Description
xy_values	{x: number, y: number}[]	An array of objects where each object contains x and y members specifying the x and y points. Used instead of x_values and y_values.

Returns

Type	Description
string	A string that contains the x and y points in a format that can be used to set a data variable.

Example

    // Create a triangle polygon in a 100x100 square
    const x_points = { 0, 50, 100 };
    // Left, Middle, Right
    const y_points = { 100, 0, 100 };
    // Bottom, Top, Bottom
    var x_y_string = sb.polyString(x_points, y_points);
    print("X Y String: " + x_y_string);

    // Create the same triangle, but with x,y member variables
    const xy_points = [{x:0,y:100}, {x:50,y:0}, {x:100,y:100}];
    var xy_string = sb.polyString(xy_points);
    print("XY String: " + xy_string);