MulPowerC

Performs power weighting for each element of a vector.

Syntax

IppStatus ippsMulPowerC_NR_16s_Sfs (const Ipp16s* pSrc, Ipp16s val, Ipp16s* pDst, int len, int scaleFactor);

Parameters

pSrc	Pointer to the source vector.
val	The scalar value to be multiplied to the source vector.
pDst	Pointer to the destination vector.
len	Number of elements in each vector.
scaleFactor	Scale factor for output data scaling.

Description

The function ippsMulPowerC_NR is declared in the ippsc.h file. This function multiplies each element of the source vector pSrc by a power of a scalar value, val, and stores the results in pDst. The calculation is performed as:

pDst[i] = valⁱ* pSrc[i], 0 ≤ i < len.

The function scales the multiplication results in accordance with the scaleFactor value (see Integer Scaling). If output values exceed the data range, the results are saturated.

The function ippsMulPowerC_NR performs “nearest right” rounding needed to meet the bit-to-bit exactness requirement.

Return Values

ippStsNoErr	Indicates no error.
ippStsNullPtrErr	Indicates an error when the pSrc or pDst pointer is NULL.
ippStsSizeErr	Indicates an error when len is less than or equal to 0.
ippStsScaleRangeErr	Indicates an error when scaleFactor is less than 0.