SignatureCapture.PointArray Property (POS for .NET v1.12 SDK Documentation)

2/27/2008

Holds the signature captured from the device.

Namespace: Microsoft.PointOfService
Assembly: Microsoft.PointOfService (in microsoft.pointofservice.dll)

Syntax

'Declaration
Public MustOverride ReadOnly Property PointArray As Point()

public abstract Point[] PointArray { get; }

public:
virtual property array<Point>^ PointArray {
    array<Point>^ get () abstract;
}

/** @property */
public abstract Point[] get_PointArray ()

public abstract function get PointArray () : Point[]

Remarks

PointArray consists of an array of (x, y) coordinate points. Each point is represented by four characters: x (low 8 bits), x (high 8 bits), y (low 8 bits), y (high 8 bits).

A special point value is (0xFFFF, 0xFFFF), which indicates the end of a line (that is, a pen lift). Almost all signatures include more than one line.

If the RealTimeDataEnabled property is false, PointArray contains the entire captured signature. If the RealTimeDataEnabled property is true, PointArray contains at least one point of the signature. The actual number of points delivered at one time is implementation-dependent. The points from multiple data events are logically concatenated to form the entire signature, such that the last point from a data event is followed immediately by the first point of the next data event.

The point representation definition is the same if the signature is presented as a single PointArray or as a series of real-time PointArrays.

To reconstruct the signature, a line is drawn from the first point in the signature to the second point, then to the third, and so on. When an end-of-line point is encountered, the line ends, and the next line is drawn beginning with the next point. An end-of-line point is assumed (but need not be present in PointArray) at the end of the signature.

PointArray is set just before delivering the DataEvent, or by the EndCapture method.

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread-safe. Any instance members are not guaranteed to be thread-safe.

See Also

Reference

SignatureCapture Class
SignatureCapture Members
Microsoft.PointOfService Namespace
RawData