JoinScaled

Converts with scaling the floating-point data of several vectors to integer data and stores the results in a single vector.

Syntax

IppStatus ippsJoinScaled_32f16s_D2L(const Ipp32f** pSrc, int nChannels, int chanLen, Ipp16s* pDst);

IppStatus ippsJoinScaled_32f24s_D2L(const Ipp32f** pSrc, int nChannels, int chanLen, Ipp8u* pDst);

Parameters

pSrc	Pointer to an array of pointers to the source vectors.
pDst	Pointer to the destination vector.
nChannels	Number of source vectors.
chanLen	Number of elements in each sourcet vector.

Description

The function ippsJoinScaled is declared in the ipps.h file. This function converts floating-point data of nChannels input vectors stored in the array pSrc to integer data type with scaling. Input data must be in the range [-1.0, 1.0] that is mapped onto output data type range [dst_Min..dst_Max] (see Data Ranges for more information on data types and ranges). If the input data exceed the range [-1.0, 1.0], they are saturated. The function uses the following formula for scaling:

pDst[n] = dst_Min + k * [pSrc[n] - (-1)]

where k = (dst_Max - dst_Min) / (1 - (-1))

Mapped values are rounded to the nearest integer.

The function ippsJoinScaled writes the results to the destination vector pDst in the following order: first element of first vector, first element of second vector, ..., first element of the last vector in the array; second element of first vector, second element of second vector, and so on.

Return Values

ippStsNoErr	Indicates no error.
ippStsNullPtrErr	Indicates a then error condition if at least one of the specified pointers is NULL.
ippStsSizeErr	Indicates an error condition if nChannels or chanLen is less than or equal to 0.