Skip to content

cartToPolar

Core and matricesfunctionOpenCV 5.0.0
import { cartToPolar } from '@banou/opencv-wasm'

Use after await initOpenCV(). See the initialization and named imports guide.

ARGUMENTSx, y, magnitude, angle
FUNCTIONcartToPolar
RETURN TYPEvoid
Call structure. A void return can still write to destination arguments. The parameter descriptions define inputs, outputs and ownership.

Calculates the magnitude and angle of 2D vectors.

The function cv::cartToPolar calculates either the magnitude, angle, or both for every 2D vector (x(I),y(I)):

\begin{array}{l} \texttt{magnitude} (I)= \sqrt{\texttt{x}(I)^2+\texttt{y}(I)^2} , \\ \texttt{angle} (I)= \texttt{atan2} ( \texttt{y} (I), \texttt{x} (I))[ \cdot180 / \pi ] \end{array}

The angles are calculated with accuracy about 0.3 degrees. For the point (0,0), the angle is set to 0.

See: Sobel, Scharr

cartToPolar(x: Mat, y: Mat, magnitude: Mat, angle: Mat, angleInDegrees: boolean): void;
2 available overloads
cartToPolar(x: Mat, y: Mat, magnitude: Mat, angle: Mat): void;
cartToPolar(x: Mat, y: Mat, magnitude: Mat, angle: Mat, angleInDegrees: boolean): void;
x

array of x-coordinates; this must be a single-precision or double-precision floating-point array.

y

array of y-coordinates, that must have the same size and same type as x.

magnitude

Output destination, filled by the native operation. output array of magnitudes of the same size and type as x.

angle

Output destination, filled by the native operation. output array of angles that has the same size and type as x; the angles are measured in radians (from 0 to 2*Pi) or in degrees (0 to 360 degrees).

angleInDegrees

a flag, indicating whether the angles are measured in radians (which is by default), or in degrees.

These signatures describe this package. Upstream documentation can mention optional backends that are absent from this build. Check runtime compatibility before choosing a backend or file format.