pinsertsubimage

Inserts subimage into image.

Synopsis

pinsertsubimage x y z [im_in1|-] [im_in2|-] [im_out|-]

Description

pinsertsubimage builds a new image im_out by inserting image im_in2 into image im_in1 at coordinates (x,y, z). Insertion is done by replacing pixels of im_in1 with pixels of im_in2.

For region map, regions of im_in2 are added to image im_in1 with label values greater than the maximum label value of im_in1. Thus, the maximum label value of output image im_out is the maximum label of im_in1 + the maximum label of im_in2.

Parameters

x, y, z specify the coordinates in image im_in1 of the higher left corner of image im_in2.
In case of 2D image, z parameter is 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 of FAILURE.

Examples

Inserts image a.pan into tangram.pan:

   pinsertsubimage 10 10 0 a.pan tangram.pan b.pan

C++ prototype

Errc PInsertSubImage( const Img3duc &im_in1, const Img3duc &im_in2, Img3duc &im_out, Long cz, Long cy, Long cx );

Version française

Insertion d'une image dans une autre image.

Author: Régis Clouard