SplitScaled

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

Syntax

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

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

Parameters

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

Description

The function ippsSplitScaled is declared in the ipps.h file. This function converts integer data of the source vector pSrc to the floating-point data type with scaling. The whole range of the input data [src_Min..src_Max] (see Data Ranges for more information on data types and ranges) is mapped onto the output data range [-1.0, 1.0] The function uses the following formula for scaling:

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

where k = (1 - (-1)) / (src_Max - src_Min).

The function ippsSplitScaled writes the results to the nChannels destination vectors pDstin the following order: first element of the input vector becomes the first element of the first output vector, second element of the input vector becomes the first element of the second output 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.