org.apache.commons.geometry.euclidean.twod.shape

Class Parallelogram

java.lang.Object

org.apache.commons.geometry.core.partitioning.AbstractConvexHyperplaneBoundedRegion<Vector2D,LineConvexSubset>

org.apache.commons.geometry.euclidean.twod.ConvexArea

org.apache.commons.geometry.euclidean.twod.shape.Parallelogram

All Implemented Interfaces:

BoundarySource<LineConvexSubset>, HyperplaneBoundedRegion<Vector2D>, Splittable<Vector2D,HyperplaneBoundedRegion<Vector2D>>, Region<Vector2D>, Sized, BoundarySource2D, Linecastable2D

public final class Parallelogram
extends ConvexArea

Class representing parallelograms, i.e. quadrilaterals with two pairs of parallel sides.

See Also:

Parallelogram

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Parallelogram.Builder Class designed to aid construction of Parallelogram instances.

Nested classes/interfaces inherited from class org.apache.commons.geometry.core.partitioning.AbstractConvexHyperplaneBoundedRegion

AbstractConvexHyperplaneBoundedRegion.ConvexRegionBoundaryBuilder<P extends Point<P>,S extends HyperplaneConvexSubset<P>>

Method Summary

Modifier and Type	Method and Description
static Parallelogram	axisAligned(Vector2D a, Vector2D b, Precision.DoubleEquivalence precision) Return a new instance representing an axis-aligned rectangle.
static Parallelogram.Builder	builder(Precision.DoubleEquivalence precision) Return a new Parallelogram.Builder instance to use for constructing parallelograms.
static Parallelogram	fromTransformedUnitSquare(Transform<Vector2D> transform, Precision.DoubleEquivalence precision) Create a new instance by transforming a unit square centered at the origin.
static Parallelogram	unitSquare(Precision.DoubleEquivalence precision) Return a new instance representing a unit square centered on the origin.

Methods inherited from class org.apache.commons.geometry.euclidean.twod.ConvexArea

boundaryStream, convexPolygonFromPath, convexPolygonFromVertices, fromBounds, fromBounds, full, getBoundaryPaths, getCentroid, getSize, getVertices, split, toTree, transform, trim

Methods inherited from class org.apache.commons.geometry.core.partitioning.AbstractConvexHyperplaneBoundedRegion

classify, getBoundaries, getBoundarySize, isEmpty, isFull, project, splitInternal, swapsInsideOutside, toString, transformInternal

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.apache.commons.geometry.euclidean.twod.BoundarySource2D

getBounds, linecast, linecastFirst, of, of, toList

Methods inherited from interface org.apache.commons.geometry.euclidean.twod.Linecastable2D

linecast, linecastFirst

Methods inherited from interface org.apache.commons.geometry.core.Region

contains

Methods inherited from interface org.apache.commons.geometry.core.Sized

isFinite, isInfinite

Method Detail

unitSquare

public static Parallelogram unitSquare(Precision.DoubleEquivalence precision)

Return a new instance representing a unit square centered on the origin. The vertices of this square are:

 [
      (-0.5 -0.5),
      (0.5, -0.5),
      (0.5, 0.5),
      (-0.5, 0.5)
 ]
 

Parameters:

precision - precision context used to construct boundaries

Returns:

a new instance representing a unit square centered on the origin

axisAligned

public static Parallelogram axisAligned(Vector2D a,
                                        Vector2D b,
                                        Precision.DoubleEquivalence precision)

Return a new instance representing an axis-aligned rectangle. The points a and b are taken to represent opposite corner points in the rectangle and may be specified in any order.

Parameters:

a - first corner point in the rectangle (opposite of b)

b - second corner point in the rectangle (opposite of a)

precision - precision context used to construct boundaries

Returns:

a new instance representing an axis-aligned rectangle

Throws:

IllegalArgumentException - if the length of any side of the parallelogram is zero, as determined by the given precision context

fromTransformedUnitSquare

public static Parallelogram fromTransformedUnitSquare(Transform<Vector2D> transform,
                                                      Precision.DoubleEquivalence precision)

Create a new instance by transforming a unit square centered at the origin. The vertices of this input square are:

 [
      (-0.5 -0.5),
      (0.5, -0.5),
      (0.5, 0.5),
      (-0.5, 0.5)
 ]
 

Parameters:

transform - the transform to apply to the unit square

precision - precision context used to construct boundaries

Returns:

a new instance constructed by transforming the unit square

Throws:

IllegalArgumentException - if the length of any side of the parallelogram is zero, as determined by the given precision context

builder

public static Parallelogram.Builder builder(Precision.DoubleEquivalence precision)

Return a new Parallelogram.Builder instance to use for constructing parallelograms.

Parameters:

precision - precision context used to create boundaries

Returns:

a new Parallelogram.Builder instance