psuperimposition

Synopsis

Description

psuperimposition builds the output image im_out by adding the pixels of the mask image im_mask in the specified band of the input image im_in. For example, if color_mask=1 then the mask is adding in the red band.

This operator is useful to visualize contours extracted from an image directly on this image.

The output image is of the same type as the input image.

Parameters

• color_mask specified the colorization mask. It acts like a bit mask. For example, if we consider a color image with 3 bands:
  • mask=0: the mask is painted in black.
  • mask=1: the mask is painted in red.
  • mask=2: the mask is painted in green.
  • mask=3: the mask is painted in yellow: red+green.
  • mask=4: the mask is painted in blue.
  • mask=5: the mask is painted in purple: red+blue.
  • mask=5: the mask is painted in magenta: green+blue.
  • mask=7: the mask is painted in white.

Inputs

• im_in: an image.
• mk_in: a gray image.

Outputs

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

Examples

• Visualize the contours extracted from the tangram image over the tangram image:

     pgradient 1 examples/tangram.pan i1.pan i2.pan
     pbinarization 30 1e30 i1.pan i3.pan
     pbinarization 60 1e30 i1.pan i4.pan
     pgeodesicdilation 1 1 -1 i4.pan i3.pan i4.pan
     psuperimposition 1 examples/tangram.pan i4.pan out.pan
  

Result

Returns SUCCESS or FAILURE.

See also

C++ prototype