Algorithm allowing to bound image values to a given range algorithm. More...

IPSDKIPLARITHMETIC_API ipsdk::image::ImagePtr	ipsdk::imaproc::arithm::boundImg (const ipsdk::image::ImageConstPtr &pInImg, const ipsdk::imaproc::attr::RangeConstPtr &pInOutputRange)
	wrapper function for Algorithm allowing to bound image values to a given range More...

IPSDKIPLARITHMETIC_API void	ipsdk::imaproc::arithm::boundImg (const ipsdk::image::ImageConstPtr &pInImg, const ipsdk::imaproc::attr::RangeConstPtr &pInOutputRange, const ipsdk::image::ImagePtr &pOutImg)
	wrapper function for Algorithm allowing to bound image values to a given range More...

Detailed Description

Algorithm allowing to bound image values to a given range algorithm.

Given an input image $ InImg $ and an input range for output image $ InOutputRange = [InOutputMin, InOutputMax] $ , output image values are given by :

$OutImg[i] = \begin{cases} InOutputMin & \text { if } InImg[i] < InOutputMin \\ InOutputMax & \text { if } InImg[i] > InOutputMax \\ InImg[i] \text { otherwise} \end{cases}$

Here is an example of image bound applied to a 8-bits grey level image with $[InOutputMin, InOutputMax]=[75, 150]$ :

Attributes description

Attribute description for algorithm :

Name	ToolTip	Default Initializer
ipsdk::imaproc::attr::InImg	[Input] image for processing operation	X
ipsdk::imaproc::attr::InOutputRange	[Input] output image intensity range for algorithm	X
ipsdk::imaproc::attr::OutImg	[Output] image for processing operation	duplicateInOut (_pOutImg, _pInImg)

Global Rule description

Global rule description for algorithm :
((ipsdk::imaproc::matchSize (_pInImg,_pOutImg)) && (matchImageRange<ipsdk::imaproc::attr::Range::Min>(_pOutImg,_pInOutputRange)) && (matchImageRange<ipsdk::imaproc::attr::Range::Max>(_pOutImg,_pInOutputRange)))

Example of Python code :

Example imports

import PyIPSDK

import PyIPSDK.IPSDKIPLArithmetic as arithm

Code Example

    # opening of input image
    inImg = PyIPSDK.loadTiffImageFile(inputImgPath)
    
    # image bounding
    outImg = arithm.boundImg(inImg, PyIPSDK.createRange(75, 150))

Example of C++ code :

Example informations

Associated library

IPSDKIPLArithmetic

Header file

#include <IPSDKIPL/IPSDKIPLArithmetic/Processor/BoundImg/BoundImg.h>

Code Example

    // opening input image
    ImagePtr pInImg = loadTiffImageFile(inputImgPath);
    // define a bounding range
    RangePtr pRange(boost::make_shared<Range>());
    pRange->setValue<Range::Min>(75);
    pRange->setValue<Range::Max>(150);
    // apply image bounding
    ImagePtr pOutImg = boundImg(pInImg, pRange);

See also: BoundImgLvl1; BoundImgLvl2; BoundImgLvl3

Function Documentation

◆ boundImg() [1/2]

IPSDKIPLARITHMETIC_API ipsdk::image::ImagePtr ipsdk::imaproc::arithm::boundImg	(	const ipsdk::image::ImageConstPtr &	pInImg,
		const ipsdk::imaproc::attr::RangeConstPtr &	pInOutputRange
	)

wrapper function for Algorithm allowing to bound image values to a given range

Exceptions

ipsdk::processor::IPSDKBaseProcessingException on failure

◆ boundImg() [2/2]

IPSDKIPLARITHMETIC_API void ipsdk::imaproc::arithm::boundImg	(	const ipsdk::image::ImageConstPtr &	pInImg,
		const ipsdk::imaproc::attr::RangeConstPtr &	pInOutputRange,
		const ipsdk::image::ImagePtr &	pOutImg
	)

wrapper function for Algorithm allowing to bound image values to a given range

Exceptions

ipsdk::processor::IPSDKBaseProcessingException on failure