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 Ch09_Automatic_Thresholding;
010
011import ij.ImagePlus;
012import ij.gui.GenericDialog;
013import ij.plugin.filter.PlugInFilter;
014import ij.process.ByteProcessor;
015import ij.process.FloatProcessor;
016import ij.process.ImageProcessor;
017import imagingbook.common.threshold.adaptive.AdaptiveThresholder;
018import imagingbook.common.threshold.adaptive.BernsenThresholder;
019import imagingbook.common.threshold.adaptive.BernsenThresholder.Parameters;
020import imagingbook.core.jdoc.JavaDocHelp;
021import imagingbook.sampleimages.GeneralSampleImage;
022
023import static imagingbook.common.ij.DialogUtils.addToDialog;
024import static imagingbook.common.ij.DialogUtils.askForSampleImage;
025import static imagingbook.common.ij.DialogUtils.getFromDialog;
026import static imagingbook.common.ij.IjUtils.noCurrentImage;
027
028/**
029 * <p>
030 * ImageJ plugin showing the use of the {@link BernsenThresholder} class
031 * (see Sec. 9.2.1 of [1] for additional details).
032 * This plugin works on 8-bit grayscale images only. The original image
033 * is modified to a binary image.
034 * </p>
035 * <p>
036 * [1] W. Burger, M.J. Burge, <em>Digital Image Processing &ndash; An Algorithmic
037 * Introduction</em>, 3rd ed, Springer (2022).
038 * </p>
039 * 
040 * @author WB
041 * @version 2022/04/01
042 * @see imagingbook.common.threshold.adaptive.BernsenThresholder
043 */
044public class Adaptive_Bernsen implements PlugInFilter, JavaDocHelp {
045        
046        private static Parameters params = new Parameters();
047        private static boolean ShowThresholdSurface = false;
048        
049        /**
050         * Constructor, asks to open a predefined sample image if no other image
051         * is currently open.
052         */
053        public Adaptive_Bernsen() {
054                if (noCurrentImage()) {
055                        askForSampleImage(GeneralSampleImage.Kepler);
056                }
057        }
058        
059        @Override
060        public int setup(String arg, ImagePlus imp) {
061                return DOES_8G;
062        }
063
064        @Override
065        public void run(ImageProcessor ip) {
066                if (!runDialog(params))
067                        return;
068                
069                ByteProcessor I = (ByteProcessor) ip;   
070                AdaptiveThresholder thr = new BernsenThresholder(params);
071                FloatProcessor Q = thr.getThreshold(I);
072                thr.threshold(I, Q);
073                if (ShowThresholdSurface) {
074                        new ImagePlus("Threshold (Q)", Q).show();
075                }
076
077        }
078        
079        boolean runDialog(Parameters params) {
080                GenericDialog gd = new GenericDialog(this.getClass().getSimpleName());
081                gd.addHelp(getJavaDocUrl());
082                addToDialog(params, gd);
083                gd.addCheckbox("Show threshold surface", ShowThresholdSurface);
084                
085                gd.showDialog();
086                if (gd.wasCanceled()) {
087                        return false;
088                }       
089                
090                getFromDialog(params, gd);
091                ShowThresholdSurface = gd.getNextBoolean();
092                return true;
093        }
094}