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 imagingbook.common.geometry.mappings;
010
011import imagingbook.common.geometry.basic.Pnt2d;
012
013/**
014 * Common interface to be implemented by all (linear and nonlinear) 2D mappings.
015 * 
016 * @author WB
017 *
018 */
019public interface Mapping2D extends Cloneable {
020        
021        /**
022         * Applies this mapping to a single 2D point.
023         * 
024         * @param pnt the original point
025         * @return the transformed point
026         */
027        public Pnt2d applyTo (Pnt2d pnt);
028
029        /**
030         * Applies this mapping to an array of 2D points and returns a new array of points.
031         *
032         * @param pnts the original points
033         * @return the transformed points
034         */
035        public default Pnt2d[] applyTo(Pnt2d[] pnts) {
036                Pnt2d[] outPnts = new Pnt2d[pnts.length];
037                for (int i = 0; i < pnts.length; i++) {
038                        outPnts[i] = applyTo(pnts[i]);
039                }
040                return outPnts;
041        }
042
043}