MimZoneOfInfluence()函数

Synopsis

Perform a zone of influence detection.

Format

void MimZoneOfInfluence(SrcImageBufId, DestImageBufId, OperationFlag)

Description

This function separates an image into zones, according to how much of a blob’s surrounding background is within the blob’s territorial boundaries, or “zone of influence”. It gives every pixel in a blob’s zone of influence the same value. Starting from the top-left corner, zones of influence are given unique consecutive values beginning with the value 1. A blob’s zone of influence consists of all pixels closer to that blob than to any other blob. There are as many zones as blobs.

The SrcImageBufId parameter specifies the identifier of the data source of the operation. This parameter must be given an image buffer identifier.

The DestImageBufId parameter specifies the identifier of the destination of the resulting image. This parameter must be given an image buffer identifier.

The OperationFlag parameter controls the behavior of the operation and must be set to M_DEFAULT.

The destination buffer should be large enough to hold the maximum number of zones (blobs). For example, an 8-bit buffer can be used for a maximum of 254 blobs and a 16-bit buffer can be used for a maximum of 65534 blobs.

Note

This function is optimized for packed binary buffers.

Status

In-place processing is supported, but the source and destination image buffers cannot partially overlap (a situation that can only occur when using child buffers).