Class PAreasL
Functions over areas.
These functions operate using the concepts of minimum-x, maximum-x, minimum-y, and maximum-y edges. It is up to individual applications to assign meaning to these edges such as "left" for minimum-x and "top" for minimum-y.
-
Method Summary
Modifier and TypeMethodDescriptionstatic <S> PAreaL<S>
alignCenter
(PAreaL<S> outer, PAreaL<S> inner) Align the areainner
such that the center of the area is equal to the center ofouter
.static <S> PAreaL<S>
alignHorizontallyCenter
(PAreaL<S> outer, PAreaL<S> inner) Deprecated.static <S> PAreaL<S>
alignHorizontallyMaxX
(PAreaL<S> outer, PAreaL<S> inner) Deprecated.static <S> PAreaL<S>
alignHorizontallyMaxXOffset
(PAreaL<S> outer, PAreaL<S> inner, long offset) Deprecated.static <S> PAreaL<S>
alignHorizontallyMinX
(PAreaL<S> outer, PAreaL<S> inner) Deprecated.static <S> PAreaL<S>
alignHorizontallyMinXOffset
(PAreaL<S> outer, PAreaL<S> inner, long offset) Deprecated.static <S> PAreaL<S>
alignMaxYMaxX
(PAreaL<S> outer, PAreaL<S> inner) Equivalent to callingalignMaxYMaxXOffset(PAreaL, PAreaL, long, long)
with zero offsets.static <S> PAreaL<S>
alignMaxYMaxXOffset
(PAreaL<S> outer, PAreaL<S> inner, long offset_x, long offset_y) Align the areainner
such that the maximum-y edge is at leastoffset_y
from the inside maximum-y edge ofouter
and the maximum-x edge is at leastoffset_x
from the inside maximum-x edge ofouter
.static <S> PAreaL<S>
alignMaxYMinX
(PAreaL<S> outer, PAreaL<S> inner) Equivalent to callingalignMaxYMinXOffset(PAreaL, PAreaL, long, long)
with zero offsets.static <S> PAreaL<S>
alignMaxYMinXOffset
(PAreaL<S> outer, PAreaL<S> inner, long offset_x, long offset_y) Align the areainner
such that the maximum-y edge is at leastoffset_y
from the inside maximum-y edge ofouter
and the minimum-x edge is at leastoffset_x
from the inside minimum-x edge ofouter
.static <S> PAreaL<S>
alignMinYMaxX
(PAreaL<S> outer, PAreaL<S> inner) Equivalent to callingalignMinYMaxXOffset(PAreaL, PAreaL, long, long)
with zero offsets.static <S> PAreaL<S>
alignMinYMaxXOffset
(PAreaL<S> outer, PAreaL<S> inner, long offset_x, long offset_y) Align the areainner
such that the minimum-y edge is at leastoffset_y
from the inside minimum-y edge ofouter
and the maximum-x edge is at leastoffset_x
from the inside maximum-x edge ofouter
.static <S> PAreaL<S>
alignMinYMinX
(PAreaL<S> outer, PAreaL<S> inner) Equivalent to callingalignMinYMinXOffset(PAreaL, PAreaL, long, long)
with zero offsets.static <S> PAreaL<S>
alignMinYMinXOffset
(PAreaL<S> outer, PAreaL<S> inner, long offset_x, long offset_y) Align the areainner
such that the minimum-y edge is at leastoffset_y
from the inside minimum-y edge ofouter
and the minimum-x edge is at leastoffset_x
from the inside minimum-x edge ofouter
.static <S> PAreaL<S>
alignOnXCenter
(PAreaL<S> outer, PAreaL<S> inner) Align the areainner
along the X axis in the center ofouter
.static <S> PAreaL<S>
alignOnXMaxX
(PAreaL<S> outer, PAreaL<S> inner) Equivalent to callingalignOnXMaxXOffset(PAreaL, PAreaL, long)
with a zero offset.static <S> PAreaL<S>
alignOnXMaxXOffset
(PAreaL<S> outer, PAreaL<S> inner, long offset) Align the areainner
along the X axis against the inside maximum-x edge ofouter
.static <S> PAreaL<S>
alignOnXMinX
(PAreaL<S> outer, PAreaL<S> inner) Equivalent to callingalignOnXMinXOffset(PAreaL, PAreaL, long)
with a zero offset.static <S> PAreaL<S>
alignOnXMinXOffset
(PAreaL<S> outer, PAreaL<S> inner, long offset) Align the areainner
along the X axis against the inside minimum-x edge ofouter
.static <S> PAreaL<S>
alignOnYCenter
(PAreaL<S> outer, PAreaL<S> inner) Align the areainner
along the Y axis in the center ofouter
.static <S> PAreaL<S>
alignOnYMaxY
(PAreaL<S> outer, PAreaL<S> inner) Equivalent to callingalignOnYMaxYOffset(PAreaL, PAreaL, long)
with a zero offset.static <S> PAreaL<S>
alignOnYMaxYOffset
(PAreaL<S> outer, PAreaL<S> inner, long offset) Align the areainner
along the Y axis against the inside maximum-y edge ofouter
.static <S> PAreaL<S>
alignOnYMinY
(PAreaL<S> outer, PAreaL<S> inner) Equivalent to callingalignOnYMinYOffset(PAreaL, PAreaL, long)
with a zero offset.static <S> PAreaL<S>
alignOnYMinYOffset
(PAreaL<S> outer, PAreaL<S> inner, long offset) Align the areainner
along the Y axis against the inside minimum-y edge ofouter
.static <S> PAreaL<S>
alignVerticallyCenter
(PAreaL<S> outer, PAreaL<S> inner) Deprecated.static <S> PAreaL<S>
alignVerticallyMaxY
(PAreaL<S> outer, PAreaL<S> inner) Deprecated.static <S> PAreaL<S>
alignVerticallyMaxYOffset
(PAreaL<S> outer, PAreaL<S> inner, long offset) Deprecated.static <S> PAreaL<S>
alignVerticallyMinY
(PAreaL<S> outer, PAreaL<S> inner) Deprecated.static <S> PAreaL<S>
alignVerticallyMinYOffset
(PAreaL<S> outer, PAreaL<S> inner, long offset) Deprecated.static <S,
T> PAreaL<T> Brand a given area as belonging to a different coordinate space.static <S> PAreaL<S>
containing
(PAreaL<S> a, PAreaL<S> b) Construct a area that will contain botha
andb
.static <S> boolean
Determine whether or not one area contains another.static <S> boolean
containsPoint
(PAreaL<S> a, long x, long y) Determine whether or not a area contains a given point.static <S> boolean
couldFitInside
(PAreaL<S> a, PAreaL<S> b) Determine whether or not one area could fit inside another.static <S> PAreaL<S>
create
(long x, long y, long size_x, long size_y) Create an area of sizesize_x
on the X axis and sizesize_y
on the Y axis, placing the minimum corner at(x, y)
.static <S> PAreaL<S>
fitBetweenHorizontal
(PAreaL<S> fit, PAreaL<S> a, PAreaL<S> b) Deprecated.static <S> PAreaL<S>
fitBetweenOnX
(PAreaL<S> fit, PAreaL<S> a, PAreaL<S> b) Attempt to fitfit
betweena
andb
, horizontally.static <S> PAreaL<S>
fitBetweenOnY
(PAreaL<S> fit, PAreaL<S> a, PAreaL<S> b) Attempt to fitfit
betweena
andb
, vertically.static <S> PAreaL<S>
fitBetweenVertical
(PAreaL<S> fit, PAreaL<S> a, PAreaL<S> b) Deprecated.static <S> PAreaL<S>
hollowOut
(PAreaL<S> outer, long min_x_offset, long max_x_offset, long min_y_offset, long max_y_offset) Construct a new area that fits insideouter
based on the given offsets from each edge.static <S> PAreaL<S>
hollowOutEvenly
(PAreaL<S> outer, long offset) Equivalent to callinghollowOut(PAreaL, long, long, long, long)
withoffset
for all offset parameters.static <S> PAreaL<S>
moveAbsolute
(PAreaL<S> area, long x, long y) Move the given area to(x, y)
.static <S> PAreaL<S>
moveRelative
(PAreaL<S> area, long x, long y) Move the given area by(x, y)
.static <S> PAreaL<S>
moveRelativeClamped
(PAreaL<S> container, PAreaL<S> area, long x, long y) Move the given area by(x, y)
, without allowingarea
to leavecontainer
.static <S> PAreaL<S>
moveRelativeClampedX
(PAreaL<S> container, PAreaL<S> area, long x) Move the given area byx
, without allowingarea
to leavecontainer
.static <S> PAreaL<S>
moveRelativeClampedY
(PAreaL<S> container, PAreaL<S> area, long y) Move the given area byy
, without allowingarea
to leavecontainer
.static <S> PAreaL<S>
moveToOrigin
(PAreaL<S> area) Move the given area to(0, 0)
.static <S> boolean
Determine whether or not two areas overlap.static <S> PAreaL<S>
scaleFromCenter
(PAreaL<S> area, long x_diff, long y_diff) Scalearea
by addingx_diff
to the sizeX, andy_diff
to the sizeY.static <S> PAreaL<S>
scaleFromMaxYMaxX
(PAreaL<S> area, long x_diff, long y_diff) Scalearea
by addingx_diff
to the sizeX, andy_diff
to the sizeY.static <S> PAreaL<S>
scaleFromMaxYMinX
(PAreaL<S> area, long x_diff, long y_diff) Scalearea
by addingx_diff
to the sizeX, andy_diff
to the sizeY.static <S> PAreaL<S>
scaleFromMinYMaxX
(PAreaL<S> area, long x_diff, long y_diff) Scalearea
by addingx_diff
to the sizeX, andy_diff
to the sizeY.static <S> PAreaL<S>
scaleFromMinYMinX
(PAreaL<S> area, long x_diff, long y_diff) Scalearea
by addingx_diff
to the sizeX, andy_diff
to the sizeY.static <S> PAreaL<S>
setSizeFromCenter
(PAreaL<S> area, long sizeX, long sizeY) Set the sizeX and sizeY ofarea
tosizeX
andsizeY
, respectively.static <S> PAreaL<S>
setSizeFromMaxYMaxX
(PAreaL<S> area, long sizeX, long sizeY) Set the sizeX and sizeY ofarea
tosizeX
andsizeY
, respectively.static <S> PAreaL<S>
setSizeFromMaxYMinX
(PAreaL<S> area, long sizeX, long sizeY) Set the sizeX and sizeY ofarea
tosizeX
andsizeY
, respectively.static <S> PAreaL<S>
setSizeFromMinYMaxX
(PAreaL<S> area, long sizeX, long sizeY) Set the sizeX and sizeY ofarea
tosizeX
andsizeY
, respectively.static <S> PAreaL<S>
setSizeFromMinYMinX
(PAreaL<S> area, long sizeX, long sizeY) Set the sizeX and sizeY ofarea
tosizeX
andsizeY
, respectively.static <S> String
static <S> String
showToBuilder
(PAreaL<S> area, StringBuilder sb) static <S> PAreaSizeL<S>
static <S> PAreaXSplitL<S,
PAreaL<S>> splitAlongParallelToX
(PAreaL<S> area, long y) Splitarea
along a line parallel to the X axis placed aty
units from its own minimum-y edge.static <S> PAreaYSplitL<S,
PAreaL<S>> splitAlongParallelToY
(PAreaL<S> area, long x) Splitarea
along a line parallel to the Y axis placed atx
units from its own minimum-x edge.static <S> PAreaXYSplitL<S,
PAreaL<S>> splitAlongXY
(PAreaL<S> area, long x, long y) Splitarea
along a two axis-aligned perpendicular lines that intercept at(x, y)
.
-
Method Details
-
create
Create an area of sizesize_x
on the X axis and sizesize_y
on the Y axis, placing the minimum corner at(x, y)
.- Type Parameters:
S
- The coordinate space of the areas- Parameters:
x
- The X value of the minimum cornery
- The Y value of the minimum cornersize_x
- The size of the area on the X axissize_y
- The size of the area on the Y axis- Returns:
- An area
-
contains
Determine whether or not one area contains another.
Containing is reflexive:
contains(a, a) == true
.Containing is transitive:
contains(a, b) → contains(b, c) → contains(a, c)
.Containing is not necessarily symmetric.
- Type Parameters:
S
- The coordinate space of the areas- Parameters:
a
- Area Ab
- Area B- Returns:
true
iffa
containsb
-
moveRelative
Move the given area by(x, y)
.- Type Parameters:
S
- The coordinate space of the area- Parameters:
area
- The areax
- The amount to move on the X axisy
- The amount to move on the Y axis- Returns:
- A moved area
-
moveRelativeClampedX
Move the given area byx
, without allowingarea
to leavecontainer
.- Type Parameters:
S
- The coordinate space of the area- Parameters:
container
- The container areaarea
- The areax
- The amount to move on the X axis- Returns:
- A moved area
- Since:
- 3.0.0
-
moveRelativeClampedY
Move the given area byy
, without allowingarea
to leavecontainer
.- Type Parameters:
S
- The coordinate space of the area- Parameters:
container
- The container areaarea
- The areay
- The amount to move on the Y axis- Returns:
- A moved area
- Since:
- 3.0.0
-
moveRelativeClamped
public static <S> PAreaL<S> moveRelativeClamped(PAreaL<S> container, PAreaL<S> area, long x, long y) Move the given area by(x, y)
, without allowingarea
to leavecontainer
.- Type Parameters:
S
- The coordinate space of the area- Parameters:
container
- The container areaarea
- The areax
- The amount to move on the X axisy
- The amount to move on the Y axis- Returns:
- A moved area
- Since:
- 3.0.0
-
moveAbsolute
Move the given area to(x, y)
.- Type Parameters:
S
- The coordinate space of the area- Parameters:
area
- The areax
- The position to which to move on the X axisy
- The position to which to move on the Y axis- Returns:
- A moved area
-
moveToOrigin
Move the given area to(0, 0)
.- Type Parameters:
S
- The coordinate space of the area- Parameters:
area
- The area- Returns:
- A moved area
-
cast
Brand a given area as belonging to a different coordinate space. Mixing up coordinate spaces is a common source of difficult-to-locate bugs. Use at your own risk.- Type Parameters:
S
- The starting coordinate spaceT
- The resulting coordinate space- Parameters:
area
- An area- Returns:
area
-
alignHorizontallyCenter
Deprecated.Align the areainner
horizontally in the center ofouter
.- Type Parameters:
S
- The coordinate space of the areas- Parameters:
outer
- The outer areainner
- The inner area- Returns:
- An aligned area
-
alignHorizontallyMinX
Deprecated.Equivalent to callingalignHorizontallyMinXOffset(PAreaL, PAreaL, long)
with a zero offset.- Type Parameters:
S
- The coordinate space of the areas- Parameters:
outer
- The outer areainner
- The inner area- Returns:
- An aligned area
-
alignHorizontallyMinXOffset
@Deprecated public static <S> PAreaL<S> alignHorizontallyMinXOffset(PAreaL<S> outer, PAreaL<S> inner, long offset) Deprecated.Align the areainner
horizontally against the inside minimum-x edge ofouter
. The area will be at leastoffset
units from the minimum-x edge.- Type Parameters:
S
- The coordinate space of the areas- Parameters:
outer
- The outer areainner
- The inner areaoffset
- The offset from the edge- Returns:
- An aligned area
-
alignHorizontallyMaxX
Deprecated.Equivalent to callingalignHorizontallyMaxXOffset(PAreaL, PAreaL, long)
with a zero offset.- Type Parameters:
S
- The coordinate space of the areas- Parameters:
outer
- The outer areainner
- The inner area- Returns:
- An aligned area
-
alignHorizontallyMaxXOffset
@Deprecated public static <S> PAreaL<S> alignHorizontallyMaxXOffset(PAreaL<S> outer, PAreaL<S> inner, long offset) Deprecated.Align the areainner
horizontally against the inside maximum-x edge ofouter
. The area will be at leastoffset
units from the maximum-x edge.- Type Parameters:
S
- The coordinate space of the areas- Parameters:
outer
- The outer areainner
- The inner areaoffset
- The offset from the edge- Returns:
- An aligned area
-
alignVerticallyMinY
Deprecated.Equivalent to callingalignVerticallyMinYOffset(PAreaL, PAreaL, long)
with a zero offset.- Type Parameters:
S
- The coordinate space of the areas- Parameters:
outer
- The outer areainner
- The inner area- Returns:
- An aligned area
-
alignVerticallyMinYOffset
@Deprecated public static <S> PAreaL<S> alignVerticallyMinYOffset(PAreaL<S> outer, PAreaL<S> inner, long offset) Deprecated.Align the areainner
vertically against the inside minimum-y edge ofouter
. The area will be at leastoffset
units from the minimum-y edge.- Type Parameters:
S
- The coordinate space of the areas- Parameters:
outer
- The outer areainner
- The inner areaoffset
- The offset from the edge- Returns:
- An aligned area
-
alignVerticallyMaxY
Deprecated.Equivalent to callingalignVerticallyMaxYOffset(PAreaL, PAreaL, long)
with a zero offset.- Type Parameters:
S
- The coordinate space of the areas- Parameters:
outer
- The outer areainner
- The inner area- Returns:
- An aligned area
-
alignVerticallyMaxYOffset
@Deprecated public static <S> PAreaL<S> alignVerticallyMaxYOffset(PAreaL<S> outer, PAreaL<S> inner, long offset) Deprecated.Align the areainner
vertically against the inside maximum-y edge ofouter
. The area will be at leastoffset
units from the maximum-y edge.- Type Parameters:
S
- The coordinate space of the areas- Parameters:
outer
- The outer areainner
- The inner areaoffset
- The offset from the edge- Returns:
- An aligned area
-
alignVerticallyCenter
Deprecated.Align the areainner
vertically in the center ofouter
.- Type Parameters:
S
- The coordinate space of the areas- Parameters:
outer
- The outer areainner
- The inner area- Returns:
- An aligned area
-
alignOnXCenter
Align the areainner
along the X axis in the center ofouter
.- Type Parameters:
S
- The coordinate space of the areas- Parameters:
outer
- The outer areainner
- The inner area- Returns:
- An aligned area
- Since:
- 1.1.0
-
alignOnXMinX
Equivalent to callingalignOnXMinXOffset(PAreaL, PAreaL, long)
with a zero offset.- Type Parameters:
S
- The coordinate space of the areas- Parameters:
outer
- The outer areainner
- The inner area- Returns:
- An aligned area
- Since:
- 1.1.0
-
alignOnXMinXOffset
Align the areainner
along the X axis against the inside minimum-x edge ofouter
. The area will be at leastoffset
units from the minimum-x edge.- Type Parameters:
S
- The coordinate space of the areas- Parameters:
outer
- The outer areainner
- The inner areaoffset
- The offset from the edge- Returns:
- An aligned area
- Since:
- 1.1.0
-
alignOnXMaxX
Equivalent to callingalignOnXMaxXOffset(PAreaL, PAreaL, long)
with a zero offset.- Type Parameters:
S
- The coordinate space of the areas- Parameters:
outer
- The outer areainner
- The inner area- Returns:
- An aligned area
- Since:
- 1.1.0
-
alignOnXMaxXOffset
Align the areainner
along the X axis against the inside maximum-x edge ofouter
. The area will be at leastoffset
units from the maximum-x edge.- Type Parameters:
S
- The coordinate space of the areas- Parameters:
outer
- The outer areainner
- The inner areaoffset
- The offset from the edge- Returns:
- An aligned area
- Since:
- 1.1.0
-
alignOnYMinY
Equivalent to callingalignOnYMinYOffset(PAreaL, PAreaL, long)
with a zero offset.- Type Parameters:
S
- The coordinate space of the areas- Parameters:
outer
- The outer areainner
- The inner area- Returns:
- An aligned area
- Since:
- 1.1.0
-
alignOnYMinYOffset
Align the areainner
along the Y axis against the inside minimum-y edge ofouter
. The area will be at leastoffset
units from the minimum-y edge.- Type Parameters:
S
- The coordinate space of the areas- Parameters:
outer
- The outer areainner
- The inner areaoffset
- The offset from the edge- Returns:
- An aligned area
- Since:
- 1.1.0
-
alignOnYMaxY
Equivalent to callingalignOnYMaxYOffset(PAreaL, PAreaL, long)
with a zero offset.- Type Parameters:
S
- The coordinate space of the areas- Parameters:
outer
- The outer areainner
- The inner area- Returns:
- An aligned area
- Since:
- 1.1.0
-
alignOnYMaxYOffset
Align the areainner
along the Y axis against the inside maximum-y edge ofouter
. The area will be at leastoffset
units from the maximum-y edge.- Type Parameters:
S
- The coordinate space of the areas- Parameters:
outer
- The outer areainner
- The inner areaoffset
- The offset from the edge- Returns:
- An aligned area
- Since:
- 1.1.0
-
alignOnYCenter
Align the areainner
along the Y axis in the center ofouter
.- Type Parameters:
S
- The coordinate space of the areas- Parameters:
outer
- The outer areainner
- The inner area- Returns:
- An aligned area
- Since:
- 1.1.0
-
alignMinYMinX
Equivalent to callingalignMinYMinXOffset(PAreaL, PAreaL, long, long)
with zero offsets.- Type Parameters:
S
- The coordinate space of the areas- Parameters:
outer
- The outer areainner
- The inner area- Returns:
- An aligned area
-
alignMinYMinXOffset
public static <S> PAreaL<S> alignMinYMinXOffset(PAreaL<S> outer, PAreaL<S> inner, long offset_x, long offset_y) Align the areainner
such that the minimum-y edge is at leastoffset_y
from the inside minimum-y edge ofouter
and the minimum-x edge is at leastoffset_x
from the inside minimum-x edge ofouter
.- Type Parameters:
S
- The coordinate space of the areas- Parameters:
outer
- The outer areainner
- The inner areaoffset_x
- The offset from the minimum-x edgeoffset_y
- The offset from the minimum-y edge- Returns:
- An aligned area
-
alignMinYMaxX
Equivalent to callingalignMinYMaxXOffset(PAreaL, PAreaL, long, long)
with zero offsets.- Type Parameters:
S
- The coordinate space of the areas- Parameters:
outer
- The outer areainner
- The inner area- Returns:
- An aligned area
-
alignMinYMaxXOffset
public static <S> PAreaL<S> alignMinYMaxXOffset(PAreaL<S> outer, PAreaL<S> inner, long offset_x, long offset_y) Align the areainner
such that the minimum-y edge is at leastoffset_y
from the inside minimum-y edge ofouter
and the maximum-x edge is at leastoffset_x
from the inside maximum-x edge ofouter
.- Type Parameters:
S
- The coordinate space of the areas- Parameters:
outer
- The outer areainner
- The inner areaoffset_x
- The offset from the maximum-x edgeoffset_y
- The offset from the minimum-y edge- Returns:
- An aligned area
-
alignMaxYMinX
Equivalent to callingalignMaxYMinXOffset(PAreaL, PAreaL, long, long)
with zero offsets.- Type Parameters:
S
- The coordinate space of the areas- Parameters:
outer
- The outer areainner
- The inner area- Returns:
- An aligned area
-
alignMaxYMinXOffset
public static <S> PAreaL<S> alignMaxYMinXOffset(PAreaL<S> outer, PAreaL<S> inner, long offset_x, long offset_y) Align the areainner
such that the maximum-y edge is at leastoffset_y
from the inside maximum-y edge ofouter
and the minimum-x edge is at leastoffset_x
from the inside minimum-x edge ofouter
.- Type Parameters:
S
- The coordinate space of the areas- Parameters:
outer
- The outer areainner
- The inner areaoffset_x
- The offset from the minimum-x edgeoffset_y
- The offset from the maximum-y edge- Returns:
- An aligned area
-
alignMaxYMaxX
Equivalent to callingalignMaxYMaxXOffset(PAreaL, PAreaL, long, long)
with zero offsets.- Type Parameters:
S
- The coordinate space of the areas- Parameters:
outer
- The outer areainner
- The inner area- Returns:
- An aligned area
-
alignMaxYMaxXOffset
public static <S> PAreaL<S> alignMaxYMaxXOffset(PAreaL<S> outer, PAreaL<S> inner, long offset_x, long offset_y) Align the areainner
such that the maximum-y edge is at leastoffset_y
from the inside maximum-y edge ofouter
and the maximum-x edge is at leastoffset_x
from the inside maximum-x edge ofouter
.- Type Parameters:
S
- The coordinate space of the areas- Parameters:
outer
- The outer areainner
- The inner areaoffset_x
- The offset from the maximum-x edgeoffset_y
- The offset from the maximum-y edge- Returns:
- An aligned area
-
alignCenter
Align the areainner
such that the center of the area is equal to the center ofouter
.- Type Parameters:
S
- The coordinate space of the areas- Parameters:
outer
- The outer areainner
- The inner area- Returns:
- An aligned area
-
hollowOut
public static <S> PAreaL<S> hollowOut(PAreaL<S> outer, long min_x_offset, long max_x_offset, long min_y_offset, long max_y_offset) Construct a new area that fits insideouter
based on the given offsets from each edge.- Type Parameters:
S
- The coordinate space of the areas- Parameters:
outer
- The containing areamin_x_offset
- The offset from the minimum-x edge (must be non-negative)max_x_offset
- The offset from the maximum-x edge (must be non-negative)min_y_offset
- The offset from the minimum-y edge (must be non-negative)max_y_offset
- The offset from the maximum-y edge (must be non-negative)- Returns:
- A new area
-
hollowOutEvenly
Equivalent to callinghollowOut(PAreaL, long, long, long, long)
withoffset
for all offset parameters.- Type Parameters:
S
- The coordinate space of the areas- Parameters:
outer
- The containing areaoffset
- The offset from each edge (must be non-negative)- Returns:
- A new area
-
setSizeFromCenter
Set the sizeX and sizeY of
area
tosizeX
andsizeY
, respectively.The area is resized from its own center.
- Type Parameters:
S
- The coordinate space of the area- Parameters:
area
- The areasizeX
- The new sizeX (must be non-negative)sizeY
- The new sizeY (must be non-negative)- Returns:
- A resized area
-
setSizeFromMinYMinX
Set the sizeX and sizeY of
area
tosizeX
andsizeY
, respectively.The area is resized by moving its minimum-y-minimum-x corner.
- Type Parameters:
S
- The coordinate space of the area- Parameters:
area
- The areasizeX
- The new sizeX (must be non-negative)sizeY
- The new sizeY (must be non-negative)- Returns:
- A resized area
-
setSizeFromMinYMaxX
Set the sizeX and sizeY of
area
tosizeX
andsizeY
, respectively.The area is resized by moving its minimum-y-maximum-x corner.
- Type Parameters:
S
- The coordinate space of the area- Parameters:
area
- The areasizeX
- The new sizeX (must be non-negative)sizeY
- The new sizeY (must be non-negative)- Returns:
- A resized area
-
setSizeFromMaxYMaxX
Set the sizeX and sizeY of
area
tosizeX
andsizeY
, respectively.The area is resized by moving its maximum-y-maximum-x corner.
- Type Parameters:
S
- The coordinate space of the area- Parameters:
area
- The areasizeX
- The new sizeX (must be non-negative)sizeY
- The new sizeY (must be non-negative)- Returns:
- A resized area
-
setSizeFromMaxYMinX
Set the sizeX and sizeY of
area
tosizeX
andsizeY
, respectively.The area is resized by moving its maximum-y-minimum-x corner.
- Type Parameters:
S
- The coordinate space of the area- Parameters:
area
- The areasizeX
- The new sizeX (must be non-negative)sizeY
- The new sizeY (must be non-negative)- Returns:
- A resized area
-
scaleFromMinYMinX
Scale
area
by addingx_diff
to the sizeX, andy_diff
to the sizeY. The size of the resulting area is clamped so that its sizeX and sizeY are always non-negative.The area is resized by moving its minimum-y-minimum-x corner.
- Type Parameters:
S
- The coordinate space of the area- Parameters:
area
- The areax_diff
- The X differencey_diff
- The Y difference- Returns:
- A resized area
-
scaleFromMinYMaxX
Scale
area
by addingx_diff
to the sizeX, andy_diff
to the sizeY. The size of the resulting area is clamped so that its sizeX and sizeY are always non-negative.The area is resized by moving its minimum-y-maximum-x corner.
- Type Parameters:
S
- The coordinate space of the area- Parameters:
area
- The areax_diff
- The X differencey_diff
- The Y difference- Returns:
- A resized area
-
scaleFromMaxYMinX
Scale
area
by addingx_diff
to the sizeX, andy_diff
to the sizeY. The size of the resulting area is clamped so that its sizeX and sizeY are always non-negative.The area is resized by moving its maximum-y-minimum-x corner.
- Type Parameters:
S
- The coordinate space of the area- Parameters:
area
- The areax_diff
- The X differencey_diff
- The Y difference- Returns:
- A resized area
-
scaleFromMaxYMaxX
Scale
area
by addingx_diff
to the sizeX, andy_diff
to the sizeY. The size of the resulting area is clamped so that its sizeX and sizeY are always non-negative.The area is resized by moving its maximum-y-maximum-x corner.
- Type Parameters:
S
- The coordinate space of the area- Parameters:
area
- The areax_diff
- The X differencey_diff
- The Y difference- Returns:
- A resized area
-
scaleFromCenter
Scale
area
by addingx_diff
to the sizeX, andy_diff
to the sizeY. The size of the resulting area is clamped so that its sizeX and sizeY are always non-negative.The area is resized from its own center.
- Type Parameters:
S
- The coordinate space of the area- Parameters:
area
- The areax_diff
- The X differencey_diff
- The Y difference- Returns:
- A resized area
-
overlaps
Determine whether or not two areas overlap.
Overlapping is reflexive:
overlaps(a, a) == true
.Overlapping is symmetric:
overlaps(a, b) == overlaps(b, a)
.Overlapping is not necessarily transitive.
- Type Parameters:
S
- The coordinate space of the areas- Parameters:
a
- An areab
- An area- Returns:
true
iffa
overlapsb
-
couldFitInside
Determine whether or not one area could fit inside another.
Fitting is reflexive:
couldFitInside(a, a) == true
.Fitting is transitive:
couldFitInside(a, b) → couldFitInside(b, c) → couldFitInside(a, c)
.Fitting is not necessarily symmetric.
- Type Parameters:
S
- The coordinate space of the areas- Parameters:
a
- An areab
- An area- Returns:
true
iffa
could fit insideb
-
containing
Construct a area that will contain botha
andb
.- Type Parameters:
S
- The coordinate space of the areas- Parameters:
a
- An areab
- An area- Returns:
- An area containing
a
andb
-
containsPoint
Determine whether or not a area contains a given point.
- Type Parameters:
S
- The coordinate space of the area- Parameters:
a
- An areax
- The X coordinate of the pointy
- The Y coordinate of the point- Returns:
true
iffa
contains(x, y)
-
fitBetweenHorizontal
@Deprecated public static <S> PAreaL<S> fitBetweenHorizontal(PAreaL<S> fit, PAreaL<S> a, PAreaL<S> b) Deprecated.Attempt to fitfit
betweena
andb
, horizontally.- Type Parameters:
S
- The coordinate space of the areas- Parameters:
fit
- The area to be fitteda
- An areab
- An area- Returns:
- A fitted area
-
fitBetweenVertical
Deprecated.Attempt to fitfit
betweena
andb
, vertically.- Type Parameters:
S
- The coordinate space of the areas- Parameters:
fit
- The area to be fitteda
- An areab
- An area- Returns:
- A fitted area
-
fitBetweenOnX
Attempt to fitfit
betweena
andb
, horizontally.- Type Parameters:
S
- The coordinate space of the areas- Parameters:
fit
- The area to be fitteda
- An areab
- An area- Returns:
- A fitted area
-
fitBetweenOnY
Attempt to fitfit
betweena
andb
, vertically.- Type Parameters:
S
- The coordinate space of the areas- Parameters:
fit
- The area to be fitteda
- An areab
- An area- Returns:
- A fitted area
-
splitAlongParallelToX
Splitarea
along a line parallel to the X axis placed aty
units from its own minimum-y edge.- Type Parameters:
S
- The coordinate space of the areas- Parameters:
area
- The area to be splity
- The relative Y coordinate of the splitting edge- Returns:
- A pair of areas
-
splitAlongParallelToY
Splitarea
along a line parallel to the Y axis placed atx
units from its own minimum-x edge.- Type Parameters:
S
- The coordinate space of the areas- Parameters:
area
- The area to be splitx
- The relative X coordinate of the splitting edge- Returns:
- A pair of areas
-
splitAlongXY
Splitarea
along a two axis-aligned perpendicular lines that intercept at(x, y)
.- Type Parameters:
S
- The coordinate space of the areas- Parameters:
area
- The area to be splitx
- The relative X coordinate of the splitting edgey
- The relative Y coordinate of the splitting edge- Returns:
- The four resulting quadrants
- Since:
- 1.1.0
-
show
- Type Parameters:
S
- The coordinate space of the area- Parameters:
area
- The area- Returns:
- A terse string describing the position and size of the area
-
size
- Type Parameters:
S
- The coordinate space of the area- Parameters:
area
- The area- Returns:
- The size of the area
-
showToBuilder
- Type Parameters:
S
- The coordinate space of the area- Parameters:
area
- The areasb
- A string builder- Returns:
- A terse string describing the position and size of the area
-
alignOnXCenter(PAreaL, PAreaL)