ClassesClassesClassesClasses | | | | Operators

dots_imagedots_imageDotsImagedots_imageDotsImageDotsImage (Operator)


dots_imagedots_imageDotsImagedots_imageDotsImageDotsImage — Enhance circular dots in an image.


dots_image(Image : DotImage : Diameter, FilterType, PixelShift : )

Herror dots_image(const Hobject Image, Hobject* DotImage, const Hlong Diameter, const char* FilterType, const Hlong PixelShift)

Herror T_dots_image(const Hobject Image, Hobject* DotImage, const Htuple Diameter, const Htuple FilterType, const Htuple PixelShift)

Herror dots_image(Hobject Image, Hobject* DotImage, const HTuple& Diameter, const HTuple& FilterType, const HTuple& PixelShift)

HImage HImage::DotsImage(const HTuple& Diameter, const HTuple& FilterType, const HTuple& PixelShift) const

HImageArray HImageArray::DotsImage(const HTuple& Diameter, const HTuple& FilterType, const HTuple& PixelShift) const

void DotsImage(const HObject& Image, HObject* DotImage, const HTuple& Diameter, const HTuple& FilterType, const HTuple& PixelShift)

HImage HImage::DotsImage(Hlong Diameter, const HString& FilterType, Hlong PixelShift) const

HImage HImage::DotsImage(Hlong Diameter, const char* FilterType, Hlong PixelShift) const

void HOperatorSetX.DotsImage(
[in] IHUntypedObjectX* Image, [out] IHUntypedObjectX*DotImage, [in] VARIANT Diameter, [in] VARIANT FilterType, [in] VARIANT PixelShift)

IHImageX* HImageX.DotsImage(
[in] Hlong Diameter, [in] BSTR FilterType, [in] Hlong PixelShift)

static void HOperatorSet.DotsImage(HObject image, out HObject dotImage, HTuple diameter, HTuple filterType, HTuple pixelShift)

HImage HImage.DotsImage(int diameter, string filterType, int pixelShift)


dots_imagedots_imageDotsImagedots_imageDotsImageDotsImage enhances circular dots of diameter DiameterDiameterDiameterDiameterDiameterdiameter in the input image ImageImageImageImageImageimage. Hence, dots_imagedots_imageDotsImagedots_imageDotsImageDotsImage is especially suited for the segmentation of dot prints, e.g., in OCR applications. The enhancement is performed by using matched filters with filter masks that are tuned for a particular dot size. For example, for DiameterDiameterDiameterDiameterDiameterdiameter = 5 the filter mask is given by:

The parameter FilterTypeFilterTypeFilterTypeFilterTypeFilterTypefilterType selects whether 'dark'"dark""dark""dark""dark""dark", 'light'"light""light""light""light""light", or 'all'"all""all""all""all""all" dots in the image should be enhanced. The PixelShiftPixelShiftPixelShiftPixelShiftPixelShiftpixelShift can be used either to increase the contrast of the output image (PixelShiftPixelShiftPixelShiftPixelShiftPixelShiftpixelShift > 0) or to dampen the values in extremely bright areas that would be cut off otherwise (PixelShiftPixelShiftPixelShiftPixelShiftPixelShiftpixelShift = -1).


Note that filter operators may return unexpected results if an image with a reduced domain is used as input. Please refer to the chapter Filters.



ImageImageImageImageImageimage (input_object)  (multichannel-)image(-array) objectHImageHImageHImageHImageXHobject (byte / uint2)

Input image.

DotImageDotImageDotImageDotImageDotImagedotImage (output_object)  (multichannel-)image(-array) objectHImageHImageHImageHImageXHobject * (byte / uint2)

Output image.

DiameterDiameterDiameterDiameterDiameterdiameter (input_control)  integer HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Diameter of the dots to be enhanced.

Default value: 5

List of values: 3, 5, 7, 9, 11, 13, 15, 17, 19, 21, 23

FilterTypeFilterTypeFilterTypeFilterTypeFilterTypefilterType (input_control)  string HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

Enhance dark, light, or all dots.

Default value: 'light' "light" "light" "light" "light" "light"

List of values: 'all'"all""all""all""all""all", 'dark'"dark""dark""dark""dark""dark", 'light'"light""light""light""light""light"

PixelShiftPixelShiftPixelShiftPixelShiftPixelShiftpixelShift (input_control)  integer HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Shift of the filter response.

Default value: 0

List of values: -1, 0, 1, 2

Possible Successors



laplacelaplaceLaplacelaplaceLaplaceLaplace, laplace_of_gausslaplace_of_gaussLaplaceOfGausslaplace_of_gaussLaplaceOfGaussLaplaceOfGauss, diff_of_gaussdiff_of_gaussDiffOfGaussdiff_of_gaussDiffOfGaussDiffOfGauss, derivate_gaussderivate_gaussDerivateGaussderivate_gaussDerivateGaussDerivateGauss, convol_imageconvol_imageConvolImageconvol_imageConvolImageConvolImage



ClassesClassesClassesClasses | | | | Operators