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.IJ;
012import ij.ImagePlus;
013import ij.plugin.filter.PlugInFilter;
014import ij.process.ByteProcessor;
015import ij.process.ImageProcessor;
016import imagingbook.common.threshold.global.OtsuThresholder;
017import imagingbook.core.jdoc.JavaDocHelp;
018import imagingbook.sampleimages.GeneralSampleImage;
019
020import static imagingbook.common.ij.DialogUtils.askForSampleImage;
021import static imagingbook.common.ij.IjUtils.noCurrentImage;
022import static java.lang.Float.isFinite;
023
024/**
025 * <p>
026 * ImageJ plugin showing the use of the {@link OtsuThresholder} class.
027 * See Sec. 9.1.4 of [1] for additional details.
028 * </p>
029 * <p>
030 * [1] W. Burger, M.J. Burge, <em>Digital Image Processing &ndash; 
031 * An Algorithmic Introduction</em>, 3rd ed, Springer (2022).
032 * </p>
033 * 
034 * @author WB
035 * @version 2022/04/02
036 * @see imagingbook.common.threshold.global.OtsuThresholder
037 */
038public class Global_Otsu implements PlugInFilter, JavaDocHelp {
039        
040        /**
041         * Constructor, asks to open a predefined sample image if no other image
042         * is currently open.
043         */
044        public Global_Otsu() {
045                if (noCurrentImage()) {
046                        askForSampleImage(GeneralSampleImage.Kepler);
047                }
048        }
049        
050        @Override
051        public int setup(String arg, ImagePlus imp) {
052                return DOES_8G;
053        }       
054
055        @Override
056        public void run(ImageProcessor ip) {
057                ByteProcessor bp = (ByteProcessor) ip;
058                
059                OtsuThresholder thr = new OtsuThresholder();
060                float q = thr.getThreshold(bp);
061
062                if (isFinite(q)) {
063                        bp.threshold(Math.round(q));
064                }
065                else {
066                        IJ.showMessage("no threshold found");
067                }
068        }
069
070}