add_noise_whiteadd_noise_whiteAddNoiseWhiteAddNoiseWhite (Operator)
Name
add_noise_whiteadd_noise_whiteAddNoiseWhiteAddNoiseWhite
— Add noise to an image.
Signature
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
- Multithreading type: reentrant (runs in parallel with non-exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Automatically parallelized on tuple level.
- Automatically parallelized on channel level.
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