fill_interlacefill_interlaceFillInterlaceFillInterlace (Operator)

Name

fill_interlacefill_interlaceFillInterlaceFillInterlace — Interpolate 2 video half images.

Signature

fill_interlace(ImageCamera : ImageFilled : Mode : )

Herror fill_interlace(const Hobject ImageCamera, Hobject* ImageFilled, const char* Mode)

Herror T_fill_interlace(const Hobject ImageCamera, Hobject* ImageFilled, const Htuple Mode)

void FillInterlace(const HObject& ImageCamera, HObject* ImageFilled, const HTuple& Mode)

HImage HImage::FillInterlace(const HString& Mode) const

HImage HImage::FillInterlace(const char* Mode) const

HImage HImage::FillInterlace(const wchar_t* Mode) const   (Windows only)

static void HOperatorSet.FillInterlace(HObject imageCamera, out HObject imageFilled, HTuple mode)

HImage HImage.FillInterlace(string mode)

Description

The operator fill_interlacefill_interlaceFillInterlaceFillInterlaceFillInterlace calculates an interpolated full image or removes odd/even lines from a video image composed of two half images. If an image is recorded with a video camera it consists of two half images recorded at different times but stored in one image in the digital form. This can lead to several errors in further processing. In order to reduce these errors the video image is modified. Every second line is re-calculated or removed. The parameter ModeModeModeModemode determines whether this must be done for even ('even', 'rmeven') or odd ('odd', 'rmodd') line numbers. If you choose 'even' or 'odd' the gray values in the generated lines are calculated as mean values from the direct neighbors above or below the current pixel, respectively. If you choose 'rmeven' or 'rmodd' the even or odd lines numbers are removed (in that case the resulting image is only half as high as the input image). The value 'switch' for ModeModeModeModemode cause the odd and even lines to be exchanged.

For an explanation of the concept of smoothing filters see the introduction of chapter Filters / Smoothing.

Attention

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.

Execution Information

Parameters

ImageCameraImageCameraImageCameraImageCameraimageCamera (input_object)  (multichannel-)image(-array) objectHImageHImageHobject (byte / uint2)

Gray image consisting of two half images.

ImageFilledImageFilledImageFilledImageFilledimageFilled (output_object)  (multichannel-)image(-array) objectHImageHImageHobject * (byte / uint2)

Full image with interpolated/removed lines.

ModeModeModeModemode (input_control)  string HTupleHTupleHtuple (string) (string) (HString) (char*)

Instruction whether even or odd lines should be replaced/removed.

Default value: 'odd' "odd" "odd" "odd" "odd"

List of values: 'even'"even""even""even""even", 'odd'"odd""odd""odd""odd", 'rmeven'"rmeven""rmeven""rmeven""rmeven", 'rmodd'"rmodd""rmodd""rmodd""rmodd", 'switch'"switch""switch""switch""switch"

Example (HDevelop)

read_image(Image,'video_image')
fill_interlace(Image,New,'odd')
sobel_amp(New,Sobel,'sum_abs',3)

Example (C)

read_image(&Image,"video_image");
fill_interlace(Image,&New,"odd");
sobel_amp(New,&Sobel,"sum_abs",3);

Example (HDevelop)

read_image(Image,'video_image')
fill_interlace(Image,New,'odd')
sobel_amp(New,Sobel,'sum_abs',3)

Example (HDevelop)

read_image(Image,'video_image')
fill_interlace(Image,New,'odd')
sobel_amp(New,Sobel,'sum_abs',3)

Example (HDevelop)

read_image(Image,'video_image')
fill_interlace(Image,New,'odd')
sobel_amp(New,Sobel,'sum_abs',3)

Complexity

For each pixel: O(2).

Result

If the parameter values are correct the operator fill_interlacefill_interlaceFillInterlaceFillInterlaceFillInterlace returns the value 2 (H_MSG_TRUE). The behavior in case of empty input (no input images available) is set via the operator set_system('no_object_result',<Result>)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>). If necessary an exception is raised.

Possible Predecessors

read_imageread_imageReadImageReadImageReadImage, grab_imagegrab_imageGrabImageGrabImageGrabImage

Possible Successors

sobel_ampsobel_ampSobelAmpSobelAmpSobelAmp, edges_imageedges_imageEdgesImageEdgesImageEdgesImage, regiongrowingregiongrowingRegiongrowingRegiongrowingRegiongrowing, diff_of_gaussdiff_of_gaussDiffOfGaussDiffOfGaussDiffOfGauss, thresholdthresholdThresholdThresholdThreshold, dyn_thresholddyn_thresholdDynThresholdDynThresholdDynThreshold, auto_thresholdauto_thresholdAutoThresholdAutoThresholdAutoThreshold, mean_imagemean_imageMeanImageMeanImageMeanImage, binomial_filterbinomial_filterBinomialFilterBinomialFilterBinomialFilter, gauss_filtergauss_filterGaussFilterGaussFilterGaussFilter, anisotropic_diffusionanisotropic_diffusionAnisotropicDiffusionAnisotropicDiffusionAnisotropicDiffusion, sigma_imagesigma_imageSigmaImageSigmaImageSigmaImage, median_imagemedian_imageMedianImageMedianImageMedianImage

See also

median_imagemedian_imageMedianImageMedianImageMedianImage, binomial_filterbinomial_filterBinomialFilterBinomialFilterBinomialFilter, gauss_filtergauss_filterGaussFilterGaussFilterGaussFilter, crop_partcrop_partCropPartCropPartCropPart

Module

Foundation