com.supermap.realspace

类 Feature3Ds

  • java.lang.Object
    • com.supermap.realspace.Feature3Ds


  • public class Feature3Ds
    extends java.lang.Object
    三维要素集合类。

    该类对象是三维要素对象的集合。三维要素集合类比较特殊,它不单纯是三维要素对象的集合,它是树状结构,也就是说三维要素集合对象还可以包含子对象,子对象也是三维要素集合类的对象。因此,一个三维要素集合对象可以包括零个或多个子对象和零个或多个三维要素对象。 下图是一个简单的例子,可以帮助进一步理解树状三维要素集合:图中的 Feature3Ds object 是三维要素集合对象,Feature3D object 是三维要素对象,每个三维要素集合对象可以包含零个或多个三维要素对象或者包含零个或多个三维要素对象,或者什么也没有,即一个空的集合。

    • 构造器概要

      构造器 
      构造器和说明
      Feature3Ds()
      构造一个新的 Feature3Ds 对象。
    • 方法概要

      所有方法 实例方法 具体方法 
      限定符和类型 方法和说明
      Feature3D add(Feature3D feature)
      向该三维要素集合中添加三维要素对象。
      Feature3Ds add(Feature3Ds features)
      向该三维要素集合中添加三维要素集合对象。
      Feature3D add(Geometry3D geometry)
      向三维要素集合中添加三维几何对象,使其成为集合中的三维要素对象,返回三维要素对象。
      void clear()
      清空三维要素集合中的所有子集合对象和所有三维要素对象。
      void dispose()
      释放该对象所占用的资源。
      void exchange(int index1, int index2)
      交换指定索引处的对象。
      Feature3D findFeature(int id, Feature3DSearchOption option)
      根据给定的三维要素对象ID以及指定的查询选项,查找并返回三维要素对象。
      Feature3D[] findFeature(java.lang.String name, Feature3DSearchOption option)
      根据给定的三维要素对象的名称以及指定的查询选项,查找并返回名称为指定名称的所有三维要素对象。
      Feature3Ds[] findFeatures(java.lang.String name, Feature3DSearchOption option)
      根据给定的三维要素集合对象的名称以及指定的查询选项,查找并返回名称为指定名称的所有三维要素集合对象。
      boolean fromKML(java.lang.String kml)
      从 KML 字符串中导入三维要素集合对象。
      boolean fromKMLFile(java.lang.String kmlFile)
      从 KML 文件导入三维要素集合对象。
      java.lang.Object get(int index)
      返回指定索引处的项。
      Camera getCamera()
      返回相机对象。
      int getCount()
      返回该对象所包含项的个数。
      java.lang.String getDescription()
      返回三维要素对象集合的描述信息。
      Feature3D[] getFeatureArray(Feature3DSearchOption option)
      返回该三维要素集合对象中的三维要素对象数组,查询选项用于设置是只返回顶层叶子结点(三维要素对象)数组还是返回所有的叶子结点(三维要素对象)数组。
      Feature3Ds[] getFeaturesArray(Feature3DSearchOption option)
      返回该三维要素集合对象中子对象的数组,子对象也是三维要素集合对象。
      java.lang.String getName()
      返回三维要素对象集合的名称。
      Feature3Ds getParent()
      返回三维要素集合的父对象(也是三维要素对象集合对象)。
      Feature3D insert(int index, Feature3D feature)
      在指定的索引处插入三维要素对象。
      Feature3Ds insert(int index, Feature3Ds features)
      在指定的索引处插入三维要素集合对象。
      boolean isVisible()
      返回三维要素集合是否可见,即三维要素集合中的所有三维要素对象是否可见。
      void remove(Feature3D feature)
      删除三维要素集合对象中的三维要素对象。
      void remove(Feature3Ds features)
      删除三维要素集合对象中的三维要素集合子对象。
      void remove(int id)
      根据三维要素对象的 ID 删除三维要素集合对象中的三维要素对象。
      void removeAt(int index)
      删除指定索引处的项。
      void setCamera(Camera camera)
      设置相机对象。
      void setDescription(java.lang.String value)
      设置三维要素对象集合的描述信息。
      void setName(java.lang.String value)
      设置三维要素对象集合的名称。
      void setVisible(boolean value)
      设置三维要素集合是否可见,即三维要素集合中的所有三维要素对象是否可见。
      java.lang.String toKML()
      返回三维要素集合对象的描述信息的 KML 字符串。
      void toKMLFile(java.lang.String kmlFile)
      将三维要素集合对象输出成 KML 文件。
      • 从类继承的方法 java.lang.Object

        equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    • 构造器详细资料

      • Feature3Ds

        public Feature3Ds()
        构造一个新的 Feature3Ds 对象。
    • 方法详细资料

      • getName

        public java.lang.String getName()
        返回三维要素对象集合的名称。
        返回:
        三维要素对象集合的名称。
        Default:
        默认值为 "UntitledFeature3Ds"。
      • setName

        public void setName(java.lang.String value)
        设置三维要素对象集合的名称。
        参数:
        value - 三维要素对象集合的名称。
      • getDescription

        public java.lang.String getDescription()
        返回三维要素对象集合的描述信息。
        返回:
        三维要素对象集合的描述信息。
        Default:
        默认值为一个空的字符串。
      • setDescription

        public void setDescription(java.lang.String value)
        设置三维要素对象集合的描述信息。
        参数:
        value - 三维要素对象集合的描述信息。
      • getParent

        public Feature3Ds getParent()
        返回三维要素集合的父对象(也是三维要素对象集合对象)。

        三维要素集合类是树状结构的,如下图,假设一个三维要素集合对象的树状结构如下图,如果被操作的三维要素集合对象是红色框里的对象,那么通过本方法返回的其父对象就是蓝色框里的对象。

        返回:
        三维要素集合的父对象。
        Default:
        默认值为空。
      • isVisible

        public boolean isVisible()
        返回三维要素集合是否可见,即三维要素集合中的所有三维要素对象是否可见。
        返回:
        如果三维要素集合可见,返回 true;否则返回 false。
        Default:
        默认值为 true。
      • setVisible

        public void setVisible(boolean value)
        设置三维要素集合是否可见,即三维要素集合中的所有三维要素对象是否可见。
        参数:
        value - 一个布尔值指定三维要素集合是否可见。
      • getCamera

        public Camera getCamera()
        返回相机对象。
        返回:
        相机对象。
        Default:
        默认值为{Altitude=-1.79769313486232E+308,Heading=-1.79769313486232E+308,Latitude=-1.79769313486232E+308,Longitude=-1.79769313486232E+308,Tilt=-1.79769313486232E+308,AltitudeMode=CLAMP_TO_GROUND}
      • setCamera

        public void setCamera(Camera camera)
        设置相机对象。
        参数:
        camera - 相机对象。
      • get

        public java.lang.Object get(int index)
        返回指定索引处的项。
        参数:
        index - 指定的索引值。
        返回:
        指定索引处的项。
      • getCount

        public int getCount()
        返回该对象所包含项的个数。
        返回:
        该对象所包含项的个数。
      • getFeatureArray

        public Feature3D[] getFeatureArray(Feature3DSearchOption option)
        返回该三维要素集合对象中的三维要素对象数组,查询选项用于设置是只返回顶层叶子结点(三维要素对象)数组还是返回所有的叶子结点(三维要素对象)数组。
        参数:
        option - 查询选项。有关查询选项的详细信息,请参见 Feature3DSearchOption 枚举类。
        返回:
        三维要素对象数组。
      • getFeaturesArray

        public Feature3Ds[] getFeaturesArray(Feature3DSearchOption option)
        返回该三维要素集合对象中子对象的数组,子对象也是三维要素集合对象。查询选项用于设置是只返回顶层的子对象还是返回所有层的子对象。有关查询选项的详细信息,请参见 Feature3DSearchOption 枚举类。
        参数:
        option - 查询选项。有关查询选项的详细信息,请参见 Feature3DSearchOption 枚举类。
        返回:
        三维要素集合对象的数组。
      • findFeature

        public Feature3D findFeature(int id,
                                     Feature3DSearchOption option)
        根据给定的三维要素对象ID以及指定的查询选项,查找并返回三维要素对象。
        参数:
        id - 三维要素对象的ID。
        option - 查询选项。
        返回:
        三维要素对象。
      • findFeature

        public Feature3D[] findFeature(java.lang.String name,
                                       Feature3DSearchOption option)
        根据给定的三维要素对象的名称以及指定的查询选项,查找并返回名称为指定名称的所有三维要素对象。
        参数:
        name - 三维要素对象的名称。
        option - 查询选项。
        返回:
        三维要素对象数组。
      • findFeatures

        public Feature3Ds[] findFeatures(java.lang.String name,
                                         Feature3DSearchOption option)
        根据给定的三维要素集合对象的名称以及指定的查询选项,查找并返回名称为指定名称的所有三维要素集合对象。
        参数:
        name - 三维要素集合对象的名称。
        option - 查询选项。
        返回:
        三维要素集合对象的数组。
      • add

        public Feature3D add(Feature3D feature)
        向该三维要素集合中添加三维要素对象。
        参数:
        feature - 待添加的三维要素对象。
        返回:
        三维要素对象。
      • add

        public Feature3Ds add(Feature3Ds features)
        向该三维要素集合中添加三维要素集合对象。
        参数:
        features - 待添加的三维要素对象集合。
        返回:
        三维要素对象集合。
      • add

        public Feature3D add(Geometry3D geometry)
        向三维要素集合中添加三维几何对象,使其成为集合中的三维要素对象,返回三维要素对象。
        参数:
        geometry - 待添加的三维几何对象。
        返回:
        三维要素对象。
      • remove

        public void remove(int id)
        根据三维要素对象的 ID 删除三维要素集合对象中的三维要素对象。
        参数:
        id - 待删除的三维要素对象的 ID。
      • remove

        public void remove(Feature3D feature)
        删除三维要素集合对象中的三维要素对象。
        参数:
        feature - 待删除的三维要素对象。
      • remove

        public void remove(Feature3Ds features)
        删除三维要素集合对象中的三维要素集合子对象。
        参数:
        features - 待删除的三维要素集合子对象。
      • clear

        public void clear()
        清空三维要素集合中的所有子集合对象和所有三维要素对象。
      • toKML

        public java.lang.String toKML()
        返回三维要素集合对象的描述信息的 KML 字符串。
        返回:
        三维要素集合对象的描述信息的 KML 字符串。
      • fromKML

        public boolean fromKML(java.lang.String kml)
        从 KML 字符串中导入三维要素集合对象。
        参数:
        kml - KML字符串。
        返回:
        导入成功返回 true;否则返回 false。
      • toKMLFile

        public void toKMLFile(java.lang.String kmlFile)
        将三维要素集合对象输出成 KML 文件。
        参数:
        kmlFile - 指定的 KML 文件相对路径。
      • fromKMLFile

        public boolean fromKMLFile(java.lang.String kmlFile)
        从 KML 文件导入三维要素集合对象。
        参数:
        kmlFile - 指定的 KML 文件相对路径。
        返回:
        导入成功返回 true;否则返回 false。
      • insert

        public Feature3Ds insert(int index,
                                 Feature3Ds features)
        在指定的索引处插入三维要素集合对象。
        参数:
        index - 指定的目标索引值。
        features - 指定的待插入的三维要素集合对象。
        返回:
        新插入的三维要素集合对象。
      • insert

        public Feature3D insert(int index,
                                Feature3D feature)
        在指定的索引处插入三维要素对象。
        参数:
        index - 指定的目标索引值。
        feature - 指定的待插入的三维要素对象。
        返回:
        新插入三维要素对象。
      • removeAt

        public void removeAt(int index)
        删除指定索引处的项。
        参数:
        index - 指定的待删除项所处的索引值。
      • exchange

        public void exchange(int index1,
                             int index2)
        交换指定索引处的对象。
        参数:
        index1 - 需要进行交换操作项的索引。
        index2 - 需要进行交换操作项的索引。
      • dispose

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