pcliparea

Select rectangular region area of image, region map or graph.

Synopsis

pcliparea x y z width height depth [im_in|-] [im_out|-]

Description

pcliparea selects a rectangular area in the input im_in. Values outside the rectangle are set to 0, other values are copied to the output im_out.

Parameters

x, y, z specify the cordinates and width, height, depth specify the size of the rectangular area. If width (respectively height and depth) are < 1 or greater than the image width then it is supposed to be set with the maximum width (respectively to the maximum height and depth). For 2D objects, z and depth must be given but are ignored.

Inputs

im_in: an image, a region map, or a graph.

Outputs

im_out: an object of the same type as the input image.

Result

Returns SUCCESS or FAILURE.

Examples

Select area (10,10,246,50) from the tangram.pan image (of size 256x256 pxeils):

   pcliparea 10 10 -1 50 0 0 tangram.pan a.pan

C++ prototype

Errc PClipArea( const Imxg2duc &ims, Img2duc &imd, const int z, const int y, const int x, int width, int height, int depth) {

Version française

Sélection d'une zone d'image, de carte de région ou de graphe.

Author: Régis Clouard