001/*******************************************************************************
002 * This software is provided as a supplement to the authors' textbooks on digital
003 * image processing published by Springer-Verlag in various languages and editions.
004 * Permission to use and distribute this software is granted under the BSD 2-Clause
005 * "Simplified" License (see http://opensource.org/licenses/BSD-2-Clause).
006 * Copyright (c) 2006-2023 Wilhelm Burger, Mark J. Burge. All rights reserved.
007 * Visit https://imagingbook.com for additional details.
008 ******************************************************************************/
009package Ch05_Edges_Contours;
010
011import Ch16_Color_Edges.Color_Edges_Canny;
012import ij.ImagePlus;
013import ij.plugin.filter.PlugInFilter;
014import ij.process.ImageProcessor;
015import imagingbook.common.edges.CannyEdgeDetector;
016import imagingbook.common.ij.DialogUtils;
017import imagingbook.common.ij.IjUtils;
018import imagingbook.core.jdoc.JavaDocHelp;
019import imagingbook.sampleimages.GeneralSampleImage;
020
021import static imagingbook.common.ij.IjUtils.noCurrentImage;
022
023/**
024 * <p>
025 * ImageJ plugin showing the use of the Canny edge detector in its simplest form. It works on all image types. This
026 * plugin simply delegates to another plugin (@link Color_Edges_Canny}). The original image is not modified. See Sec.
027 * 5.5 of [1] for additional details.
028 * </p>
029 * <p>
030 * [1] W. Burger, M.J. Burge, <em>Digital Image Processing &ndash; An Algorithmic Introduction</em>, 3rd ed, Springer
031 * (2022).
032 * </p>
033 *
034 * @author WB
035 * @see CannyEdgeDetector
036 * @see Color_Edges_Canny
037 */
038public class Canny_Edges implements PlugInFilter, JavaDocHelp {
039
040    /**
041     * Constructor, asks to open a predefined sample image if no other image is currently open.
042     */
043    public Canny_Edges() {
044        if (noCurrentImage()) {
045            DialogUtils.askForSampleImage(GeneralSampleImage.Boats);
046        }
047    }
048
049    @Override
050    public int setup(String arg0, ImagePlus im) {
051        return DOES_ALL + NO_CHANGES;
052    }
053
054    @Override
055    public void run(ImageProcessor ip) {
056        // delegate to another plugin:
057        IjUtils.runPlugInFilter(Color_Edges_Canny.class);
058    }
059}