simulate_motionsimulate_motionSimulateMotionSimulateMotion (Operator)

Name

simulate_motionsimulate_motionSimulateMotionSimulateMotion — 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)

Description

simulate_motionsimulate_motionSimulateMotionSimulateMotionSimulateMotion simulates blurring caused by a relative motion between the object and the camera during exposure. The simulated motion moves along an even. AngleAngleAngleAngleangle 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_motionSimulateMotionSimulateMotionSimulateMotion offers five prototypes of impulse responses conforming to different acceleration behaviours. TypeTypeTypeTypetype 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. BlurringBlurringBlurringBlurringblurring controls the extent of blurring. It specifies the number of pixels (lying one after another) that are affetcetd by the blurring. This number is determined by velocity of the motion and exposure time. If BlurringBlurringBlurringBlurringblurring is a negative number, an adequate blurring in reverse direction is simulated. If AngleAngleAngleAngleangle is a negative number, it is interpreted clockwise. If AngleAngleAngleAngleangle exceeds 360 or falls below -360, it is transformed modulo(360) in an adequate number between [0..360] resp. [-360..0].

Execution Information

Parameters

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

image to be blurred.

MovedImageMovedImageMovedImageMovedImagemovedImage (output_object)  image objectHImageHImageHobject * (real)

motion blurred image.

BlurringBlurringBlurringBlurringblurring (input_control)  real HTupleHTupleHtuple (real) (double) (double) (double)

extent of blurring.

Default value: 20.0

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

AngleAngleAngleAngleangle (input_control)  integer HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

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

Default value: 0

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

TypeTypeTypeTypetype (input_control)  integer HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

impulse response of motion blur.

Default value: 3

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

Result

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

Possible Predecessors

gen_psf_motiongen_psf_motionGenPsfMotionGenPsfMotionGenPsfMotion, gen_psf_motiongen_psf_motionGenPsfMotionGenPsfMotionGenPsfMotion

Possible Successors

simulate_defocussimulate_defocusSimulateDefocusSimulateDefocusSimulateDefocus, wiener_filterwiener_filterWienerFilterWienerFilterWienerFilter, wiener_filter_niwiener_filter_niWienerFilterNiWienerFilterNiWienerFilterNi

See also

gen_psf_motiongen_psf_motionGenPsfMotionGenPsfMotionGenPsfMotion, simulate_defocussimulate_defocusSimulateDefocusSimulateDefocusSimulateDefocus, gen_psf_defocusgen_psf_defocusGenPsfDefocusGenPsfDefocusGenPsfDefocus

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