fill_interlacefill_interlaceFillInterlaceFillInterlacefill_interlace (Operator)
Name
fill_interlacefill_interlaceFillInterlaceFillInterlacefill_interlace — Interpolate 2 video half images.
Signature
Description
The operator fill_interlacefill_interlaceFillInterlaceFillInterlaceFillInterlacefill_interlace 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 ModeModeModeModemodemode
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 ModeModeModeModemodemode 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
- Multithreading type: reentrant (runs in parallel with non-exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Automatically parallelized on tuple level.
- Automatically parallelized on channel level.
- Automatically parallelized on domain level.
Parameters
ImageCameraImageCameraImageCameraImageCameraimageCameraimage_camera (input_object) (multichannel-)image(-array) → objectHImageHObjectHImageHobject (byte / uint2)
Gray image consisting of two half images.
ImageFilledImageFilledImageFilledImageFilledimageFilledimage_filled (output_object) (multichannel-)image(-array) → objectHImageHObjectHImageHobject * (byte / uint2)
Full image with interpolated/removed lines.
ModeModeModeModemodemode (input_control) string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Instruction whether even or odd lines should
be replaced/removed.
Default value:
'odd'
"odd"
"odd"
"odd"
"odd"
"odd"
List of values: 'even'"even""even""even""even""even", 'odd'"odd""odd""odd""odd""odd", 'rmeven'"rmeven""rmeven""rmeven""rmeven""rmeven", 'rmodd'"rmodd""rmodd""rmodd""rmodd""rmodd", 'switch'"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_interlaceFillInterlaceFillInterlaceFillInterlacefill_interlace 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>)set_system("no_object_result",<Result>).
If necessary an exception is raised.
Possible Predecessors
read_imageread_imageReadImageReadImageReadImageread_image,
grab_imagegrab_imageGrabImageGrabImageGrabImagegrab_image
Possible Successors
sobel_ampsobel_ampSobelAmpSobelAmpSobelAmpsobel_amp,
edges_imageedges_imageEdgesImageEdgesImageEdgesImageedges_image,
regiongrowingregiongrowingRegiongrowingRegiongrowingRegiongrowingregiongrowing,
diff_of_gaussdiff_of_gaussDiffOfGaussDiffOfGaussDiffOfGaussdiff_of_gauss,
thresholdthresholdThresholdThresholdThresholdthreshold,
dyn_thresholddyn_thresholdDynThresholdDynThresholdDynThresholddyn_threshold,
auto_thresholdauto_thresholdAutoThresholdAutoThresholdAutoThresholdauto_threshold,
mean_imagemean_imageMeanImageMeanImageMeanImagemean_image,
binomial_filterbinomial_filterBinomialFilterBinomialFilterBinomialFilterbinomial_filter,
gauss_filtergauss_filterGaussFilterGaussFilterGaussFiltergauss_filter,
anisotropic_diffusionanisotropic_diffusionAnisotropicDiffusionAnisotropicDiffusionAnisotropicDiffusionanisotropic_diffusion,
sigma_imagesigma_imageSigmaImageSigmaImageSigmaImagesigma_image,
median_imagemedian_imageMedianImageMedianImageMedianImagemedian_image
See also
median_imagemedian_imageMedianImageMedianImageMedianImagemedian_image,
binomial_filterbinomial_filterBinomialFilterBinomialFilterBinomialFilterbinomial_filter,
gauss_filtergauss_filterGaussFilterGaussFilterGaussFiltergauss_filter,
crop_partcrop_partCropPartCropPartCropPartcrop_part
Module
Foundation