uProcessFlags

Flags that determine the behavior of the smoothing process. Flags may be combined using a bitwise OR . Possible values are:

 

Value

Meaning

 

SMOOTH_SINGLE_REGION:

For each bump or nick found by the Smooth method, if the DocCleanSuccess property is set to SUCCESS_REMOVE in the Smooth event, the removed bump or nick is added to an internal single region. If the DocCleanSuccess property is set to SUCCESS_NOREMOVE, the bump or nick is not added to the single region. When the Smooth method returns, either the DocCleanBitmap property or the hDocCleanRgn property will reference a region that contains all the removed bumps or nicks. If SMOOTH_LEAD_REGION is also set, the DocCleanBitmap will be updated with a bitmap that has a LEAD region that contains all the removed bumps or nicks. If SMOOTH_LEAD_REGION is not set, the hDocCleanRgn property is set to a Windows region that contains all the removed nicks or bumps. When the region (either LEAD or Windows) is no longer needed, it must be destroyed.

 

SMOOTH_LEAD_REGION

When the Smooth method returns, the DocCleanBitmap property is updated with a copy of the bitmap that also contains a region with all the removed bumps or nicks. This flag must be used in conjunction with SMOOTH_SINGLE_REGION. To use this flag set uProcessFlags to SMOOTH_SINGLE_REGION | SMOOTH_LEAD_REGION. The DocCleanBitmap property will be updated when the Smooth method returns.

 

SMOOTH_IMAGE_UNCHANGED

The original image is unchanged.

 

SMOOTH_FAVOR_LONG

Processes long bumps or nicks before short bumps or nicks. If this flag is not passed, short is favored over long. For example:

 

 

Smooth the following image with nLength == 3

 

X X 

 

XXXXXXXXXX

 

Favoring short would remove the two "bumps" giving:

 

XXXXXXXXXX

 

Favoring long would fill in the "gap" giving:

 

XXXXX 

 

XXXXXXXXXX