add_noise_whiteadd_noise_whiteAddNoiseWhiteAddNoiseWhite (Operator)

Name

add_noise_whiteadd_noise_whiteAddNoiseWhiteAddNoiseWhite — Add noise to an image.

Signature

add_noise_white(Image : ImageNoise : Amp : )

Herror add_noise_white(const Hobject Image, Hobject* ImageNoise, double Amp)

Herror T_add_noise_white(const Hobject Image, Hobject* ImageNoise, const Htuple Amp)

void AddNoiseWhite(const HObject& Image, HObject* ImageNoise, const HTuple& Amp)

HImage HImage::AddNoiseWhite(double Amp) const

static void HOperatorSet.AddNoiseWhite(HObject image, out HObject imageNoise, HTuple amp)

HImage HImage.AddNoiseWhite(double amp)

Description

add_noise_whiteadd_noise_whiteAddNoiseWhiteAddNoiseWhiteAddNoiseWhite adds noise to the image ImageImageImageImageimage. The noise is white noise, equally distributed in the interval [-AmpAmpAmpAmpamp,AmpAmpAmpAmpamp], and is generated by using the C function “drand48” with an initial time dependent seed. The resulting gray values are clipped to the range of the corresponding pixel type.

Execution Information

Parameters

ImageImageImageImageimage (input_object)  (multichannel-)image(-array) objectHImageHImageHobject (byte / int2 / uint2 / real)

Input image.

ImageNoiseImageNoiseImageNoiseImageNoiseimageNoise (output_object)  (multichannel-)image(-array) objectHImageHImageHobject * (byte / int2 / uint2 / real)

Noisy image.

Number of elements: ImageNoise == Image

AmpAmpAmpAmpamp (input_control)  real HTupleHTupleHtuple (real) (double) (double) (double)

Maximum noise amplitude.

Default value: 60.0

Suggested values: 1.0, 2.0, 5.0, 10.0, 20.0, 40.0, 60.0, 90.0

Typical range of values: 1.0 ≤ Amp Amp Amp Amp amp ≤ 1000.0

Minimum increment: 0.001

Recommended increment: 10.0

Restriction: Amp > 0

Example (HDevelop)

read_image(Image,'fabrik')
dev_display (Image)
add_noise_white(Image,ImageNoise,90)
dev_display (ImageNoise)

Example (C)

read_image(&Image,"fabrik");
disp_image(Image,WindowHandle);
add_noise_white(Image,&ImageNoise,90.0);
disp_image(ImageNoise,WindowHandle);

Example (HDevelop)

read_image(Image,'fabrik')
dev_display (Image)
add_noise_white(Image,ImageNoise,90)
dev_display (ImageNoise)

Example (HDevelop)

read_image(Image,'fabrik')
dev_display (Image)
add_noise_white(Image,ImageNoise,90)
dev_display (ImageNoise)

Example (HDevelop)

read_image(Image,'fabrik')
dev_display (Image)
add_noise_white(Image,ImageNoise,90)
dev_display (ImageNoise)

Result

add_noise_whiteadd_noise_whiteAddNoiseWhiteAddNoiseWhiteAddNoiseWhite 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>)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>). If necessary, an exception is raised.

Alternatives

add_noise_distributionadd_noise_distributionAddNoiseDistributionAddNoiseDistributionAddNoiseDistribution

See also

add_noise_distributionadd_noise_distributionAddNoiseDistributionAddNoiseDistributionAddNoiseDistribution, noise_distribution_meannoise_distribution_meanNoiseDistributionMeanNoiseDistributionMeanNoiseDistributionMean, gauss_distributiongauss_distributionGaussDistributionGaussDistributionGaussDistribution, sp_distributionsp_distributionSpDistributionSpDistributionSpDistribution

Module

Foundation