Intel® Integrated Performance Primitives (Intel® IPP) Developer Guide and Reference

ID 790148
Date 6/24/2024
Public

A newer version of this document is available. Customers should click here to go to the newest version.

Document Table of Contents

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 is NULL.

ippStsSizeErr

Indicates an error when len is less than or equal to 0.