createLineStrip()

Purpose

Create a series of lines between points

Description

Creates a line between any number of supplied points on screen to be drawn with drawShape()

Syntax

shape = createLineStrip( point1, point2, ... pointN )
shape = createLineStrip( points )

Arguments

shape Handle which stores the newly created shape

point1 Vector describing the position of the first point in the line

point2 Vector describing the position of the second point in the line

pointN Vector describing the position of the Nth point in the line (any number of points can be supplied)

points Array of vector points to draw lines between

Example

r = gheight() / 2
a = 0
points = []

for i = 0 to 20 loop
    x = gwidth()/2 + cos(a) * r
    y = gheight()/2 + sin(a) * r
    points[i] = {x, y}
    r -= 30
    a += 36
repeat

lineStrip = createLineStrip(points)
setShapeColour(lineStrip, white)

loop
    clear()
    drawShape(lineStrip)
    update()
repeat

Associated Commands