com.supermap.data
类 BoundingBox

java.lang.Object
  继承者 com.supermap.data.BoundingBox

public class BoundingBox
extends java.lang.Object

包围盒类。


构造方法摘要
BoundingBox()
          构造一个新的包围盒对象。
BoundingBox(BoundingBox boundingBox)
          根据指定的包围盒对象构造一个新的与其一致的包围盒对象。
BoundingBox(Point3D lower, Point3D upper)
          根据给定的包围盒最大点和最小点构造一个新的包围盒对象。
 
方法摘要
 void dispose()
          释放该对象所占用的资源。
 boolean equals(BoundingBox boundingBox)
          判断此包围盒类对象与指定的要测试的包围盒对象的 getLower()getUpper() 的返回值是否相等。
 Point3D getCenter()
          返回包围盒的中心点。
static BoundingBox getEMPTY()
          返回空的包围盒对象。
 Point3D getLower()
          返回包围盒的最小三维点,即 X,Y,Z 坐标值最小的三维点对象(Point3D)。
 Point3D getUpper()
          返回包围盒的最大三维点,即 X,Y,Z 坐标值最大的三维点对象(Point3D)。
 boolean isEmpty()
          返回包围盒对象是否为空。
 void setLower(Point3D point3D)
          设置包围盒的最小三维点,即 X,Y,Z 坐标值最小的三维点对象(Point3D)。
 void setUpper(Point3D point3D)
          设置包围盒的最大三维点,即 X,Y,Z 坐标值最大的三维点对象(Point3D)。
 java.lang.String toString()
          将当前包围盒对象输出为格式化的字符串,其格式为(Lower={X=,Y=,Z=},Upper={X=,Y=,Z=})。
 
从类 java.lang.Object 继承的方法
equals, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

构造方法详细信息

BoundingBox

public BoundingBox()
构造一个新的包围盒对象。


BoundingBox

public BoundingBox(BoundingBox boundingBox)
根据指定的包围盒对象构造一个新的与其一致的包围盒对象。

参数:
boundingBox - 指定的包围盒对象。

BoundingBox

public BoundingBox(Point3D lower,
                   Point3D upper)
根据给定的包围盒最大点和最小点构造一个新的包围盒对象。

参数:
lower - 最小点。
upper - 最大点。
方法详细信息

getEMPTY

public static BoundingBox getEMPTY()
返回空的包围盒对象。

返回:
空的包围盒对象。

空的几何对象即 Lower = {X = Double.MIN_VALUE,Y = Double.MIN_VALUE,Z = Double.MIN_VALUE},Upper={x=Double.MIN_VALUE,y= Double.MIN_VALUE,z= Double.MIN_VALUE}


isEmpty

public boolean isEmpty()
返回包围盒对象是否为空。

返回:
包围盒对象为空返回 true;否则返回 false。
默认值:
默认值为 false。

getLower

public Point3D getLower()
返回包围盒的最小三维点,即 X,Y,Z 坐标值最小的三维点对象(Point3D)。

返回:
包围盒的最小三维点。
默认值:
默认值为 {X = 0, Y = 0, Z = 0}。

setLower

public void setLower(Point3D point3D)
设置包围盒的最小三维点,即 X,Y,Z 坐标值最小的三维点对象(Point3D)。

参数:
point3D - 包围盒的最小三维点。
示例:
以下代码实现如何定义一个包围盒对象,并返回其中心点位置。
  public void setLowerTest() {
        // 实例化一个包围盒对象,返回其中心点
        BoundingBox boundingBox = new BoundingBox();
        Point3D point3D_L = new Point3D(1, 1, 1);
        Point3D point3D_U = new Point3D(101, 101, 101);
        boundingBox.setLower(point3D_L);
        boundingBox.setUpper(point3D_U);
        Point3D center = boundingBox.getCenter();
        System.out.print("包围盒对象的中心点为:"+ center);// 包围盒对象的中心点为:{X=51.0,Y=51.0,Z=51.0}
    }
 

getUpper

public Point3D getUpper()
返回包围盒的最大三维点,即 X,Y,Z 坐标值最大的三维点对象(Point3D)。

返回:
包围盒的最大三维点。
默认值:
默认值为 {X = 0, Y = 0, Z = 0}。

setUpper

public void setUpper(Point3D point3D)
设置包围盒的最大三维点,即 X,Y,Z 坐标值最大的三维点对象(Point3D)。

参数:
point3D - 包围盒的最大三维点。
示例:
请参见 setLower() 方法的示例。

getCenter

public Point3D getCenter()
返回包围盒的中心点。

返回:
包围盒的中心点。
示例:
请参见 setLower() 方法的示例。
默认值:
默认值为{X = 0, Y = 0, Z = 0}。

equals

public boolean equals(BoundingBox boundingBox)
判断此包围盒类对象与指定的要测试的包围盒对象的 getLower()getUpper() 的返回值是否相等。

参数:
boundingBox - 指定的要测试的包围盒对象。
返回:
如果指定的要测试的包围盒对象与此包围盒类对象的 getLower()getUpper() 的返回值相等,则返回 true,否则返回 false。

toString

public java.lang.String toString()
将当前包围盒对象输出为格式化的字符串,其格式为(Lower={X=,Y=,Z=},Upper={X=,Y=,Z=})。

覆盖:
java.lang.Object 中的 toString
返回:
表示包围盒对象的字符串。

dispose

public void dispose()
释放该对象所占用的资源。当调用该方法之后,此对象不再可用。