Flags

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

 

1. LEADRasterView.Raster will contain a region that contains all removed bumps or nicks. This is the case if the SMOOTH_LEAD_REGION has also been set. This region can be destroyed using the DeleteRgnHandle method of LEADRasterView.Raster or

 

2. the hDocCleanRgn property will reference a Windows region that contains all the removed bumps or nicks. This is the case if the SMOOTH_LEAD_REGION has NOT been set. When hDocCleanRgn is no longer needed, it must be destroyed.

 

When the region (either LEAD or Windows) is no longer needed, it must be destroyed.

SMOOTH_LEAD_REGION

This flag must be used in conjunction with SMOOTH_LEAD_SINGLE_REGION. If this flag is set, the LEADRasterView.Raster will contain a region that contains all removed bumps or nicks when the Smooth method returns. This region can be destroyed using the DeleteRgnHandle method of LEADRasterView.Raster.

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 iLength == 3

 

X X 

 

XXXXXXXXXX

 

Favoring short would remove the two "bumps" giving:

 

XXXXXXXXXX

 

Favoring long would fill in the "gap" giving:

 

XXXXX 

 

XXXXXXXXXX