EasyImage::ConvolUniform

Applies strong low-pass filtering to an image by using a uniform rectangular kernel of odd size.

Namespace: Euresys::Open_eVision

[C++]

void ConvolUniform(
   EROIBW8* sourceImage,
   EROIBW8* destinationImage,
   OEV_UINT32 halfOfKernelWidth,
   OEV_UINT32 halfOfKernelHeight
)

void ConvolUniform(
   EROIBW16* sourceImage,
   EROIBW16* destinationImage,
   OEV_UINT32 halfOfKernelWidth,
   OEV_UINT32 halfOfKernelHeight
)

void ConvolUniform(
   EROIC24* sourceImage,
   EROIC24* destinationImage,
   OEV_UINT32 halfOfKernelWidth,
   OEV_UINT32 halfOfKernelHeight
)

void ConvolUniform(
   EBW8Vector* sourceVector,
   EBW8Vector* destinationVector,
   OEV_UINT32 halfOfKernelWidth
)

void ConvolUniform(
   EBW16Vector* sourceVector,
   EBW16Vector* destinationVector,
   OEV_UINT32 halfOfKernelWidth
)

void ConvolUniform(
   EROIBW8* sourceImage,
   const ERegion& region,
   EROIBW8* destinationImage,
   OEV_UINT32 halfOfKernelWidth,
   OEV_UINT32 halfOfKernelHeight
)

void ConvolUniform(
   EROIBW16* sourceImage,
   const ERegion& region,
   EROIBW16* destinationImage,
   OEV_UINT32 halfOfKernelWidth,
   OEV_UINT32 halfOfKernelHeight
)

void ConvolUniform(
   EROIC24* sourceImage,
   const ERegion& region,
   EROIC24* destinationImage,
   OEV_UINT32 halfOfKernelWidth,
   OEV_UINT32 halfOfKernelHeight
)

Parameters

sourceImage

Pointer to the source image/ROI.

destinationImage

Pointer to the destination image/ROI. If NULL (default), this operation is destructive (i.e. applied to the source image) and the default value for un32HalfWidth (1) has to be used.

halfOfKernelWidth

Half of the box width minus one (by default, halfOfKernelWidth = 1; 0 is allowed).

halfOfKernelHeight

Half of the box height minus one (by default, same as halfOfKernelWidth; 0 is allowed).

sourceVector

Pointer to the source vector.

destinationVector

Pointer to the destination vector. If NULL (default), this operation is destructive (i.e. applied to the source vector) and the default value for un32HalfWidth (1) has to be used.

region

Region to apply the function on.

Remarks

This filter replaces every pixel values by the arithmetic mean of the neighboring values in a rectangular window. To handle pixels along edges, the source pixels are replicated outwards as many times as required.
A very nice feature of this function is that its running time does not depend on the kernel size!

EasyImage.ConvolUniform

Applies strong low-pass filtering to an image by using a uniform rectangular kernel of odd size.

Namespace: Euresys.Open_eVision

[C#]

void ConvolUniform(
   Euresys.Open_eVision.EROIBW8 sourceImage,
   Euresys.Open_eVision.EROIBW8 destinationImage,
   uint halfOfKernelWidth,
   uint halfOfKernelHeight
)

void ConvolUniform(
   Euresys.Open_eVision.EROIBW16 sourceImage,
   Euresys.Open_eVision.EROIBW16 destinationImage,
   uint halfOfKernelWidth,
   uint halfOfKernelHeight
)

void ConvolUniform(
   Euresys.Open_eVision.EROIC24 sourceImage,
   Euresys.Open_eVision.EROIC24 destinationImage,
   uint halfOfKernelWidth,
   uint halfOfKernelHeight
)

void ConvolUniform(
   Euresys.Open_eVision.EBW8Vector sourceVector,
   Euresys.Open_eVision.EBW8Vector destinationVector,
   uint halfOfKernelWidth
)

void ConvolUniform(
   Euresys.Open_eVision.EBW16Vector sourceVector,
   Euresys.Open_eVision.EBW16Vector destinationVector,
   uint halfOfKernelWidth
)

void ConvolUniform(
   Euresys.Open_eVision.EROIBW8 sourceImage,
   Euresys.Open_eVision.ERegion region,
   Euresys.Open_eVision.EROIBW8 destinationImage,
   uint halfOfKernelWidth,
   uint halfOfKernelHeight
)

void ConvolUniform(
   Euresys.Open_eVision.EROIBW16 sourceImage,
   Euresys.Open_eVision.ERegion region,
   Euresys.Open_eVision.EROIBW16 destinationImage,
   uint halfOfKernelWidth,
   uint halfOfKernelHeight
)

void ConvolUniform(
   Euresys.Open_eVision.EROIC24 sourceImage,
   Euresys.Open_eVision.ERegion region,
   Euresys.Open_eVision.EROIC24 destinationImage,
   uint halfOfKernelWidth,
   uint halfOfKernelHeight
)

Parameters

sourceImage

Pointer to the source image/ROI.

destinationImage

Pointer to the destination image/ROI. If NULL (default), this operation is destructive (i.e. applied to the source image) and the default value for un32HalfWidth (1) has to be used.

halfOfKernelWidth

Half of the box width minus one (by default, halfOfKernelWidth = 1; 0 is allowed).

halfOfKernelHeight

Half of the box height minus one (by default, same as halfOfKernelWidth; 0 is allowed).

sourceVector

Pointer to the source vector.

destinationVector

Pointer to the destination vector. If NULL (default), this operation is destructive (i.e. applied to the source vector) and the default value for un32HalfWidth (1) has to be used.

region

Region to apply the function on.

Remarks

This filter replaces every pixel values by the arithmetic mean of the neighboring values in a rectangular window. To handle pixels along edges, the source pixels are replicated outwards as many times as required.
A very nice feature of this function is that its running time does not depend on the kernel size!