Layer3DSettingVector (iObjects Java Help)

java.lang.Object
- com.supermap.realspace.Layer3DSetting
- - com.supermap.realspace.Layer3DSettingVector

public class Layer3DSettingVector
extends Layer3DSetting

矢量数据集三维图层扩展设置类。

该类用于设置矢量数据集作为三维图层加入到三维窗口中所使用的一些显示风格或者返回相关的信息。

下面两幅图分别为线矢量数据集和面矢量数据集经过拉伸并贴图，添加到三维场景中。

线数据集添加到三维场景（拉伸并贴图）

面数据集添加到三维场景（拉伸并贴图）

示范代码:

以下代码示范了如何将二维面矢量数据集添加到三维场景中，同时对面矢量数据集中的面对象进行拉伸和风格设置。假设 Space 数据源中存在一个名为 City_R 的面矢量数据集，该数据集中包含字段 BottomAltitude、ExtendedHeight、SideTexture、TopTexture，分别为：底部高程字段、拉伸高度字段、侧面纹理字段和顶部纹理字段。

 public void TestLayer3DSettingVector(DatasetVector targetDataset,Scene sceneObject)
 {
     //矢量数据集三维图层扩展设置
     Layer3DSettingVector layer3DSettingVector = new Layer3DSettingVector();
     GeoStyle3D geoStyle3D = new GeoStyle3D();
     geoStyle3D.setAltitudeMode (AltitudeMode.RELATIVE_TO_GROUND);
     geoStyle3D.setFillMode(FillMode3D.LINE_AND_FILL);
     geoStyle3D.setLineColor (Color.RED);
     geoStyle3D.setLineWidth (1);
     layer3DSettingVector.setStyle (geoStyle3D);
     layer3DSettingVector.setBottomAltitudeField ( "BottomAltitude");
     layer3DSettingVector.setExtendedHeightField ("ExtendedHeight");
     layer3DSettingVector.setSideTextureField ("SideTexture");
     layer3DSettingVector.setTopTextureField ("TopTexture");

     //将矢量数据集显示在三维场景中
     Layer3DDataset layer3DDataset=sceneObject.getLayers().add(targetDataset, layer3DSettingVector, true);
     layer3DDataset.updateData();
     sceneObject.refresh();

     }

构造器概要

构造器
构造器和说明
`Layer3DSettingVector()` 构造一个新的 Layer3DSettingVector 对象。
`Layer3DSettingVector(Layer3DSettingVector layer3DSettingVector)` 根据给定的 Layer3DSettingVector 对象构造一个与其完全相同的新对象。

方法概要

所有方法实例方法具体方法
限定符和类型	方法和说明
`String`	`getBottomAltitudeField()` 返回底部高程字段名称。
`Effect3D`	`getEffect()`
`String`	`getExtendedHeightField()` 返回拉伸高度字段名称。
`String`	`getSideTextureField()` 返回侧面纹理字段名称，该字段值中存储的是由分号隔开的纹理图片文件路径。
`GeoStyle3D`	`getStyle()` 返回矢量数据集作为三维图层加入到三维窗口中所使用的显示风格。
`String`	`getSymbolScaleXField()` 获取符号在X方向缩放的字段名称。
`String`	`getSymbolScaleYField()` 获取符号在Y方向缩放的字段名称。
`String`	`getTilingUField()` 返回侧面纹理横向重复次数字段。
`String`	`getTilingVField()` 返回侧面纹理竖向重复次数字段。
`String`	`getTopTextureField()` 返回顶部纹理字段名称，该字段存储的是纹理图片文件路径。
`String`	`getTopTilingUField()` 返回顶面纹理横向重复次数字段。
`String`	`getTopTilingVField()` 返回顶面纹理竖向重复次数字段。
`Layer3DSettingType`	`getType()`
`int`	`getUpdateSize()` 获取在Scene场景渲染该数据集图层时，每次更新的缓存块数，具体值为该属性值的平方，即 UpdateSize * UpdateSize。
`boolean`	`isUseEffect()`
`void`	`setBottomAltitudeField(String value)` 设置底部高程字段名称。
`void`	`setExtendedHeightField(String value)` 设置拉伸高度字段名称。
`void`	`setSideTextureField(String value)` 设置侧面纹理字段名称，该字段值中存储的是由分号隔开的纹理图片文件路径。
`void`	`setStyle(GeoStyle3D style)` 设置矢量数据集作为三维图层加入到三维窗口中所使用的显示风格。
`void`	`setSymbolScaleXField(String value)` 设置符号在X方向缩放的字段名称，设置后，符号可根据字段值在X方向上缩放对应的比例。
`void`	`setSymbolScaleYField(String value)` 设置符号在Y方向缩放的字段名称，设置后，符号可根据字段值在Y方向上缩放对应的比例。
`void`	`setTilingUField(String value)` 设置侧面纹理横向重复次数字段。
`void`	`setTilingVField(String value)` 设置侧面纹理竖向重复次数字段。
`void`	`setTopTextureField(String value)` 设置顶部纹理字段名称，该字段存储的是由分号隔开的纹理图片文件路径。
`void`	`setTopTilingUField(String value)` 设置顶面纹理横向重复次数字段。
`void`	`setTopTilingVField(String value)` 设置顶面纹理竖向重复次数字段。
`void`	`setUpdateSize(int value)` 设置在Scene场景渲染该数据集图层时，每次更新的缓存块数，具体值为该属性值的平方，即 UpdateSize * UpdateSize。
`void`	`setUseEffect(boolean value)`

从类继承的方法 java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 构造器详细资料
  - Layer3DSettingVector
```
public Layer3DSettingVector()
```
    构造一个新的 Layer3DSettingVector 对象。
  - Layer3DSettingVector
```
public Layer3DSettingVector(Layer3DSettingVector layer3DSettingVector)
```
    根据给定的 Layer3DSettingVector 对象构造一个与其完全相同的新对象。
    
    参数:
    
    layer3DSettingVector - 给定的 Layer3DSettingVector 对象。
- 方法详细资料
  - getType
```
public Layer3DSettingType getType()
```
    指定者:
    
    getType 在类中 Layer3DSetting
  - getStyle
```
public GeoStyle3D getStyle()
```
    返回矢量数据集作为三维图层加入到三维窗口中所使用的显示风格。
    
    返回:
    
    矢量数据集作为三维图层加入到三维窗口中所使用的显示风格。
    
    默认值:
    
    默认值为 GeoStyle3D(FillForeColor = java.awt.Color[r=255,g=255,b=255],LineColor = java.awt.Color[r=255,g=255,b=0],LineWidth = 1.0,MarkerIconFile = ,MarkerIconScale = 1.0,MarkerColor = java.awt.Color[r=255,g=255,b=0],MarkerSize = 4.0,Fill3DMode = LINE_AND_FILL,BottomAltitude = 0.0,ExtendedHeight = 0.0,TilingU = 1.0,TilingV = 1.0,TopTextureFile = ,AltitudeMode = CLAMP_TO_GROUND})
  - setStyle
```
public void setStyle(GeoStyle3D style)
```
    设置矢量数据集作为三维图层加入到三维窗口中所使用的显示风格。
    
    参数:
    
    style - 矢量数据集作为三维图层加入到三维窗口中所使用的显示风格。
  - getBottomAltitudeField
```
public String getBottomAltitudeField()
```
    返回底部高程字段名称。当将矢量数据集中的对象显示在三维窗口中时，利用对象原有的坐标信息，将对象显示在相应的坐标处，同时，还可以使用返回值对应字段中的高程值将相应的对象显示在对应的高度上，也就是该字段提供了矢量数据集中对象的高程信息。
    
    返回:
    
    底部高程字段名称。
    
    默认值:
    
    默认值为 "BottomHeight"。
  - setBottomAltitudeField
```
public void setBottomAltitudeField(String value)
```
    设置底部高程字段名称。当将矢量数据集中的对象显示在三维窗口中时，利用对象原有的坐标信息，将对象显示在相应的坐标处，同时，还可以使用 value 对应字段中的高程值将相应的对象显示在对应的高度上，也就是该字段提供了矢量数据集中对象的高程信息。
    
    参数:
    
    value - 底部高程字段名称。
  - getExtendedHeightField
```
public String getExtendedHeightField()
```
    返回拉伸高度字段名称。当将矢量数据集中的对象显示在三维窗口中时，可以使用该返回值对应的字段中的值对数据集中的二维几何对象进行垂直拉伸，拉伸的高度即为该字段的值。
    
    返回:
    
    拉伸高度字段名称。
    
    默认值:
    
    默认值为"TopHeight"。
  - setExtendedHeightField
```
public void setExtendedHeightField(String value)
```
    设置拉伸高度字段名称。当将矢量数据集中的对象显示在三维窗口中时，可以使用 value 对应的字段中的值对数据集中的二维几何对象进行垂直拉伸，拉伸的高度即为该字段的值。
    
    参数:
    
    value - 拉伸高度字段名称。
  - getTopTextureField
```
public String getTopTextureField()
```
    返回顶部纹理字段名称，该字段存储的是纹理图片文件路径。当将矢量数据集中的对象显示在三维窗口中时，可以对数据集中的二维几何对象进行垂直拉伸，使之变为三维体对象，体对象的顶部将使用该返回值对应的字段中指示的图片进行纹理渲染。
    
    返回:
    
    顶部纹理字段名称，该字段存储的是由分号隔开的纹理图片文件路径。
    
    默认值:
    
    默认值为 "TopTexture"。
  - setTopTextureField
```
public void setTopTextureField(String value)
```
    设置顶部纹理字段名称，该字段存储的是由分号隔开的纹理图片文件路径。当将矢量数据集中的对象显示在三维窗口中时，可以对数据集中的二维几何对象进行垂直拉伸，使之变为三维体对象，体对象的顶部将使用参数 value 对应的字段中指示的图片进行纹理渲染。
    
    参数:
    
    value - 顶部纹理字段名称，该字段存储的是由分号隔开的纹理图片文件路径。
  - getSideTextureField
```
public String getSideTextureField()
```
    返回侧面纹理字段名称，该字段值中存储的是由分号隔开的纹理图片文件路径。当将矢量数据集中的对象显示在三维窗口中时，可以对数据集中的二维几何对象进行垂直拉伸，使之变为三维体对象，体对象的侧面将使用该返回值对应的字段中指示的图片进行纹理渲染。
    
    返回:
    
    侧面纹理字段名称，该字段值中存储的是由分号隔开的纹理图片文件路径。
    
    默认值:
    
    默认值为 "SideTexture"。
  - setSideTextureField
```
public void setSideTextureField(String value)
```
    设置侧面纹理字段名称，该字段值中存储的是由分号隔开的纹理图片文件路径。当将矢量数据集中的对象显示在三维窗口中时，可以对数据集中的二维几何对象进行垂直拉伸，使之变为三维体对象，体对象的侧面将使用参数 value 对应的字段中指示的图片进行纹理渲染。
    
    参数:
    
    value - 侧面纹理字段名称，该字段值中存储的是由分号隔开的纹理图片文件路径。
  - getTilingUField
```
public String getTilingUField()
```
    返回侧面纹理横向重复次数字段。
    
    返回:
    
    侧面纹理横向重复次数字段。
    
    默认值:
    
    默认值为 "TilingU"。
  - setTilingUField
```
public void setTilingUField(String value)
```
    设置侧面纹理横向重复次数字段。当将矢量数据集中的对象显示在三维窗口中时，可以对数据集中的二维几何对象进行垂直拉伸，使之变为三维体对象，体对象的侧面可以使用指定的图片进行纹理渲染，在渲染时系统会根据图片的尺寸、体对象侧面的尺寸以及重复贴图的次数（包括横向和纵向次数）对图片进行拉伸，而该方法指定的数值为图片在侧面横向上重复贴图的次数。
    
    参数:
    
    value - 侧面纹理横向重复次数字段。
  - getTilingVField
```
public String getTilingVField()
```
    返回侧面纹理竖向重复次数字段。
    
    返回:
    
    侧面纹理竖向重复次数字段。
    
    默认值:
    
    默认值为"TilingV"。
  - setTilingVField
```
public void setTilingVField(String value)
```
    设置侧面纹理竖向重复次数字段。当将矢量数据集中的对象显示在三维窗口中时，可以对数据集中的二维几何对象进行垂直拉伸，使之变为三维体对象，体对象的侧面可以使用指定的图片进行纹理渲染，在渲染时系统会根据图片的尺寸、体对象侧面的尺寸以及重复贴图的次数（包括横向和纵向次数）对图片进行拉伸，而该方法指定的数值为图片在侧面纵向上重复贴图的次数。
    
    参数:
    
    value - 侧面纹理竖向重复次数字段。
  - getTopTilingUField
```
public String getTopTilingUField()
```
    返回顶面纹理横向重复次数字段。
    
    返回:
    
    顶面纹理横向重复次数字段。
    
    默认值:
    
    默认值为 "TopTilingU"。
  - setTopTilingUField
```
public void setTopTilingUField(String value)
```
    设置顶面纹理横向重复次数字段。当将矢量数据集中的对象显示在三维窗口中时，可以对数据集中的二维几何对象进行垂直拉伸，使之变为三维体对象，体对象的顶面可以使用指定的图片进行纹理渲染，在渲染时系统会根据图片的尺寸、体对象侧面的尺寸以及重复贴图的次数（包括横向和纵向次数）对图片进行拉伸，而该方法指定的数值为图片在顶面横向上重复贴图的次数。
    
    参数:
    
    value - 顶面纹理横向重复次数字段。
  - getTopTilingVField
```
public String getTopTilingVField()
```
    返回顶面纹理竖向重复次数字段。
    
    返回:
    
    顶面纹理竖向重复次数字段。
    
    默认值:
    
    默认值为"TopTilingV"。
  - setTopTilingVField
```
public void setTopTilingVField(String value)
```
    设置顶面纹理竖向重复次数字段。当将矢量数据集中的对象显示在三维窗口中时，可以对数据集中的二维几何对象进行垂直拉伸，使之变为三维体对象，体对象的侧面可以使用指定的图片进行纹理渲染，在渲染时系统会根据图片的尺寸、体对象侧面的尺寸以及重复贴图的次数（包括横向和纵向次数）对图片进行拉伸，而该方法指定的数值为图片在顶面纵向上重复贴图的次数。
    
    参数:
    
    value - 顶面纹理竖向重复次数字段。
  - getSymbolScaleXField
```
public String getSymbolScaleXField()
```
    获取符号在X方向缩放的字段名称。
    
    返回:
    
    字段名称。
  - setSymbolScaleXField
```
public void setSymbolScaleXField(String value)
```
    设置符号在X方向缩放的字段名称，设置后，符号可根据字段值在X方向上缩放对应的比例。
    
    参数:
    
    value - 待设置字段名称。
  - getSymbolScaleYField
```
public String getSymbolScaleYField()
```
    获取符号在Y方向缩放的字段名称。
    
    返回:
    
    字段名称。
  - setSymbolScaleYField
```
public void setSymbolScaleYField(String value)
```
    设置符号在Y方向缩放的字段名称，设置后，符号可根据字段值在Y方向上缩放对应的比例。
    
    参数:
    
    value - 待设置字段名称。
  - getUpdateSize
```
public int getUpdateSize()
```
    获取在Scene场景渲染该数据集图层时，每次更新的缓存块数，具体值为该属性值的平方，即 UpdateSize * UpdateSize。
    
    返回:
    
    每次更新的缓存块数。
  - setUpdateSize
```
public void setUpdateSize(int value)
```
    设置在Scene场景渲染该数据集图层时，每次更新的缓存块数，具体值为该属性值的平方，即 UpdateSize * UpdateSize。
    
    参数:
    
    value - 指定的每次更新的缓存块数。
  - isUseEffect
```
public boolean isUseEffect()
```
  - setUseEffect
```
public void setUseEffect(boolean value)
```
  - getEffect
```
public Effect3D getEffect()
```

类 Layer3DSettingVector

构造器概要

方法概要

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

构造器详细资料

Layer3DSettingVector

Layer3DSettingVector

方法详细资料

getType

getStyle

setStyle

getBottomAltitudeField

setBottomAltitudeField

getExtendedHeightField

setExtendedHeightField

getTopTextureField

setTopTextureField

getSideTextureField

setSideTextureField

getTilingUField

setTilingUField

getTilingVField

setTilingVField

getTopTilingUField

setTopTilingUField

getTopTilingVField

setTopTilingVField

getSymbolScaleXField

setSymbolScaleXField

getSymbolScaleYField

setSymbolScaleYField

getUpdateSize

setUpdateSize

isUseEffect

setUseEffect

getEffect