Module imagingbook.common
Package imagingbook.common.geometry.basic

Class PntUtils

java.lang.Object
imagingbook.common.geometry.basic.PntUtils
public abstract class PntUtils extends Object
Defines static methods for manipulating 2D points.

  • Method Summary

    Modifier and Type
    Method
    Description
    static Pnt2d
    centroid(Pnt2d[] pts)
    Calculates and returns the centroid of the specified point set.
    static Pnt2d
    centroid(Iterable<Pnt2d> pts)
    Calculates and returns the centroid of the specified point set.
    static int
    count(Iterable<Pnt2d> pts)
    Simply counts the points in the specified point set.
    static Pnt2d[]
    fromDoubleArray(double[][] da)
    Converts a given 2D double array double[n][2] to a point array Pnt2d[n], taking x-coordinates from column 0 and y-coordinates from column 1.
    static Pnt2d[]
    makeDoublePoints(double... xy)
    Creates and returns an array of Pnt2d.PntDouble points from the given sequence of double coordinate values, interpreted as x/y pairs.
    static Pnt2d[]
    makeIntPoints(int... xy)
    Creates and returns an array of Pnt2d.PntInt points from the given sequence of int coordinate values, interpreted as x/y pairs.
    static double[][]
    toDoubleArray(Pnt2d[] pts)
    Converts a given point array Pnt2d[n] to a 2D double array double[n][2], with x-coordinates in column 0 and y-coordinates in column 1.

    Methods inherited from class java.lang.Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

  • Method Details

    • count

      public static int count(Iterable<Pnt2d> pts)
      Simply counts the points in the specified point set.
      Parameters:
      pts - an Iterable of Pnt2d instances
      Returns:
      the number of points

    • centroid

      public static Pnt2d centroid(Iterable<Pnt2d> pts)
      Calculates and returns the centroid of the specified point set.
      Parameters:
      pts - an Iterable of Pnt2d instances
      Returns:
      the centroid (as a Pnt2d instance)

    • centroid

      public static Pnt2d centroid(Pnt2d[] pts)
      Calculates and returns the centroid of the specified point set.
      Parameters:
      pts - an array of Pnt2d instances
      Returns:
      the centroid (as a Pnt2d instance)

    • toDoubleArray

      public static double[][] toDoubleArray(Pnt2d[] pts)
      Converts a given point array Pnt2d[n] to a 2D double array double[n][2], with x-coordinates in column 0 and y-coordinates in column 1.
      Parameters:
      pts - the point array
      Returns:
      a 2D double array

    • fromDoubleArray

      public static Pnt2d[] fromDoubleArray(double[][] da)
      Converts a given 2D double array double[n][2] to a point array Pnt2d[n], taking x-coordinates from column 0 and y-coordinates from column 1.
      Parameters:
      da - a 2D double array
      Returns:
      a point array

    • makeIntPoints

      public static Pnt2d[] makeIntPoints(int... xy)
      Creates and returns an array of Pnt2d.PntInt points from the given sequence of int coordinate values, interpreted as x/y pairs. Throws an exception if the length of the coordinate sequence is not even. Usage example: 
       Pnt2d[] pts = PntUtils.makeIntPoints(1, 2, 3, 4, 5, 6);
    // gives [PntInt(1, 2), PntInt(3, 4), PntInt(5, 6)]
      Parameters:
      xy - an even-numbered sequence of point coordinates
      Returns:
      an array of Pnt2d.PntInt points

    • makeDoublePoints

      public static Pnt2d[] makeDoublePoints(double... xy)
      Creates and returns an array of Pnt2d.PntDouble points from the given sequence of double coordinate values, interpreted as x/y pairs. Throws an exception if the length of the coordinate sequence is not even. Usage example: 
       Pnt2d[] pts = PntUtils.makeDoublePoints(1, 2, 3, 4, 5, 6);
 // gives [PntDouble(1.0, 2.0), PntDouble(3.0, 4.0), PntDouble(5.0, 6.0)]
      Parameters:
      xy - an even-numbered sequence of point coordinates
      Returns:
      an array of Pnt2d.PntDouble points