Click or drag to resize
Accord.NET (logo)

DistanceTransform Class

Distance transform filter.
Inheritance Hierarchy
SystemObject
  Accord.Imaging.FiltersBaseInPlaceFilter
    Accord.Imaging.FiltersDistanceTransform

Namespace:  Accord.Imaging.Filters
Assembly:  Accord.Imaging (in Accord.Imaging.dll) Version: 3.8.0
Syntax
public class DistanceTransform : BaseInPlaceFilter
Request Example View Source

The DistanceTransform type exposes the following members.

Constructors
  NameDescription
Public methodDistanceTransform
Initializes a new instance of the DistanceTransform class.
Public methodDistanceTransform(DistanceTransformMethod)
Initializes a new instance of the DistanceTransform class.
Top
Properties
  NameDescription
Public propertyFormatTranslations
Format translations dictionary.
(Overrides BaseInPlaceFilterFormatTranslations.)
Public propertyMaximumDistance
Gets the maximum distance from the transform.
Public propertyPixels
Gets the resulting pixels of the last transfomed image as a float[] array.
Public propertyUltimateErodedPoint
Gets the ultimate eroded point.
Top
Methods
  NameDescription
Public methodApply(Bitmap)
Apply filter to an image.
(Inherited from BaseInPlaceFilter.)
Public methodApply(BitmapData)
Apply filter to an image.
(Inherited from BaseInPlaceFilter.)
Public methodApply(UnmanagedImage)
Apply filter to an image in unmanaged memory.
(Inherited from BaseInPlaceFilter.)
Public methodApply(UnmanagedImage, UnmanagedImage)
Apply filter to an image in unmanaged memory.
(Inherited from BaseInPlaceFilter.)
Public methodApplyInPlace(Bitmap)
Apply filter to an image.
(Inherited from BaseInPlaceFilter.)
Public methodApplyInPlace(BitmapData)
Apply filter to an image.
(Inherited from BaseInPlaceFilter.)
Public methodApplyInPlace(UnmanagedImage)
Apply filter to an unmanaged image.
(Inherited from BaseInPlaceFilter.)
Public methodEquals
Determines whether the specified object is equal to the current object.
(Inherited from Object.)
Protected methodFinalize
Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.
(Inherited from Object.)
Public methodGetHashCode
Serves as the default hash function.
(Inherited from Object.)
Public methodGetType
Gets the Type of the current instance.
(Inherited from Object.)
Protected methodMemberwiseClone
Creates a shallow copy of the current Object.
(Inherited from Object.)
Protected methodProcessFilter
Process the filter on the specified image.
(Overrides BaseInPlaceFilterProcessFilter(UnmanagedImage).)
Public methodToString
Returns a string that represents the current object.
(Inherited from Object.)
Top
Extension Methods
  NameDescription
Public Extension MethodHasMethod
Checks whether an object implements a method with the given name.
(Defined by ExtensionMethods.)
Public Extension MethodIsEqual
Compares two objects for equality, performing an elementwise comparison if the elements are vectors or matrices.
(Defined by Matrix.)
Public Extension MethodTo(Type)Overloaded.
Converts an object into another type, irrespective of whether the conversion can be done at compile time or not. This can be used to convert generic types to numeric types during runtime.
(Defined by ExtensionMethods.)
Public Extension MethodToTOverloaded.
Converts an object into another type, irrespective of whether the conversion can be done at compile time or not. This can be used to convert generic types to numeric types during runtime.
(Defined by ExtensionMethods.)
Top
Remarks

A distance transform, also known as distance map or distance field, is a derived representation of a digital image.The choice of the term depends on the point of view on the object in question: whether the initial image is transformed into another representation, or it is simply endowed with an additional map or field.

Distance fields can also be signed, in the case where it is important to distinguish whether the point is inside or outside of the shape. The map labels each pixel of the image with the distance to the nearest obstacle pixel. A most common type of obstacle pixel is a boundary pixel in a binary image.See the image for an example of a chessboard distance transform on a binary image.

Usually the transform/map is qualified with the chosen metric.For example, one may speak of Manhattandistance transform, if the underlying metric is Manhattan distance. Common metrics are: The Euclidean distance; the Taxicab geometry, also known as City block distance or Manhattan distance; and the Chessboard distance.

References:

Examples
Bitmap input = ... 

// Apply the transform
DistanceTransform dt = new DistanceTransform();
Bitmap output = dt.Apply(input);

// Show results on screen
ImageBox.Show("input", input);
ImageBox.Show("output", output);
See Also