BorderDimensions

✖
`BorderDimensions`

✖

BorderDimensions[image]

gives the pixel width of uniform borders of image in the form {{left,right},{bottom,top}}.

✖

BorderDimensions[image,t]

finds borders whose pixels vary by an amount less than t.

Details and Options

BorderDimensions works with binary, grayscale, and multichannel images.
BorderDimensions[image] is equivalent to BorderDimensions[image,0.02].
ImagePad[image,-BorderDimensions[image]] effectively removes uniform image margins.
BorderDimensions works with Image3D objects and returns the borders in the form {{left,right},{front,back},{bottom,top}}.

Background & Context

BorderDimensions computes the constant or semi-uniform border or frame around a 2D or 3D image and returns them as an array of integer values of the form {{left,right},{bottom,top}} (for an Image) or {{left,right},{bottom,top},{bottom,top}} (for an Image3D). With an optional second argument, BorderDimensions finds borders whose pixels vary by an amount less than a given threshold.
Border dimensions of a uniform image are considered zero.
ImagePad can be used to remove the detected border from an image. ImageCrop is another function that can be used to crop an almost-uniform border. However, unlike BorderDimensions, ImageCrop does not allow specification of a variance threshold.

Examples

open allclose all

Basic Examples (1)Summary of the most common use cases

Find the pixel dimensions of the black margins:

In[1]:=1

✖

https://wolfram.com/xid/0bnix10e24zro-jmpu3s

Out[1]=1

Scope (3)Survey of the scope of standard use cases

Border dimensions of a grayscale image:

In[14]:=14

✖

https://wolfram.com/xid/0bnix10e24zro-i01adn

Out[14]=14

Specify a higher tolerance to detect a noisy image border:

In[1]:=1

✖

https://wolfram.com/xid/0bnix10e24zro-d6m1uh

Out[1]=1

Border dimensions of a 3D volume:

In[1]:=1

✖

https://wolfram.com/xid/0bnix10e24zro-9lnpac

Out[1]=1

Applications (3)Sample problems that can be solved with this function

Remove blue borders of a color image:

In[1]:=1

✖

https://wolfram.com/xid/0bnix10e24zro-jtwh1w

In[2]:=2

✖

https://wolfram.com/xid/0bnix10e24zro-dw42br

Out[2]=2

Extract the text part of a scanned book:

In[1]:=1

✖

https://wolfram.com/xid/0bnix10e24zro-85p0v

Out[1]=1

Extract the foreground objects over a smoothly shaded background:

In[1]:=1

✖

https://wolfram.com/xid/0bnix10e24zro-cfxlek

Out[1]=1

Properties & Relations (1)Properties of the function, and connections to other functions

Border dimensions of a uniform image are considered zero:

In[1]:=1

✖

https://wolfram.com/xid/0bnix10e24zro-ojz58a

Out[1]=1

Top