You are here: Start » FIL.NET » Function Reference » Region » Region Morphology » FIL.RegionHitAndMissTransform
FIL.RegionHitAndMissTransform
Performs a hit-and-miss transformation on a region using arbitrary kernels.
| Namespace: | FilNet |
|---|---|
| Assembly: | FIL.NET.dll |
Syntax
public static void RegionHitAndMissTransform ( FilNet.Region inRegion, FilNet.Region inHitKernel, FilNet.Region inMissKernel, FilNet.Region outRegion )
Parameters
| Name | Type | Range | Default | Description | |
|---|---|---|---|---|---|
 | inRegion | FilNet.Region | Input region. | ||
| inHitKernel | FilNet.Region | The kernel of pixels that should be present. | ||
| inMissKernel | FilNet.Region | The kernel of pixels that should be missing. | ||
 | outRegion | FilNet.Region | Output region. |
Description
The operation performs a hit-and-miss transformation. Similarly to other region morphology operations, hit-and-miss is conducted using a shape called kernel (or structuring element). In this particular case, there are two kernels: inHitKernel and inMissKernel. Both of them are repeatedly centered at each location within the dimensions of the input region. Then, pixel location L is added to the resulting region if and only if all of the inHitKernel pixels centered at L lie inside and all of the inMissKernel pixels centered at L lie outside the input region.
Examples
 |
 |
RegionHitAndMissTransform run with kernels \( \begin{bmatrix} 1 & X & X\\ 1 & 0 & X\\ 1 & X & X \end{bmatrix} \) where \( 1 \)'s represent pixels from inHitKernel, \( 0 \)'s from inMissKernel and \( X \)'s the other ones.
Errors
List of possible exceptions:
| Error type | Description |
|---|---|
| DomainError | Hit kernel empty in RegionHitAndMissTransform. |
| DomainError | Inconsistent region dimensions in RegionHitAndMissTransform. |
| DomainError | Miss kernel empty in RegionHitAndMissTransform. |
