simulate_motionsimulate_motionSimulateMotionSimulateMotionsimulate_motion (Operator)

Name

simulate_motionsimulate_motionSimulateMotionSimulateMotionsimulate_motion — Simulation of (linearly) motion blur.

Signature

simulate_motion(Image : MovedImage : Blurring, Angle, Type : )

Herror simulate_motion(const Hobject Image, Hobject* MovedImage, double Blurring, const Hlong Angle, const Hlong Type)

Herror T_simulate_motion(const Hobject Image, Hobject* MovedImage, const Htuple Blurring, const Htuple Angle, const Htuple Type)

void SimulateMotion(const HObject& Image, HObject* MovedImage, const HTuple& Blurring, const HTuple& Angle, const HTuple& Type)

HImage HImage::SimulateMotion(double Blurring, Hlong Angle, Hlong Type) const

static void HOperatorSet.SimulateMotion(HObject image, out HObject movedImage, HTuple blurring, HTuple angle, HTuple type)

HImage HImage.SimulateMotion(double blurring, int angle, int type)

def simulate_motion(image: HObject, blurring: float, angle: int, type: int) -> HObject

Description

simulate_motionsimulate_motionSimulateMotionSimulateMotionSimulateMotionsimulate_motion simulates blurring caused by a relative motion between the object and the camera during exposure. The simulated motion moves along an even. AngleAngleAngleAngleangleangle fixes its direction by specifying the angle between the motion direction and the x-axis (anticlockwise, measured in degrees). Simulation is done by a convolution of the image with a blurring specific impulse response. The convolution is realized by multiplication in the Fourier domain. simulate_motionsimulate_motionSimulateMotionSimulateMotionSimulateMotionsimulate_motion offers five prototypes of impulse responses conforming to different acceleration behaviors. TypeTypeTypeTypetypetype allows to choose one of the following PSF prototypes:

  1. reverse ramp (crude model for acceleration)

  2. reverse trapezoid (crude model for high acceleration)

  3. square pulse (exact model for constant velocity), this is default

  4. forward trapezoid (crude model for deceleration)

  5. forward ramp (crude model for high deceleration)

(default value is 3.)

The simulated blurring affects all part of the image uniformly. BlurringBlurringBlurringBlurringblurringblurring controls the extent of blurring. It specifies the number of pixels (lying one after another) that are affected by the blurring. This number is determined by velocity of the motion and exposure time. If BlurringBlurringBlurringBlurringblurringblurring is a negative number, an adequate blurring in reverse direction is simulated. If AngleAngleAngleAngleangleangle is a negative number, it is interpreted clockwise. If AngleAngleAngleAngleangleangle exceeds 360 or falls below -360, it is transformed modulo(360) in an adequate number between [0..360] resp. [-360..0].

Execution Information

Parameters

ImageImageImageImageimageimage (input_object)  (multichannel-)image(-array) objectHImageHObjectHImageHobject (byte / direction / cyclic / int1 / int2 / uint2 / int4 / real)

image to be blurred.

MovedImageMovedImageMovedImageMovedImagemovedImagemoved_image (output_object)  image objectHImageHObjectHImageHobject * (real)

motion blurred image.

BlurringBlurringBlurringBlurringblurringblurring (input_control)  real HTuplefloatHTupleHtuple (real) (double) (double) (double)

extent of blurring.

Default value: 20.0

Suggested values: 5.0, 10.0, 20.0, 30.0, 40.0

AngleAngleAngleAngleangleangle (input_control)  integer HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Angle between direction of motion and x-axis (anticlockwise).

Default value: 0

Suggested values: 0, 45, 90, 180, 270

TypeTypeTypeTypetypetype (input_control)  integer HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

impulse response of motion blur.

Default value: 3

List of values: 1, 2, 3, 4, 5

Result

simulate_motionsimulate_motionSimulateMotionSimulateMotionSimulateMotionsimulate_motion returns 2 (H_MSG_TRUE) if all parameters are correct. If the input is empty simulate_motionsimulate_motionSimulateMotionSimulateMotionSimulateMotionsimulate_motion returns with an error message.

Possible Predecessors

gen_psf_motiongen_psf_motionGenPsfMotionGenPsfMotionGenPsfMotiongen_psf_motion, gen_psf_motiongen_psf_motionGenPsfMotionGenPsfMotionGenPsfMotiongen_psf_motion

Possible Successors

simulate_defocussimulate_defocusSimulateDefocusSimulateDefocusSimulateDefocussimulate_defocus, wiener_filterwiener_filterWienerFilterWienerFilterWienerFilterwiener_filter, wiener_filter_niwiener_filter_niWienerFilterNiWienerFilterNiWienerFilterNiwiener_filter_ni

See also

gen_psf_motiongen_psf_motionGenPsfMotionGenPsfMotionGenPsfMotiongen_psf_motion, simulate_defocussimulate_defocusSimulateDefocusSimulateDefocusSimulateDefocussimulate_defocus, gen_psf_defocusgen_psf_defocusGenPsfDefocusGenPsfDefocusGenPsfDefocusgen_psf_defocus

References

Anil K. Jain:Fundamentals of Digital Image Processing, Prentice-Hall International Inc., Englewood Cliffs, New Jersey, 1989
M. Lückenhaus:“Grundlagen des Wiener-Filters und seine Anwendung in der Bildanalyse”; Diplomarbeit; Technische Universität München, Institut für Informatik; Lehrstuhl Prof. Radig; 1995.
Kha-Chye Tan, Hock Lim, B. T. G. Tan:“Restoration of Real-World Motion-Blurred Images”;S. 291-299 in: CVGIP Graphical Models and Image Processing, Vol. 53, No. 3, May 1991

Module

Foundation