Intel® Integrated Performance Primitives (Intel® IPP) Developer Guide and Reference

ID 790148
Date 6/24/2024
Public

A newer version of this document is available. Customers should click here to go to the newest version.

Document Table of Contents

RandGaussInit

Initializes a noise generator with Gaussian distribution.

Syntax

IppStatus ippsRandGaussInit_8u(IppsRandGaussState_8u* pRandGaussState, Ipp8u mean, Ipp8u stdDev, unsigned int seed);

IppStatus ippsRandGaussInit_16s(IppsRandGaussState_16s* pRandGaussState, Ipp16s mean, Ipp16s stdDev, unsigned int seed);

IppStatus ippsRandGaussInit_32f(IppsRandGaussState_32f* pRandGaussState, Ipp32f mean, Ipp32f stdDev, unsigned int seed);

IppStatus ippsRandGaussInit_64f(IppsRandGaussState_64f* pRandGaussState, Ipp64f mean, Ipp64f stdDev, unsigned int seed);

Include Files

ipps.h

Domain Dependencies

Headers: ippcore.h, ippvm.h

Libraries: ippcore.lib, ippvm.lib

Parameters

pRandGaussState

Pointer to the structure containing parameters for the generator of noise.

mean

Mean of the Gaussian distribution.

stdDev

Standard deviation of the Gaussian distribution.

seed

Seed value used by the pseudo-random number generator algorithm.

Description

This function initializes the pseudo-random generator state structure pRandGaussState in the external buffer. This structure contains parameters of the required noise generator that are specified by the mean, stdDev, and seed values. Before using this function, you need to compute the size of the buffer by calling the ippsRandGaussGetSize function.

Return Values

ppStsNoErr

Indicates no error.

ippStsNullPtrErr

Indicates an error when the pRandGaussState pointer is NULL.

ippStsMemAllocErr

Indicates an error when there is not enough memory for the operation.

See Also