ClassesClassesClassesClasses | | | | Operators

add_noise_whiteadd_noise_whiteAddNoiseWhiteadd_noise_whiteAddNoiseWhiteAddNoiseWhite (Operator)

Name

add_noise_whiteadd_noise_whiteAddNoiseWhiteadd_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)

Herror add_noise_white(Hobject Image, Hobject* ImageNoise, const HTuple& Amp)

HImage HImage::AddNoiseWhite(const HTuple& Amp) const

HImageArray HImageArray::AddNoiseWhite(const HTuple& Amp) const

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

HImage HImage::AddNoiseWhite(double Amp) const

void HOperatorSetX.AddNoiseWhite(
[in] IHUntypedObjectX* Image, [out] IHUntypedObjectX*ImageNoise, [in] VARIANT Amp)

IHImageX* HImageX.AddNoiseWhite([in] double Amp)

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

HImage HImage.AddNoiseWhite(double amp)

Description

add_noise_whiteadd_noise_whiteAddNoiseWhiteadd_noise_whiteAddNoiseWhiteAddNoiseWhite adds noise to the image ImageImageImageImageImageimage. The noise is white noise, equally distributed in the interval [-AmpAmpAmpAmpAmpamp,AmpAmpAmpAmpAmpamp], 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.

Parallelization

Parameters

ImageImageImageImageImageimage (input_object)  (multichannel-)image(-array) objectHImageHImageHImageHImageXHobject (byte / int2 / uint2 / real)

Input image.

ImageNoiseImageNoiseImageNoiseImageNoiseImageNoiseimageNoise (output_object)  (multichannel-)image(-array) objectHImageHImageHImageHImageXHobject * (byte / int2 / uint2 / real)

Noisy image.

Number of elements: ImageNoise == Image

AmpAmpAmpAmpAmpamp (input_control)  real HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (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 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)

Example (HDevelop)

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

Result

add_noise_whiteadd_noise_whiteAddNoiseWhiteadd_noise_whiteAddNoiseWhiteAddNoiseWhite 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>)set_system("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_distributionAddNoiseDistributionadd_noise_distributionAddNoiseDistributionAddNoiseDistribution

See also

add_noise_distributionadd_noise_distributionAddNoiseDistributionadd_noise_distributionAddNoiseDistributionAddNoiseDistribution, noise_distribution_meannoise_distribution_meanNoiseDistributionMeannoise_distribution_meanNoiseDistributionMeanNoiseDistributionMean, gauss_distributiongauss_distributionGaussDistributiongauss_distributionGaussDistributionGaussDistribution, sp_distributionsp_distributionSpDistributionsp_distributionSpDistributionSpDistribution

Module

Foundation


ClassesClassesClassesClasses | | | | Operators