Specifications

Intel
®
Image Processing Library Reference Manual
4-42
4
NoiseImage
Generates noise signal
and adds it to an image
data.
IPLStatus iplNoiseImage ( IplImage* image ,
const IplNoiseParam*
noiseParam );
image Pointer to the image header structure.
noiseParam Pointer to the structure that contains parameters
for the noise generator.
Discussion
The function iplNoiseImage() generates a random noise signal and adds
it to a source image
image that is passed to this function as an argument.
The resulting pixel values that exceed the output data range are saturated to
the respective data-range limits. The noise signal can have either uniform
or Gaussian distribution. Before calling
iplNoiseImage() you must first
initialize the
noiseParam structure using one of the initialization functions
described below.
To obtain an output image which contains pure noise, call
iplNoiseImage() using a source image with zero data as input.
Return Value
If the execution is successful, the function returns IPL_StsOK;otherwise,it
returns an error status code.