Newton Developer Technical Information: Newton Programmer's Guide: 2.1 OS Addendum /

Chapter 6 - Drawing and Graphics 2.1 / Drawing and Graphics Reference

Functions and Methods /

GetPointsArrayXY

GetPointsArrayXY(unit)

Returns an array of points extracted from the specified unit.

unit

A unit passed to the ViewWordScript, ViewShapeScript, ViewStrokeScript, and ViewGestureScript methods.

return value

An array of points.

DISCUSSION

The array that this function returns consists of coordinate pairs describing the points. The first element contains the x coordinate of the first point, the second element contains the y coordinate, and so on. The existing function GetPointsArray returns a similar array with the points in y,x order. Coordinates are global; that is, they are relative to the upper-left corner (0, 0) of the screen.

If the unit encapsulates multiple strokes, this function returns points from the first stroke.