ppixelvalue

Gets pixel value from grayscale image and region map.

Synopsis

ppixelvalue x y z [-m mask] [im_in|-] [col_out|-]

Description

ppixelvalue returns the value at the specified coordinates (x,y,z) in the input image or in the input region map im_in.

This value can be get using operator pstatus.

The pixel values for each band are stored in the collection col_out.

Parameters

x, y, z specify the coordinate of the pixel. For 2D image, z is ignored but must be given.

Inputs

im_in: an image or a region map.

Outputs

col_out: a collection of float values.

Result

Returns the pixel value or FAILURE if the coordinates is not held by the input image (for the first band only). This value can be get using operator pstatus.

Examples

Returns the value of the pixel 20,50 in tangram.pan (Unix version):

   ppixelvalue 20 50 0 tangram.pan col.pan
   val=`pstatus`
   echo "value = $val"

Returns the value of the pixel 20,50 in tangram.pan (MsDOS version):

   ppixelvalue 20 50 0 tangram.pan col.pan
   call pstatus
   call pset val
   echo Value = %val%

C++ prototype

Float PPixelValue( const Img3duc &im_in, Collection & col_out, Long z, Long y, Long x );

Version française

Affiche la valeur d'un pixel d'un image ou d'un noeud d'un graphe donné.

Author: Régis Clouard