CLIPLINE structure (winddi.h)

The CLIPLINE structure gives the driver access to a portion of a line between two clip regions used for drawing.

Syntax

typedef struct _CLIPLINE {
  POINTFIX ptfxA;
  POINTFIX ptfxB;
  LONG     lStyleState;
  ULONG    c;
  RUN      arun[1];
} CLIPLINE, *PCLIPLINE;

Members

ptfxA

Specifies a POINTFIX structure that contains the starting point of the line.

ptfxB

Specifies a POINTFIX structure that contains the end point of the line.

lStyleState

Is a pair of 16-bit values supplied by GDI whenever the driver calls PATHOBJ_bEnumClipLines. These two values are packed into a LONG and specify the style offset back to the first pixel of the line segment. This is the first pixel that would be rendered if the line were not clipped. This value allows the styling for the remainder of the line to be computed. Refer to Styled Cosmetic Lines for additional information.

c

Specifies the number of RUN structures in the arun array.

arun[1]

Is an array of RUN structures. The RUN structures describe the start and stop portions of the clip line.

Remarks

The CLIPLINE structure is used by PATHOBJ_bEnumClipLines. The CLIPLINE structure contains the original, unclipped control points of the line segment.

See GDI Data Types for a description of the POINTFIX structure.

Requirements

See also

CLIPOBJ

GDIINFO

RUN