MulC_NR

DEPRECATED. Multiplies each element of a vector by a constant value.

Syntax

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

IppStatus ippsMulC_NR_16s_ISfs (Ipp16s val, Ipp16s* pSrcDst, int len, int scaleFactor);

Include Files

ippsc.h

Domain Dependencies

Headers: ippcore.h, ippvm.h, ipps.h

Libraries: ippcore.lib, ippvm.lib, ipps.lib

Parameters

val

The scalar value used to multiply to each element of the source vector.

pSrc

Pointer to the source vector.

pDst

Pointer to the destination vector.

pSrcDst

Pointer to the source and destination vector for the in-place operation.

len

Number of elements in the vector.

scaleFactor

Scale factor for output data scaling.

Description

This function multiplies the source vector pSrc by the scalar value val, and stores the result in pDst.

The in-place function flavor multiplies the vector pSrcDst by val, and stores the result in pSrcDst.

Both function flavors scale the multiplication results in accordance with the scaleFactor value. If output values exceed the data range, the results are saturated.

Functions ippsMulC_NR perform nearest right rounding needed to meet the bit-to-bit exactness requirement.

Return Values

ippStsNoErr

Indicates no error.

ippStsNullPtrErr I

ndicates an error when the pSrc, pDst, or pSrcDst 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.
For more complete information about compiler optimizations, see our Optimization Notice.