* Copyright (c) 2002-2021 Delft University of Technology, Jaffalaan 5, 2628 BX Delft, the Netherlands. All rights reserved. See * for project information https://simulation.tudelft.nl. The DSOL * project is distributed under a three-clause BSD-style license, which can be found at * * https://simulation.tudelft.nl/dsol/3.0/license.html. *
* @author Peter Jacobs */ public final class BoundsUtil { /** * constructs a new BoundsUtil. */ private BoundsUtil() { // unreachable code } /** * Computes the intersect of the bounding box of the provided bounds with the plane spanned by the zValue. Note that the * bounds are relative to the center and provided without the translation and rotation of the center directed point! * Usually the center is in the bounds, but that is not necessary. The center is in many occasions the Location of an * animated object, and the bounds indicate the outer values of its animation relative to (0,0,0). When the bounding box has * no values on the given z-height, null is returned. As an example: suppose the bounding box has corner coordinates * (-1,-1,-1) and (1,1,1) (all relative to 0,0,0), and the current center location is (0,0,0) and we ask the zIntersect for * z=0, we get a rectangle [(-1,-1), (1,1)]. When we ask the zInterzect for z=2 and center point (2,2,0) we get null (no * bounds on height z=2). When we ask the zIntersect for z=0 and point (2,2,0) we get [(1,1), (3,3)] -- the box is * translated with dx=2 and dy=2. When we ask the zIntersect for z=0 and point (2,2,2) we get null as we 'lifted' the * bounding box above the z-value. When center has a direction, the bounds is first rotated around the center after which * the translation takes place and the bounds on the z-height are calculated. For 2D, a box is always returned. * @param center Point; the point relative to which the bounds need to be calculated * @param bounds Bounds; the bounds for which the intersection needs to be calculated. The Bounds3d are relative to the * center that is provided * @param zValue double; the zValue as the 'height' for which the bounds intersection is calculated * @return Bounds2d the projected rectangle of the intersection, or null if there is no intersection */ public static Bounds2d zIntersect(final Point center, final Bounds bounds, final double zValue) { if (center instanceof OrientedPoint3d && bounds instanceof Bounds3d) { OrientedPoint3d center3d = (OrientedPoint3d) center; Transform3d transform = new Transform3d(); transform.translate(center3d); // note: opposite order of how it should be carried out (!) transform.rotX(center3d.getDirX()); transform.rotY(center3d.getDirY()); transform.rotZ(center3d.getDirZ()); Bounds3d box = transform.transform((Bounds3d) bounds); if (zValue < box.getMinZ() || zValue > box.getMaxZ()) { return null; } return box.project(); } if (center instanceof Point3d && bounds instanceof Bounds3d) { Point3d center3d = (Point3d) center; Transform3d transform = new Transform3d(); transform.translate(center3d); Bounds3d box = transform.transform((Bounds3d) bounds); if (zValue < box.getMinZ() || zValue > box.getMaxZ()) { return null; } return box.project(); } if (center instanceof OrientedPoint2d) { OrientedPoint2d center2d = (OrientedPoint2d) center; Transform2d transform = new Transform2d(); transform.translate(center2d); transform.rotation(center2d.getDirZ()); return transform.transform((Bounds2d) bounds); } if (center instanceof Point2d) { Point2d center2d = (Point2d) center; Transform2d transform = new Transform2d(); transform.translate(center2d); return transform.transform((Bounds2d) bounds); } CategoryLogger.always().warn("BoundsUtil.zIntersect: inconsistent dimensionality of bounds and point"); return null; // inconsistent dimensionality of bounds and point } /** * Rotates and translates a bound relative to an oriented point. Often this point will be the given center point for the * animation. * @param bounds Bounds3d; the bounds that need to be rotated and translated * @param point OrientedPoint3d; the point relative to which the bounds need to be transformed * @return the bounds after rotation and translation */ public static Bounds3d transform(final Bounds3d bounds, final OrientedPoint3d point) { Transform3d transform = new Transform3d(); transform.translate(point); transform.rotX(point.getDirX()); transform.rotY(point.getDirY()); transform.rotZ(point.getDirZ()); return transform.transform(bounds); } /** * Rotates and translates a bound relative to an oriented point. Often this point will be the given center point for the * animation. * @param bounds Bound2ds; the bounds that need to be rotated and translated * @param point OrientedPoint2d; the point relative to which the bounds need to be transformed * @return the bounds after rotation and translation */ public static Bounds2d transform(final Bounds2d bounds, final OrientedPoint2d point) { Transform2d transform = new Transform2d(); transform.translate(point); transform.rotation(point.getDirZ()); return transform.transform(bounds); } /** * Check whether a point is in the bounds, after transforming the bounds relative to the center point (in animation that is * the location). Usually the center is in the bounds, but that is not necessary. The center is in many occasions the * Location of an animated object, and the bounds indicate the outer values of its animation without translation and * rotation (as if center is 0,0,0) and has no direction (rotX, rotY and rotZ are 0.0). * @param center OrientedPoint3d; the 'center' of the bounds. * @param bounds Bounds3d; the bounds relative to 0,0,0 * @param point Point3d; the point that might be in or out of the bounds after they have been rotated and translated * relative to the center. * @return whether or not the point is in the bounds */ public static boolean contains(final OrientedPoint3d center, final Bounds3d bounds, final Point3d point) { Transform3d transform = new Transform3d(); transform.translate(center); transform.rotX(center.getDirX()); transform.rotY(center.getDirY()); transform.rotZ(center.getDirZ()); Bounds3d box = transform.transform(bounds); return box.covers(point); } /** * Check whether a point is in the bounds, after transforming the bounds relative to the center point (in animation that is * the location). Usually the center is in the bounds, but that is not necessary. The center is in many occasions the * Location of an animated object, and the bounds indicate the outer values of its animation without translation and * rotation (as if center is 0,0) and has no direction (rotation 0.0). * @param center OrientedPoint2d; the 'center' of the bounds. * @param bounds Bounds2d; the bounds relative to 0,0 * @param point Point2d; the point that might be in or out of the bounds after they have been rotated and translated * relative to the center. * @return whether or not the point is in the bounds */ public static boolean contains(final OrientedPoint2d center, final Bounds2d bounds, final Point2d point) { Transform2d transform = new Transform2d(); transform.translate(center); transform.rotation(center.getDirZ()); Bounds2d box = transform.transform(bounds); return box.covers(point); } }