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.NiblackThresholder;
018import imagingbook.common.threshold.adaptive.NiblackThresholder.Parameters;
019import imagingbook.common.threshold.adaptive.NiblackThresholder.RegionType;
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 demonstrating the use of the {@link NiblackThresholder} class. See Sec. 9.2.2 of [1] for additional
031 * details.
032 *
033 * @author WB
034 * @version 2022/04/01
035 * @see imagingbook.common.threshold.adaptive.NiblackThresholder
036 */
037public class Adaptive_Niblack implements PlugInFilter, JavaDocHelp {
038        
039//      enum RegionType { Box, Disk, Gaussian }
040        
041        private static RegionType regType = RegionType.Box;
042        private static Parameters params = new Parameters();
043        private static boolean ShowThresholdSurface = false;
044
045        /**
046         * Constructor, asks to open a predefined sample image if no other image is currently open.
047         */
048        public Adaptive_Niblack() {
049                if (noCurrentImage()) {
050                        askForSampleImage(GeneralSampleImage.Kepler);
051                }
052        }
053        
054        @Override
055        public int setup(String arg, ImagePlus imp) {
056                return DOES_8G;
057        }
058
059        @Override
060        public void run(ImageProcessor ip) {
061                if (!runDialog(params))
062                        return;
063                
064                ByteProcessor I = (ByteProcessor) ip;
065                NiblackThresholder thr = NiblackThresholder.create(regType, params);
066                FloatProcessor Q = thr.getThreshold(I);
067                thr.threshold(I, Q);
068
069                if (ShowThresholdSurface) {
070                        (new ImagePlus("Niblack-Threshold", Q)).show();
071                }
072
073        }
074        
075        boolean runDialog(Parameters params) {
076                GenericDialog gd = new GenericDialog(this.getClass().getSimpleName());
077                gd.addHelp(getJavaDocUrl());
078                gd.addEnumChoice("Region type", regType);
079                addToDialog(params, gd);
080                gd.addCheckbox("Show threshold surface", ShowThresholdSurface);
081                
082                gd.showDialog();
083                if (gd.wasCanceled()) {
084                        return false;
085                }
086                
087                regType = gd.getNextEnumChoice(RegionType.class);
088                getFromDialog(params, gd);
089                ShowThresholdSurface = gd.getNextBoolean();
090                return true;
091        }
092}