Module imagingbook.common

Package imagingbook.common.filter.edgepreserving

Class BilateralFilterScalarSeparable

java.lang.Object

imagingbook.common.filter.generic.GenericFilter

imagingbook.common.filter.generic.GenericFilterScalarSeparable

imagingbook.common.filter.edgepreserving.BilateralFilterScalarSeparable

All Implemented Interfaces:

BilateralF, ProgressReporter

public class BilateralFilterScalarSeparable
extends GenericFilterScalarSeparable
implements BilateralF

Scalar and separable version of the Bilateral filter as proposed in [1]. On color images, this filter is applied separately to each color component. The filter uses Gaussian domain and range kernels and can be applied to all image types. See Sec. 17.2 of [2] for additional details.

[1] C. Tomasi and R. Manduchi, "Bilateral Filtering for Gray and Color Images", Proceedings of the 1998 IEEE International Conference on Computer Vision, Bombay, India.
[2] W. Burger, M.J. Burge, Digital Image Processing – An Algorithmic Introduction, 3rd ed, Springer (2022).

Version:

2021/01/01

Nested Class Summary

Nested classes/interfaces inherited from interface imagingbook.common.filter.edgepreserving.BilateralF

BilateralF.Parameters

Field Summary

Fields inherited from class imagingbook.common.filter.generic.GenericFilterScalarSeparable

doX, doY

Constructor Summary

Constructors

Constructor	Description
BilateralFilterScalarSeparable()
BilateralFilterScalarSeparable(BilateralF.Parameters params)

Method Summary

Modifier and Type	Method	Description
protected float	doPixelX(PixelPack.PixelSlice source, int u, int v)	Applies a 1D filter operation in x-direction.
protected float	doPixelY(PixelPack.PixelSlice source, int u, int v)	Applies a 1D filter operation in y-direction.

Methods inherited from class imagingbook.common.filter.generic.GenericFilterScalarSeparable

reportProgress, runPass

Methods inherited from class imagingbook.common.filter.generic.GenericFilter

abort, applyTo, applyTo, applyTo, closeFilter, getDepth, getHeight, getPass, getProgress, getWidth, initFilter, initPass, passesRequired, reportProgress

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

BilateralFilterScalarSeparable

public BilateralFilterScalarSeparable()

BilateralFilterScalarSeparable

public BilateralFilterScalarSeparable(BilateralF.Parameters params)

Method Details

doPixelX

protected float doPixelX(PixelPack.PixelSlice source,
 int u,
 int v)

Description copied from class: GenericFilterScalarSeparable

Applies a 1D filter operation in x-direction. This method must be implemented by concrete sub-classes. This method is invoked before GenericFilterScalarSeparable.doPixelY(PixelSlice, int, int). The source data are passed as a PixelPack.PixelSlice container, which holds the scalar values of one image component. The method PixelPack.PixelSlice.getVal(int, int) should be used to read individual pixel values. These data should not be modified but the (float) result of the single-pixel calculation must be returned.

Specified by:

doPixelX in class GenericFilterScalarSeparable

Parameters:

source - the scalar-valued data for a single image component

u - the current x-position

v - the current y-position

Returns:

the result of the filter calculation for this pixel

doPixelY

protected float doPixelY(PixelPack.PixelSlice source,
 int u,
 int v)

Description copied from class: GenericFilterScalarSeparable

Applies a 1D filter operation in y-direction. This method must be implemented by concrete sub-classes. This method is invoked after GenericFilterScalarSeparable.doPixelX(PixelSlice, int, int). The source data are passed as a PixelPack.PixelSlice container, which holds the scalar values of one image component. The method PixelPack.PixelSlice.getVal(int, int) should be used to read individual pixel values. These data should not be modified but the (float) result of the single-pixel calculation must be returned.

Specified by:

doPixelY in class GenericFilterScalarSeparable

Parameters:

source - the scalar-valued data for a single image component

u - the current x-position

v - the current y-position

Returns:

the result of the filter calculation for this pixel