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 Ch21_Geometric_Operations;
010
011import ij.ImagePlus;
012import ij.plugin.filter.PlugInFilter;
013import ij.process.ImageProcessor;
014import imagingbook.common.geometry.mappings.linear.Translation2D;
015import imagingbook.common.ij.DialogUtils;
016import imagingbook.common.ij.IjUtils;
017import imagingbook.common.image.ImageMapper;
018import imagingbook.common.image.OutOfBoundsStrategy;
019import imagingbook.common.image.interpolation.InterpolationMethod;
020import imagingbook.core.jdoc.JavaDocHelp;
021import imagingbook.sampleimages.GeneralSampleImage;
022
023/**
024 * <p>
025 * ImageJ plugin, applies a continuous translation to the current image. See Sec. 21.1.1 of [1] for details. Optionally
026 * opens a sample image if no image is currently open.
027 * </p>
028 * <p>
029 * [1] W. Burger, M.J. Burge, <em>Digital Image Processing &ndash; An Algorithmic Introduction</em>, 3rd ed, Springer
030 * (2022).
031 * </p>
032 *
033 * @author WB
034 * @version 2022/11/28
035 * @see ImageMapper
036 * @see Translation2D
037 */
038public class Map_Translate implements PlugInFilter, JavaDocHelp {
039        
040        private static double dx = 5.25;
041        private static double dy = 7.3;
042        
043        /**
044         * Constructor, asks to open a predefined sample image if no other image
045         * is currently open.
046         */
047        public Map_Translate() {
048                if (IjUtils.noCurrentImage()) {
049                        DialogUtils.askForSampleImage(GeneralSampleImage.Kepler);
050                }
051        }
052        
053    @Override
054        public int setup(String arg, ImagePlus imp) {
055        return DOES_ALL;
056    }
057
058    @Override
059        public void run(ImageProcessor ip) {
060
061                Translation2D imap = new Translation2D(dx, dy).getInverse();
062                new ImageMapper(imap, OutOfBoundsStrategy.ZeroValues, InterpolationMethod.Bicubic).map(ip);
063    }
064
065}