GpiStrokeInkPath

This is an undocumented function.

GpiStrokeInkPath takes an array of points, adds them to the current ink path, and displays them on the screen.

Unlike standard graphics path APIs, GpiStrokeInkPath does not destroy the path when called. This allows you to call it multiple times from within an active "ink path bracket" (after calling GpiBeginInkPath but before GpiEndInkPath), which makes the process faster and more efficient because the graphics subsystem manages the path instead of the application having to reprocess the entire path repeatedly.

Syntax

GpiStrokeInkPath (hps, lPath, lCount, aptlPoints, flOptions)

Parameters

hps (HPS) - input

The handle to the InkPS.

lPath (LONG) - input

The path identifier (which must be one).

lCount (LONG) - input

The number of points in the array.

aptlPoints (PPOINTL) - input

A pointer to an array of points.

flOptions (ULONG) - input

The stroke options.

The stroke options allow the path to be comprised of several disjoint strokes , like someone s signature. The options are:

PPS_INKDOWN signals the start of a new stroke

PPS_INKMOVE is the default option and is used in the middle of a stroke

PPS_INKUP signals the end of a stroke

Returns

rc (LONG) - return