pcopyborder

Copy image border.

Synopsis

pcopyborder widthl widthr heightu heightd depthf depthb [im_in1|-] [im_in2|-] [im_out|-]

Description

pcopyborder copy the pixels on the border of the the image im_in2 to the image im_in1. The result image im_out is a copy of im_in1 except the border that is a copy of the im_in2. The border is defined by the dimensions widthl, widthr, heightu, heightd, depthf, depthb where widthl is the length of the left border, widthr is the length of the right border, heightu is the height of the upper border, heightd is the height of the lower border, depthf is the depth of the forward border and depthf is the depth of the backward border.

For a 2D image, the dimensions are:

    --------------------------------------
    |                 ^                  |
    |                 |                  |
    |               heightu              |
    |                 |                  |
    |                 v                  |
    |           -------------            |
    |           |             |          |
    | <-widthl->|             |<-widthr->|
    |           |             |          |
    |            -------------           |
    |                 ^                  |
    |                 |                  |
    |              heigthd               |
    |                 |                  |
    |                 v                  |
    -------------------------------------

For color and multispectral image, the value is set on each bands.

Parameters

depthf, depthb, heightu, heightd, widthl, widthr specify the dimensions of the border.
In case of 2D image, depthf and depthb are not used but must be given.

Inputs

im_in1: an image.
im_in2: an image with the same properties as im_in.

Outputs

im_out: an image with the same type as im_in.

Result

Returns SUCCESS or FAILURE.

Examples

Selects objects of a tangram.pan subimage (in.pan) that do not touch the border of the image reg.pan.

   pextractsubimage  30 30 0 150 150 0 tangram.pan in.pan
   pcopycst 0 ii.pan i1.pan
   pcopyborder 1 1 1 1 1 1 i1.pan in.pan i2.pan
   pdilationreconstruction 8 i2.pan ii.pan i3.pan
   pdif in.pan i3.pan out.pan

C++ prototype

Errc PCopyBorder( const Img3duc &im_in1, const Img3duc &im_in2, Img3duc &im_out, Long widthl, Long widthr, Long heightu, Long heigthd, Long depthf, Long depthb);

Version française

Copie les valeurs du bord d'une image dans une autre.

Author: Régis Clouard