PATHOBJ_vEnumStartClipLines

VOID PATHOBJ_vEnumStartClipLines(

    IN PATHOBJ *ppo,

    IN CLIPOBJ *pco,

    IN SURFOBJ *pso,

    IN LINEATTRS *pla

   );

PATHOBJ_vEnumStartClipLines allows the driver to request lines to be clipped against a specified clipping region.

Parameters

ppo
Points to the PATHOBJ structure that describes the specified clipping object.
pco
Points to a CLIPOBJ structure that describes the clipping region.
pso
Points to a SURFOBJ structure that GDI queries to retrieve information about styling steps.
pla
Points to a LINEATTRS structure that GDI queries to retrieve line width and styling information.

Comments

This function is useful when the clip region is more complex than a simple rectangle.

PATHOBJ_vEnumStartClipLines performs calculations for cosmetic wide lines. If the LINEATTRS structure needs a cosmetic wide line, the enumeration walks the given path as many times as needed to complete the widened figure.

This function should not be called for geometric wide lines or paths that contain Bezier curves.

Once begun, this enumeration process should not be restarted.

See Also

CLIPOBJ, LINEATTRS, PATHOBJ, SURFOBJ