The coordinate type this shape. This property is read only. An Error will be thrown when trying to assign to this property.
The depth of the bounding box (the box's extent along the Z-axis). The depth must be larger than or equal to zero.
The depth of the bounding box (the box's extent along the Z-axis). The depth must be larger than or equal to zero.
The height of the bounding box (the box's extent along the Y-axis). The height must be larger than or equal to zero.
The height of the bounding box (the box's extent along the Y-axis). The height must be larger than or equal to zero.
The spatial reference of this shape. This property is read only. An Error will be thrown when trying to assign to this property.
The width of this bounding box (the box's extent along the x-axis). The width must be larger than or equal to zero.
The width of this bounding box (the box's extent along the x-axis). The width must be larger than or equal to zero.
The x coordinate or longitude of the location of the bounding box.
The x coordinate or longitude of the location of the bounding box.
The y coordinate or latitude of the location of the bounding box.
The y coordinate or latitude of the location of the bounding box.
The z coordinate of the location of the bounding box.
The z coordinate of the location of the bounding box.
Determines whether a given bounds is inside this bounds. This method checks containment only in two dimensions: on the (x,y)-axis or the (lon,lat)-axis (depending on the spatial reference of the shape).
The bounds for which containment must be checked. If a 3D bounds is passed to this function, it will be treated as a 2D bounds: the z coordinate (height) will be ignored. The reference of the passed bounds must be the same reference as this Bounds
true when the given bounds are contained in this bounds
Determines whether a given bounds is inside this bounds. This method checks containment only in two dimensions: on the (x,y)-axis or the (lon,lat)-axis (depending on the spatial reference of the shape).
The bounds for which containment must be checked. If a 3D bounds is passed to this function, it will be treated as a 2D bounds: the z coordinate (height) will be ignored. The reference of the passed bounds must be the same reference as this Bounds
true when the given bounds are contained in this bounds
Determines whether the given point is inside this shape. This method checks containment only in two dimensions: on the (x,y)-axis or the (lon,lat)-axis (depending on the spatial reference of the shape).
The x coordinate of the point for which containment must be checked
The y coordinate of the point for which containment must be checked
true when the given point is contained in this shape
Determines whether the given point is inside this shape. This method checks containment only in two dimensions: on the (x,y)-axis or the (lon,lat)-axis (depending on the spatial reference of the shape).
The point for which containment must be checked.
true when the given point is contained in this shape
Check whether this Bounds instance contains the bounds in the 3D space.
The bounds whose containment must be checked
true when the point or bounds are contained
Determines whether a given point is inside this shape. This method checks containment in three dimensions: on the (x,y,z)-axis or the (lon,lat,height)-axis (depending on the spatial reference of the shape).
The point for which containment must be checked. If a 3D point is passed to this function, a z-coordinate (height) value of 0 is assumed. This point must have the same spatial reference as the shape.
Indicates whether this shape is equal to another.
the other shape this shape is compared with.
true if both shapes are equal, false otherwise.
Checks whether this Bounds object interacts with the given Bounds object in the 2D space. Only the first two dimensions of the Bounds objects are considered.
the bounds to compare with.
the boolean result of the interaction test.
Moves the location of this Bounds instance to the location specified by x and y.
x coordinate value or the location as a point.
y coordinate value
Moves the location of this Bounds instance to the location specified by x and y.
x coordinate value
y coordinate value
Moves this Bounds instance to the location specified by the x, y and z parameters.
x coordinate value or the point to move the location of this bounds to
y coordinate value
z coordinate value
Moves this Bounds instance to the location specified by the x, y and z parameters.
x coordinate value
y coordinate value
z coordinate value
Moves this Bounds instance to the location in 3D space as specified by the point.
the point to move the location of this bounds to.
Configure this Bounds instance in 2 dimensions.
The x coordinate of Bounds instance's location.
The width of the Bounds instance.
The y coordinate of the Bounds instance's
The height of the Bounds instance's location
Calculates the 2D intersection of this Bounds instance and a given Bounds instance. Only the first two dimensions of the Bounds objects are considered. This Bounds object is updated with the result. Its third dimension is left unchanged.
the other Bounds operand for the intersection.
Calculates the 2D union of this Bounds instance and a given Bounds instance. The result contains at least all the points that are contained in either of the Bounds objects (and typically more). Only the first two dimensions of the Bounds objects are considered. This Bounds object is updated with the result. Its third dimension is left unchanged.
the other Bounds operand for the union.
Configure this Bounds instance in 3 dimensions.
The x coordinate of Bounds instance's location.
The width of the Bounds instance.
The y coordinate of the Bounds instance's
The height of the Bounds instance's location
The z coordinate of the Bounds instance's
The depth of the Bounds instance's location
Calculates the 3D intersection of this Bounds instance and a given Bounds instance. This Bounds object is updated with the result.
the other Bounds operand for the intersection.
Calculates the 3D union of this Bounds object and a given Bounds object. The result contains at least all the points that are contained in either or both of the Bounds objects (and typically more). This Bounds object is updated with the result.
the other Bounds operand for the union.
Configure this Bounds instance in 2 dimensions, using the dimensions of another Bounds instance.
the bounds that must be used to configure this bounds. Only the x, width, y and height properties of this bounds instance will be considered.
Configure this Bounds instance in 2 dimensions, using the dimensions of another Bounds instance.
the bounds that must be used to configure this bounds.
Calculates the 2D extension of this Bounds object that contains a given Point. The result contains at least the given point and all the points that are contained in this Bounds (and typically more). Only the first two dimensions of this Bounds object and the Bounds are considered. This Bounds object is updated with the result. Its third dimension is left unchanged.
the point that should be inside (or at the edge) after the extension of the bounds.
Calculates the 3D extension of this Bounds that contains a given Point.
The result contains at least the given point and all the points that are contained in this
Bounds (and typically more). This Bounds object is updated
with the result.
the point operand for the union.
Translates this bounds from its current position over the given translation vector to another location. This method can be called with an x, y and optionally a z value. If the z coordinate is not specified, the translation will only affect the x and y coordinate.
x coordinate value
y coordinate value
z coordinate value, may be omitted.
Translates the shape over the given vector in 2D space.
The x coordinate of the translation vector
The y coordinate of the translation vector
Translates this bounds from its current position over the given translation vector to another location.
x coordinate value
y coordinate value
z coordinate value
A Bounds object is a 3D axis-aligned box. It has a location, a width, height, and a depth. The location is represented by the smallest x, y and z coordinate encompassed by the box, i.e. the lower-left corner. The width, height and depth are the box's extents in the positive directions of the x, y and z axis, respectively.
Note that Bounds instances will be normalized when (re)configuring them. width, h In case the Bounds instance is defined in a GEODETIC coordinate system, the properties will be normalized:- the x coordinate will be in the [-180, 180] range.
-
the width will be in the [0, 360] range. In case the width covers the entire world, the x
coordinate will be normalized to -180.
- the y coordinate will be [-90, 90] range.
- the height coordinate will never exceed the north pole. (i.e. y + height <= 90).
- no normalization occurs on the z-axis.
The box is typically used as a bounding box for more complex geometries. It must be instantiated using createBounds.