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

-
-
构造器概要
构造器 构造器和说明 Feature3Ds()构造一个新的 Feature3Ds 对象。
-
方法概要
所有方法 实例方法 具体方法 限定符和类型 方法和说明 Feature3Dadd(Feature3D feature)向该三维要素集合中添加三维要素对象。Feature3Dsadd(Feature3Ds features)向该三维要素集合中添加三维要素集合对象。Feature3Dadd(Geometry3D geometry)向三维要素集合中添加三维几何对象,使其成为集合中的三维要素对象,返回三维要素对象。voidclear()清空三维要素集合中的所有子集合对象和所有三维要素对象。voiddispose()释放该对象所占用的资源。voidexchange(int index1, int index2)交换指定索引处的对象。Feature3DfindFeature(int id, Feature3DSearchOption option)根据给定的三维要素对象ID以及指定的查询选项,查找并返回三维要素对象。Feature3D[]findFeature(java.lang.String name, Feature3DSearchOption option)根据给定的三维要素对象的名称以及指定的查询选项,查找并返回名称为指定名称的所有三维要素对象。Feature3Ds[]findFeatures(java.lang.String name, Feature3DSearchOption option)根据给定的三维要素集合对象的名称以及指定的查询选项,查找并返回名称为指定名称的所有三维要素集合对象。booleanfromKML(java.lang.String kml)从 KML 字符串中导入三维要素集合对象。booleanfromKMLFile(java.lang.String kmlFile)从 KML 文件导入三维要素集合对象。java.lang.Objectget(int index)返回指定索引处的项。CameragetCamera()返回相机对象。intgetCount()返回该对象所包含项的个数。java.lang.StringgetDescription()返回三维要素对象集合的描述信息。Feature3D[]getFeatureArray(Feature3DSearchOption option)返回该三维要素集合对象中的三维要素对象数组,查询选项用于设置是只返回顶层叶子结点(三维要素对象)数组还是返回所有的叶子结点(三维要素对象)数组。Feature3Ds[]getFeaturesArray(Feature3DSearchOption option)返回该三维要素集合对象中子对象的数组,子对象也是三维要素集合对象。java.lang.StringgetName()返回三维要素对象集合的名称。Feature3DsgetParent()返回三维要素集合的父对象(也是三维要素对象集合对象)。Feature3Dinsert(int index, Feature3D feature)在指定的索引处插入三维要素对象。Feature3Dsinsert(int index, Feature3Ds features)在指定的索引处插入三维要素集合对象。booleanisVisible()返回三维要素集合是否可见,即三维要素集合中的所有三维要素对象是否可见。voidremove(Feature3D feature)删除三维要素集合对象中的三维要素对象。voidremove(Feature3Ds features)删除三维要素集合对象中的三维要素集合子对象。voidremove(int id)根据三维要素对象的 ID 删除三维要素集合对象中的三维要素对象。voidremoveAt(int index)删除指定索引处的项。voidsetCamera(Camera camera)设置相机对象。voidsetDescription(java.lang.String value)设置三维要素对象集合的描述信息。voidsetName(java.lang.String value)设置三维要素对象集合的名称。voidsetVisible(boolean value)设置三维要素集合是否可见,即三维要素集合中的所有三维要素对象是否可见。java.lang.StringtoKML()返回三维要素集合对象的描述信息的 KML 字符串。voidtoKMLFile(java.lang.String kmlFile)将三维要素集合对象输出成 KML 文件。
-
-
-
方法详细资料
-
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()
释放该对象所占用的资源。当调用该方法之后,此对象不再可用。
-
-