Difference between revisions of "Example Remove Perspective Distortion"

From BoofCV
Jump to navigationJump to search
m
m
 
(5 intermediate revisions by the same user not shown)
Line 9: Line 9:


Example Code:
Example Code:
* [https://github.com/lessthanoptimal/BoofCV/blob/v0.20/examples/src/boofcv/examples/geometry/ExampleRemovePerspectiveDistortion.java ExampleRemovePerspectiveDistortion.java]
* [https://github.com/lessthanoptimal/BoofCV/blob/v0.40/examples/src/main/java/boofcv/examples/geometry/ExampleRemovePerspectiveDistortion.java ExampleRemovePerspectiveDistortion.java]


Concepts:
Concepts:
* Homography
* Homography
* Perpsective
* Perspective
* Distortion
* Distortion


Line 24: Line 24:
/**
/**
  * Certain image processing techniques, such as Optical Character Recognition (OCR), can be performed better if
  * Certain image processing techniques, such as Optical Character Recognition (OCR), can be performed better if
  * perspective distortion is remove from an image. In this example a homography is computed from the four corners
  * perspective distortion is remove from an image. In this example a homography is computed from the four corners
  * of a bulletin board and the image is projected into a square image without perspective distortion. The
  * of a bulletin board and the image is projected into a square image without perspective distortion. The
  * {@link RemovePerspectiveDistortion} class is used to perform the distortion. The class is easy to understand
  * {@link RemovePerspectiveDistortion} class is used to perform the distortion. The class is easy to understand
  * if you know what a homography is, you should look at it!
  * if you know what a homography is, you should look at it!
  *
  *
Line 32: Line 32:
  */
  */
public class ExampleRemovePerspectiveDistortion {
public class ExampleRemovePerspectiveDistortion {
public static void main(String[] args) {
public static void main( String[] args ) {
 
// load a color image
// load a color image
BufferedImage buffered = UtilImageIO.loadImage(UtilIO.pathExample("goals_and_stuff.jpg"));
BufferedImage buffered = UtilImageIO.loadImageNotNull(UtilIO.pathExample("goals_and_stuff.jpg"));
MultiSpectral<ImageFloat32> input = ConvertBufferedImage.convertFromMulti(buffered, null, true, ImageFloat32.class);
Planar<GrayF32> input = ConvertBufferedImage.convertFromPlanar(buffered, null, true, GrayF32.class);


RemovePerspectiveDistortion<MultiSpectral<ImageFloat32>> removePerspective =
RemovePerspectiveDistortion<Planar<GrayF32>> removePerspective =
new RemovePerspectiveDistortion<MultiSpectral<ImageFloat32>>(400,500, ImageType.ms(3,ImageFloat32.class));
new RemovePerspectiveDistortion<>(400, 500, ImageType.pl(3, GrayF32.class));


// Specify the corners in the input image of the region.
// Specify the corners in the input image of the region.
// Order matters! top-left, top-right, bottom-right, bottom-left
// Order matters! top-left, top-right, bottom-right, bottom-left
if( !removePerspective.apply(input,
if (!removePerspective.apply(input,
new Point2D_F64(267, 182), new Point2D_F64(542, 68),
new Point2D_F64(267, 182), new Point2D_F64(542, 68),
new Point2D_F64(519, 736), new Point2D_F64(276, 570)) ){
new Point2D_F64(519, 736), new Point2D_F64(276, 570))) {
throw new RuntimeException("Failed!?!?");
throw new RuntimeException("Failed!?!?");
}
}


MultiSpectral<ImageFloat32> output = removePerspective.getOutput();
Planar<GrayF32> output = removePerspective.getOutput();


BufferedImage flat = ConvertBufferedImage.convertTo_F32(output,null,true);
BufferedImage flat = ConvertBufferedImage.convertTo_F32(output, null, true);
ShowImages.showWindow(buffered,"Original Image",true);
ShowImages.showWindow(buffered, "Original Image", true);
ShowImages.showWindow(flat,"Without Perspective Distortion",true);
ShowImages.showWindow(flat, "Without Perspective Distortion", true);
}
}
}
}
</syntaxhighlight>
</syntaxhighlight>

Latest revision as of 15:56, 17 January 2022

It is often easier to process an image after perspective distortion is removed. The billboard in this example is at an acute angle relative to the camera, making its text hard to read. A homography can be created, using the for cornerns of the billboard, and used to remove this distortion.

Example Code:

Concepts:

  • Homography
  • Perspective
  • Distortion

Relevant Examples:

Example Code

/**
 * Certain image processing techniques, such as Optical Character Recognition (OCR), can be performed better if
 * perspective distortion is remove from an image. In this example a homography is computed from the four corners
 * of a bulletin board and the image is projected into a square image without perspective distortion. The
 * {@link RemovePerspectiveDistortion} class is used to perform the distortion. The class is easy to understand
 * if you know what a homography is, you should look at it!
 *
 * @author Peter Abeles
 */
public class ExampleRemovePerspectiveDistortion {
	public static void main( String[] args ) {
		// load a color image
		BufferedImage buffered = UtilImageIO.loadImageNotNull(UtilIO.pathExample("goals_and_stuff.jpg"));
		Planar<GrayF32> input = ConvertBufferedImage.convertFromPlanar(buffered, null, true, GrayF32.class);

		RemovePerspectiveDistortion<Planar<GrayF32>> removePerspective =
				new RemovePerspectiveDistortion<>(400, 500, ImageType.pl(3, GrayF32.class));

		// Specify the corners in the input image of the region.
		// Order matters! top-left, top-right, bottom-right, bottom-left
		if (!removePerspective.apply(input,
				new Point2D_F64(267, 182), new Point2D_F64(542, 68),
				new Point2D_F64(519, 736), new Point2D_F64(276, 570))) {
			throw new RuntimeException("Failed!?!?");
		}

		Planar<GrayF32> output = removePerspective.getOutput();

		BufferedImage flat = ConvertBufferedImage.convertTo_F32(output, null, true);
		ShowImages.showWindow(buffered, "Original Image", true);
		ShowImages.showWindow(flat, "Without Perspective Distortion", true);
	}
}