Controls how the inner fillable area of unfilled but stroked paths is combined with the stroke area, if either kOutlineAddStrokes or kOutlineSubtractStrokes is set.
For example, assume an original path of a closed figure that contains another closed figure, which in turn contains another closed figure, with no fill and wide stroke:
+-------+
|+-----+|
||+---+||
||| |||
||+---+||
|+-----+|
+-------+
With kOutlineAlwaysIncludeFillArea set, but both stroke flags off, stroke is ignored and the outline is that of the fillable area:
+-----+
| |
| |
| |
+-----+
kOutlineAddStrokes only creates a filled compound path with a hole in the middle:
+-------+
| |
| +---+ |
| | | |
| +---+ |
| |
+-------+
With both kOutlineAddStrokes and kOutlineAlwaysIncludeFillArea set, the fill area is added to the stroke area:
+-------+
| |
| |
| |
| |
| |
+-------+
With both kOutlineSubtractStrokes and kOutlineAlwaysIncludeFillArea set, the fill area is added, and the stroke area is subtracted:
This can be used to get the inner region of a path, the part that would show in the fill color if it were filled.
With kOutlineSubtractStrokes only, the inner-area path is created on paths that are both filled and stroked, but paths that are stroked only are either stripped (if kOutlineEliminateUnpainted is on) or left alone (if it is off).
|