add_noise_distribution

add_noise_distribution ( Image : ImageNoise : Distribution : )

Add noise to an image.

add_noise_distribution adds noise distributed according to Distribution to the image Image. Resulting gray values are clipped to the range [0,255].

Parameters

`Image` (input_object)	(multichannel-)image(-array) `->` object : byte / int2
Input image.

`ImageNoise` (output_object)	(multichannel-)image(-array) `->` object : byte / int2
Noisy image.
Number of elements: ImageNoise == Image

`Distribution` (input_control)	distribution.values-array `->` real
Noise distribution.
Number of elements: 513

Example

read_image(Image,'meer_rot') 
disp_image(Image,WindowHandle) 
sp_distribution(30,30,Dist)
add_noise_distribution(Image,ImageNoise,Dist) 
disp_image(ImageNoise,WindowHandle).

Result

add_noise_distribution returns 2 (H_MSG_TRUE) if all parameters are correct. If the input is empty the behaviour can be set via set_system('no_object_result',<Result>). If necessary, an exception handling is raised.

Parallelization Information

add_noise_distribution is reentrant and automatically parallelized (on tuple level, channel level, domain level).

Possible Predecessors

gauss_distribution, sp_distribution, noise_distribution_mean

Alternatives

add_noise_white

Module

Image filters