Feature3Ds

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

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

构造器概要

构造器
构造器和说明

Feature3Ds()
构造一个新的 Feature3Ds 对象。

构造器
构造器和说明
`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()
```
    返回三维要素对象集合的名称。
    
    返回:
    
    三维要素对象集合的名称。
    
    默认值:
    
    默认值为 "UntitledFeature3Ds"。
  - setName
```
public void setName(java.lang.String value)
```
    设置三维要素对象集合的名称。
    
    参数:
    
    value - 三维要素对象集合的名称。
  - getDescription
```
public java.lang.String getDescription()
```
    返回三维要素对象集合的描述信息。
    
    返回:
    
    三维要素对象集合的描述信息。
    
    默认值:
    
    默认值为一个空的字符串。
  - setDescription
```
public void setDescription(java.lang.String value)
```
    设置三维要素对象集合的描述信息。
    
    参数:
    
    value - 三维要素对象集合的描述信息。
  - getParent
```
public Feature3Ds getParent()
```
    返回三维要素集合的父对象（也是三维要素对象集合对象）。
    三维要素集合类是树状结构的，如下图，假设一个三维要素集合对象的树状结构如下图，如果被操作的三维要素集合对象是红色框里的对象，那么通过本方法返回的其父对象就是蓝色框里的对象。
    
    返回:
    
    三维要素集合的父对象。
    
    默认值:
    
    默认值为空。
  - isVisible
```
public boolean isVisible()
```
    返回三维要素集合是否可见，即三维要素集合中的所有三维要素对象是否可见。
    
    返回:
    
    如果三维要素集合可见，返回 true；否则返回 false。
    
    默认值:
    
    默认值为 true。
  - setVisible
```
public void setVisible(boolean value)
```
    设置三维要素集合是否可见，即三维要素集合中的所有三维要素对象是否可见。
    
    参数:
    
    value - 一个布尔值指定三维要素集合是否可见。
  - getCamera
```
public Camera getCamera()
```
    返回相机对象。
    
    返回:
    
    相机对象。
    
    默认值:
    
    默认值为{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()
```
    释放该对象所占用的资源。当调用该方法之后，此对象不再可用。

类 Feature3Ds

构造器概要

方法概要

从类继承的方法 java.lang.Object

构造器详细资料

Feature3Ds

方法详细资料

getName

setName

getDescription

setDescription

getParent

isVisible

setVisible

getCamera

setCamera

get

getCount

getFeatureArray

getFeaturesArray

findFeature

findFeature

findFeatures

add

add

add

remove

remove

remove

clear

toKML

fromKML

toKMLFile

fromKMLFile

insert

insert

removeAt

exchange

dispose