rstreet85 / jcanny

A Java program for detecting edges in an image using the Canny method.

JCanny

A pure Java implementation of John Canny's 1986 edge detector, including a Gaussian filter. The algorithm accepts an image, converts it to grayscale, blurs it with a Gaussian filter, and then detects the edges within it. It does so by finding the 'edge' magnitude of each pixel with a bi-directional Sobel operator, then disregarding all 'weak' edge pixels unless they are directly adjacent to a 'strong' edge pixel (hysteresis). The Canny is elegant - despite it's age and simplicity, it is still the standard for edge detection, and readily lends itself to optimization. This program is intended to provide quick method of detecting edges and study the Canny method, as well as getting quick feedback while tweaking parameters for specific projects.

Tester Class Usage

Command-line arguments: -fileName -outputFileExtension

Code Usage

//Sample JCanny usage
try {
    BufferedImage input = ImageIO.read(new File(imgFileName));
    BufferedImage output = JCanny.CannyEdges(input, CANNY_STD_DEV, CANNY_THRESHOLD_RATIO);
    ImageIO.write(output, imgExt, new File(imgOutFile));
} catch (Exception ex) {
    System.out.println("ERROR ACCESING IMAGE FILE:\n" + ex.getMessage());
}

Example:

test/test1.png png

To-Do

• Allow user to set the paramters for Gaussian filter & hysteresis for optimization purposes
• Add Pratt figure of merit functionality, so that user can designate what edges they want, and determine how closely the output from parameters match.
• Explore additional preprocessing methods, such as white balance.
• Current edge image is smaller than original, add buffer to fix this

jcanny's Issues

Mark Deprecated

Edit README to explicitly state that development on this repo has ceased.