pextractsubimage

Extracts subimage from image.

Synopsis

pextractsubimage x y z l h p [im_in|-] [im_out|-]

Description

pextractsubimage builds a new image im_out with pixels of the input image im_in included in the window beginning at coordinates (x,y,z) and with the dimension (l,h,p).

For region map, there is no relabeling. The regions in im_out keep the same label than in im_in even if some regions have disappeared.

Parameters

x,y,z specify the coordinates in im_in1 of the image im_out.
l,h,p specify the dimensions of the image im_out. If one of the dimension is lower than 0 or greater than the maximum then the maximum size is used.
In case of 2D image, z and p parameters are ignored but must be given.

Inputs

im_in: an image or a region map.

Outputs

im_out: an object of the same type as im_in.

Result

For image returns SUCCESS or FAILURE. For region map returns the maximum label or FAILURE.

Examples

Extracts part of the tangram.pan from coordinates (75, 55) and size (50, 55) as new image.

   pextractsubimage 75 55 0 50 55 0 examples/tangram.pan a.pan

Extracts part of the tangram.pan from coordinates (75, 55) to maximum coordinates as a new image.

   pextractsubimage 75 55 0 -1 -1 0 examples/tangram.pan a.pan

C++ prototype

Errc PExtractSubImage( const Img2duc &im_in, Img2duc &im_out, Long cx, Long cy, Long cz );

Version française

Extraction d'une sous-image d'une image.

Author: Régis Clouard