pplotquiver

Renders vector field from multispectral images with 2 bands.

Synopsis

pplotquiver dimx dimy sampling factor [im_in|-] [im_out|-]

Description

ppplotquiver draws a vector field in the 2D image im_out from the vector components given in the multispectral image im_in. The first band of im_in contains the x-component of the vector and the second band contains the y-component. Such an image can be built with the operator pregistrationPDE.

Parameters

dimx defines the width of the output image.
dimy defines the height of the output image.
sampling defines the gap (in pixel) between 2 consecutive vectors.
factor is a multiplicative factor applied to vectors length. If the value is negative then it corresponds to a percentage of the maximum vector length.

Inputs

im_in: a multispectral 2D image with at least 2 bands. If the number of bands is greater than 2 then other bands are ignored.

Outputs

im_out: an image (Img2duc).

Result

Returns SUCCESS or FAILURE.

Examples

Displays the vector field of a translation of the tangram.pan image:

   ptranslation 0 10 tangram.pan tangram1.pan
   pregistrationPDE 0.1 0.9 tangram.pan tangram1.pan a.pan
   pplotquiver 800 800 10 -20 a.pan out.pan

C++ prototype

Errc PPlotQuiver( const Imx2d &ims, Img2duc &imd, Short sampling, Float factor );

Version française

Dessine un champ de vecteurs 2D à partir d'une image 2D multi-spectrale à deux composantes.

Important notice

The source code of this Pandore operator is governed by a specific Free-Software License (the CeCiLL License), also applying to the CImg Library. Please read it carefully, if you want to use this module in your own project (file CImg.h).

IN PARTICULAR, YOU ARE NOT ALLOWED TO USE THIS PANDORE MODULE IN A CLOSED-SOURCE PROPRIETARY PROJECT WITHOUT ASKING AN AUTHORIZATION TO THE CIMG LIBRARY AUTHOR ( http://www.greyc.ensicaen.fr/~dtschump/ )

Author: D. Tschumperlé