PolarToCart
PolarToCart
Converts the polar form magnitude/phase pairs stored in input vectors to Cartesian coordinate form.
Syntax
IppStatus ippsPolarToCart_32f(const Ipp32f*
pSrcMagn
, const Ipp32f*
pSrcPhase
, Ipp32f*
pDstRe
, Ipp32f*
pDstIm
, int
len
);
IppStatus ippsPolarToCart_64f(const Ipp64f*
pSrcMagn
, const Ipp64f*
pSrcPhase
, Ipp64f*
pDstRe
, Ipp64f*
pDstIm
, int
len
);
IppStatus ippsPolarToCart_32fc(const Ipp32f*
pSrcMagn
, const Ipp32f*
pSrcPhase
, Ipp32fc*
pDst
, int
len
);
IppStatus ippsPolarToCart_64fc(const Ipp64f*
pSrcMagn
, const Ipp64f*
pSrcPhase
, Ipp64fc*
pDst
, int
len
);
IppStatus ippsPolarToCart_16sc_Sfs(const Ipp16s*
pSrcMagn
, const Ipp16s*
pSrcPhase
, Ipp16sc*
pDst
, int
len
, int
magnScaleFactor
, int
phaseScaleFactor
);
Include Files
ipps.h
Domain Dependencies
Headers:
ippcore.h
,
ippvm.h
Libraries:
ippcore.lib
,
ippvm.lib
Parameters
- pSrcMagn
- Pointer to the source vector which stores the magnitude (radius) components of the elements in polar coordinate form.
- pSrcPhase
- Pointer to the vector which stores the phase (angle) components of the elements in polar coordinate form in radians.
- pDst
- Pointer to the resulting vector which stores the complex pairs in Cartesian coordinates (X + iY).
- pDstRe
- Pointer to the resulting vector which stores the real components of Cartesian X,Y pairs.
- pDstIm
- Pointer to the resulting vector which stores the imaginary components of Cartesian X,Y pairs.
- len
- Number of elements in the vectors.
- magnScaleFactor
- Integer scale factor for the magnitude component, refer to Integer Scaling.
- phaseScaleFactor
- Integer scale factor for the phase component, refer to Integer Scaling.
Description
This function converts the polar form magnitude/phase pairs stored in the input vectors
pSrcMagn
and pSrcPhase
into a complex vector and stores the results in the vector pDst
, or stores the real components of the result in the vector pDstRe
and the imaginary components in the vector pDstIm
.Return Values
- ippStsNoErr
- Indicates no error.
- ippStsNullPtrErr
- Indicates an error when one of the specified pointers isNULL.
- ippStsSizeErr
- Indicates an error whenlenis less than or equal to 0.