DocumentDilate Method

Description

Examines pixels in the current image and expands the black ones by given amount in given direction.

Syntax

Visual Basic
Public Sub DocumentDilate( _ ByVal Amount As Integer, _ ByVal Direction As enumEnhancementDirection _ )

Parameters

Amount

The distance, in pixels, to extend the black pixels.

Range: 1 - 500

Default: 1

Direction

Value	Description
EnhancementDirectionAll	Enhance all directions.
EnhancementDirectionDown	Enhance down.
EnhancementDirectionLeft	Enhance left.
EnhancementDirectionLeftDown	Enhance left and down.
EnhancementDirectionLeftDownBoth	Enhance left, down, and diagonally left down.
EnhancementDirectionLeftUp	Enhance left and up.
EnhancementDirectionLeftUpBoth	Enhance left, up, and diagonally left up.
EnhancementDirectionRight	Enhance right.
EnhancementDirectionRightDown	Enhance right and down.
EnhancementDirectionRightDownBoth	Enhance right, down, and diagonally right down.
EnhancementDirectionRightUp	Enhance right and up.
EnhancementDirectionRightUpBoth	Enhance right, up, and diagonally right up.
EnhancementDirectionUp	Enhance up.

The direction to apply the dilation. Black pixels are expanded in this direction. Typically, this is set to a single direction, a pair of directions, or all directions.

Default: EnhancementDirectionAll

Remarks

This method validates the input, examines the pixels, expands the black pixels, and returns results from the detection and correction process.

The enumEnhancementDirection contains parameters that control the dilate process. If no parameters are provided, the current image has its black pixels expanded by one in all directions.

Outputs

ImagXpress validates the input, examines the pixels, expands the black pixels, and returns results from the detection and correction process. The current content may be modified. If the operation fails, the current image is un-changed.
IPImageWasModified is set to true if the image was modified, false if the image was not modified.

Using DocumentDilate

1. Load a 1 bit image from a file or stream input.

2. Call DocumentDilate.

3. The current image is dilated.

Note: Available in Professional Edition.