add_noise_distribution

Herror ::add_noise_distribution ( Hobject Image, Hobject *ImageNoise, const HTuple &Distribution ) HImage HImage::AddNoiseDistribution ( const HTuple &Distribution ) const HImageArray HImageArray::AddNoiseDistribution ( const HTuple &Distribution ) const

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) `->` Hobject: HImage(Array) ( byte / int2 )
Input image.

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

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

Example

read_image(&Image,"fabrik");
disp_image(Image,WindowHandle);
set_d(PerSalt,30.0,0);
set_d(PerPepper,30.0,0);
T_sp_distribution(PerSalt,PerPepper,&Dist);
T_add_noise_distribution(Image,&ImageNoise,Dist);
disp_image(ImageNoise,WindowHandle);

Result

::add_noise_distribution returns 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.

Possible Predecessors

::gauss_distribution, ::sp_distribution, ::noise_distribution_mean

Alternatives

::add_noise_white

Module

Image filters