IPSDK  4_1_0_2
IPSDK : Image Processing Software Development Kit

subtraction of 2 images More...

IPSDKIPLARITHMETIC_API image::ImagePtr ipsdk::imaproc::arithm::subtractImgImg (const image::ImageConstPtr &pInImg1, const image::ImageConstPtr &pInImg2)
 Wrapper functions for subtraction of one image by another, pixel by pixel. More...
 
IPSDKIPLARITHMETIC_API void ipsdk::imaproc::arithm::subtractImgImg (const image::ImageConstPtr &pInImg1, const image::ImageConstPtr &pInImg2, const image::ImagePtr &pOutImg)
 Wrapper functions for subtraction of one image by another, pixel by pixel. More...
 

Detailed Description

subtraction of 2 images

On output image values are given by:

\[ OutImg[i] = InImg1[i] - InImg2[i] \]

Input and output images must have same size.

Here is an example of a subtraction operation applied to two 8-bits grey level images:

subtractImgImg.png

Attributes description

Attribute description for algorithm :

Name ToolTip Default Initializer
ipsdk::imaproc::attr::InImg1 [Input] First image for processing operation X
ipsdk::imaproc::attr::InImg2 [Input] Second image for processing operation X
ipsdk::imaproc::attr::OutImg [Output] image for processing operation promoteBinary (_pOutImg, _pInImg1, _pInImg2, ipsdk::imaproc::ePromoteBinaryType::ePBT_UpperSigned)

Global Rule description

Global rule description for algorithm :
ipsdk::imaproc::matchSize (_pInImg1,_pInImg2)

Example of Python code :

Example imports

import PyIPSDK
import PyIPSDK.IPSDKIPLArithmetic as arithm

Code Example

# opening input images
geometry = PyIPSDK.geometry2d(PyIPSDK.eImageBufferType.eIBT_Real32, 510, 509)
inImg1 = PyIPSDK.loadRawImageFile(inputImg1Path, geometry)
inImg2 = PyIPSDK.loadRawImageFile(inputImg2Path, geometry)
# subtraction of image 1 by image 2
outImg = arithm.subtractImgImg(inImg1, inImg2)

Example of C++ code :

Example informations

Associated library

IPSDKIPLArithmetic

Header file

Code Example

// open input images
ImageGeometryPtr pInputImageGeometry = geometry2d(inType, sizeX, sizeY);
ImagePtr pInImg1 = loadRawImageFile(in1Path, *pInputImageGeometry);
ImagePtr pInImg2 = loadRawImageFile(in2Path, *pInputImageGeometry);
// Sample with a generated output image
// ------------------------------------
// compute subtraction for input images
ImagePtr pAutoOutImg = subtractImgImg(pInImg1, pInImg2);
// Sample with a provided output image
// -----------------------------------
// create output image
ImageGeometryPtr pOutputImageGeometry = geometry2d(outType, sizeX, sizeY);
boost::shared_ptr<MemoryImage> pOutImg(boost::make_shared<MemoryImage>());
pOutImg->init(*pOutputImageGeometry);
// compute subtraction of input images
subtractImgImg(pInImg1, pInImg2, pOutImg);
See also
SubtractImgImgLvl1
SubtractImgImgLvl2
SubtractImgImgLvl3

Function Documentation

◆ subtractImgImg() [1/2]

IPSDKIPLARITHMETIC_API image::ImagePtr ipsdk::imaproc::arithm::subtractImgImg ( const image::ImageConstPtr pInImg1,
const image::ImageConstPtr pInImg2 
)

Wrapper functions for subtraction of one image by another, pixel by pixel.

Exceptions
ipsdk::processor::IPSDKBaseProcessingExceptionon failure

◆ subtractImgImg() [2/2]

IPSDKIPLARITHMETIC_API void ipsdk::imaproc::arithm::subtractImgImg ( const image::ImageConstPtr pInImg1,
const image::ImageConstPtr pInImg2,
const image::ImagePtr pOutImg 
)

Wrapper functions for subtraction of one image by another, pixel by pixel.

Exceptions
ipsdk::processor::IPSDKBaseProcessingExceptionon failure