com.supermap.data
类 GeoStyle3D

java.lang.Object
  com.supermap.data.GeoStyle3D

public class GeoStyle3D
extends java.lang.Object

三维几何对象风格类。

该类主要用于设置三维几何对象的显示风格。

示例:

以下代码示范如何为一个三维面几何对象设置三维风格。

 public void geoStyle3DTest() {
        // 实例化一个三维面几何对象 geoRegion3D，并对其进行风格设置
        GeoStyle3D geoStyle3D = new GeoStyle3D();
        geoStyle3D.setAltitudeMode(com.supermap.data.AltitudeMode.ABSOLUTE);
        geoStyle3D.setBottomAltitude(200);
        geoStyle3D.setExtendedHeight(20);
        geoStyle3D.setFillForeColor(java.awt.Color.BLUE);
        geoStyle3D.setFillMode(FillMode3D.FILL);
        GeoRegion3D geoRegion3D = new GeoRegion3D();
        Point3Ds point3Ds = new Point3Ds();
        Point3D[] point3DArray = { new Point3D(10, 50, 10),
        new Point3D(150, 50, 20), new Point3D(100, 150, 20),
        new Point3D(10, 150, 10) };
        point3Ds.addRange(point3DArray);
        geoRegion3D.addPart(point3Ds);
        geoRegion3D.setStyle3D(geoStyle3D);
 }
 

构造方法摘要

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

GeoStyle3D(GeoStyle3D style3D)
根据给定的 GeoStyle3D 对象构造一个与其完全相同的新对象。

方法摘要

GeoStyle3D	clone() 返回当前 GeoStyle3D 对象的一个拷贝。
void	dispose() 释放该对象所占用的资源。
boolean	fromXML(java.lang.String xml) 根据传入的 XML 字符串重新构造该 GeoStyle3D 对象。
AltitudeMode	getAltitudeMode() 返回三维场景中的几何对象的高度模式。
AnchorOffsetMode	getAnchorOffsetMode() 获取标签专题图文字偏移模式。
double	getBottomAltitude() 返回底部高程值。
double	getExtendedHeight() 返回拉伸高度值。
java.awt.Color	getFillBackColor() 返回三维场景中的面几何对象的填充符号的背景色。
java.awt.Color	getFillForeColor() 返回三维场景中的面几何对象的填充符号的前景色。
double	getFillGradientAngle() 渐变填充的旋转角度，以度为单位，精确到0.1度，逆时针方向为正方向。
FillGradientMode	getFillGradientMode() 返回渐变填充风格的渐变类型。
int	getFillGradientOffsetRatioX() 返回渐变填充中心点相对于填充区域范围中心点的水平偏移百分比。
int	getFillGradientOffsetRatioY() 返回填充中心点相对于填充区域范围中心点的垂直偏移百分比。
FillMode3D	getFillMode() 返回三维几何体对象的填充模式。
int	getFillSymbolID() 返回三维场景中的面几何对象的填充符号的编号。
java.awt.Color	getLineColor() 返回三维场景中的线几何对象或面几何对象轮廓线的线符号的颜色。
int	getLineSymbolID() 返回三维场景中的线几何对象的线符号的编号。
double	getLineWidth() 返回三维场景中的线几何对象或面几何对象轮廓线的线符号的宽度。
double	getMarker3DRotateX() 返回三维模型符号绕 X 轴的旋转角度。
double	getMarker3DRotateY() 返回三维模型符号绕 Y 轴的旋转角度。
double	getMarker3DRotateZ() 返回三维模型符号绕 Z 轴的旋转角度。
double	getMarker3DScaleX() 返回三维模型符号 X 轴方向的缩放比例。
double	getMarker3DScaleY() 返回三维模型符号 Y 轴方向的缩放比例。
double	getMarker3DScaleZ() 返回三维模型符号 Z 轴方向的缩放比例。
Point2D	getMarkerAnchorPoint() 返回地标的锚点，锚点的位置取决于锚点所用图片，如果锚点放在图片的左下角，则为(0, 0)点，如果锚点放在图片的右上角，则为(1, 1)点，其他位置则两个分量的范围在0-1之间。
MarkerBillboardMode	getMarkerBillboardMode() 返回三维场景中的点几何对象的布告板模式。
java.awt.Color	getMarkerColor() 返回三维场景中的点几何对象所设置的点符号的颜色。
java.lang.String	getMarkerFile() 返回三维场景中的点几何对象的图标文件的全路径，即使用该图标实现符号化表示三维场景中的点几何对象。
double	getMarkerScale() 返回三维场景中的点几何对象的图标文件的缩放比率。
double	getMarkerSize() 返回三维场景中的点几何对象所设置的点符号的大小，单位为像素。
int	getMarkerSymbolID() 返回三维场景中的点几何对象的点符号的编号。
java.lang.String[]	getSideTextureFiles() 返回用于侧面纹理渲染的一系列图片文件的全路径。
TextureRepeatMode	getTextureRepeatMode() 返回侧面纹理重复模式。
double	getTilingU() 返回侧面纹理横向重复字段。
double	getTilingV() 返回侧面纹理纵向重复字段。
java.lang.String	getTopTextureFile() 返回顶部纹理文件全路径，该方法中存储的是由分号隔开的纹理图片文件全路径。
TextureRepeatMode	getTopTextureRepeatMode() 返回顶部纹理重复模式。
double	getTopTilingU() 返回顶面纹理横向重复字段。
double	getTopTilingV() 返回顶面纹理纵向重复字段。
int	getTubeSides() 返回定义符号时所使用的面片数目。
boolean	isFiletEnabled() 返回是否使用倒角方式处理管道拐点处。
boolean	isMarker3D() 返回三维场景中的点几何对象是否使用三维模型符号。
boolean	isMarkerSizeFixed() 返回三维模型符号是否固定物理大小。
void	setAltitudeMode(AltitudeMode altitudeMode) 设置三维场景中的几何对象的高度模式。
void	setAnchorOffsetMode(AnchorOffsetMode mode) 设置标签专题图文字偏移模式。
void	setBottomAltitude(double value) 设置底部高程值。
void	setExtendedHeight(double value) 设置拉伸高度值。
void	setFiletEnabled(boolean value) 设置是否使用倒角方式处理管道拐点处。
void	setFillBackColor(java.awt.Color value) 设置三维场景中的面几何对象的填充符号的背景色。
void	setFillForeColor(java.awt.Color color) 设置三维场景中的面几何对象的填充符号的前景色。
void	setFillGradientAngle(double value) 渐变填充的旋转角度，以度为单位，精确到0.1度，逆时针方向为正方向。
void	setFillGradientMode(FillGradientMode fillGradientMode) 设置渐变填充风格的渐变类型。
void	setFillGradientOffsetRatioX(int value) 设置渐变填充中心点相对于填充区域范围中心点的水平偏移百分比。
void	setFillGradientOffsetRatioY(int value) 设置填充中心点相对于填充区域范围中心点的垂直偏移百分比。
void	setFillMode(FillMode3D fill3DMode) 设置三维几何体对象的填充模式。
void	setFillSymbolID(int value) 设置三维场景中的面几何对象的填充符号的编号。
void	setLineColor(java.awt.Color color) 设置三维场景中的线几何对象或面几何对象轮廓线的线符号的颜色。
void	setLineSymbolID(int value) 设置线状符号的编码。
void	setLineWidth(double value) 设置三维场景中的线几何对象或面几何对象轮廓线的线符号的宽度。
void	setMarker3D(boolean value) 设置三维场景中的点几何对象是否使用三维模型符号。
void	setMarker3DRotateX(double value) 设置三维模型符号绕 X 轴的旋转角度。
void	setMarker3DRotateY(double value) 设置三维模型符号绕 Y 轴的旋转角度。
void	setMarker3DRotateZ(double value) 设置三维模型符号绕 Z 轴的旋转角度。
void	setMarker3DScaleX(double value) 设置三维模型符号 X 轴方向的缩放比例。
void	setMarker3DScaleY(double value) 设置三维模型符号 Y 轴方向的缩放比例。
void	setMarker3DScaleZ(double value) 设置三维模型符号 Z 轴方向的缩放比例。
void	setMarkerAnchorPoint(Point2D point2D) 设置地标的锚点，锚点的位置取决于锚点所用图片，如果锚点放在图片的左下角，则为(0, 0)点，如果锚点放在图片的右上角，则为(1, 1)点，其他位置则两个分量的范围在0-1之间。
void	setMarkerBillboardMode(MarkerBillboardMode markerBillboardMode) 设置三维场景中的点几何对象的布告板模式。
void	setMarkerColor(java.awt.Color color) 设置三维场景中的点几何对象所设置的点符号的颜色。
void	setMarkerFile(java.lang.String value) 设置三维场景中的点几何对象的图标文件的全路径，即使用该图标实现符号化表示三维场景中的点几何对象。
void	setMarkerScale(double value) 设置三维场景中的点几何对象的图标文件的缩放比率，仅当将三维场景中的点几何对象的风格设置为图标文件时调用该方法才起作用。
void	setMarkerSize(double value) 设置三维场景中的点几何对象所设置的点符号的大小，单位为像素。
void	setMarkerSizeFixed(boolean value) 设置三维模型符号是否固定物理大小。
void	setMarkerSymbolID(int value) 设置三维场景中的点几何对象的点符号的编号。
void	setSideTextureFiles(java.lang.String[] value) 设置用于侧面纹理渲染的一系列图片文件的全路径。
void	setTextureRepeatMode(TextureRepeatMode textureRepeatMode) 设置侧面纹理重复模式。
void	setTilingU(double value) 设置侧面纹理横向重复字段。
void	setTilingV(double value) 设置侧面纹理纵向重复字段。
void	setTopTextureFile(java.lang.String value) 设置顶部纹理文件全路径，该方法中设置的是由分号隔开的纹理图片文件全路径。
void	setTopTextureRepeatMode(TextureRepeatMode textureRepeatMode) 设置顶部纹理重复模式。
void	setTopTilingU(double value) 设置顶面纹理横向重复字段。
void	setTopTilingV(double value) 设置顶面纹理纵向重复字段。
void	setTubeSides(int value) 设置定义符号时所使用的面片数目。
java.lang.String	toString() 返回一个表示此三维场景中的几何对象风格类对象的格式化字符串。
java.lang.String	toXML() 返回表示 GeoStyle3D 对象的 XML 字符串。

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

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

构造方法详细信息

GeoStyle3D

public GeoStyle3D()

构造一个新的 GeoStyle3D 对象。

GeoStyle3D

public GeoStyle3D(GeoStyle3D style3D)

根据给定的 GeoStyle3D 对象构造一个与其完全相同的新对象。

参数：

style3D - 给定的 GeoStyle3D 对象。

方法详细信息

clone

public GeoStyle3D clone()

返回当前 GeoStyle3D 对象的一个拷贝。

覆盖：

类 java.lang.Object 中的 clone

返回：

通过克隆操作得到的 GeoStyle3D 对象。

toString

public java.lang.String toString()

返回一个表示此三维场景中的几何对象风格类对象的格式化字符串。

覆盖：

类 java.lang.Object 中的 toString

返回：

一个表示此三维场景中的几何对象风格类对象的格式化字符串。

toXML

public java.lang.String toXML()

返回表示 GeoStyle3D 对象的 XML 字符串。

返回：

表示 GeoStyle3D 对象的 XML 字符串。

fromXML

public boolean fromXML(java.lang.String xml)

根据传入的 XML 字符串重新构造该 GeoStyle3D 对象。

参数：

xml - 指定的 XML 字符串。

返回：

如果构建成功返回 true，否则返回 false。

getAltitudeMode

public AltitudeMode getAltitudeMode()

返回三维场景中的几何对象的高度模式。详细信息请参见 AltitudeMode 类。

返回：

三维几何对象的高度模式。

默认值:

默认值为 CLAMP_TO_GROUND。

setAltitudeMode

public void setAltitudeMode(AltitudeMode altitudeMode)

设置三维场景中的几何对象的高度模式。详细信息请参见 AltitudeMode 类。

参数：

altitudeMode - 三维几何对象的高度模式。

getBottomAltitude

public double getBottomAltitude()

返回底部高程值。

底部高程为三维场景中的几何对象底部到基准面的垂直高度，若对三维场景中的几何对象设置了拉伸高度，底部高程为拉伸线或拉伸面底部到基准面的垂直高度。

当在三维场景中显示二维几何对象时，利用对象原有的坐标信息，将对象显示在相应的坐标处，同时， 还可以使用该方法返回的底部高程值将相应的对象显示在对应的高度上，也就是该方法的返回值提供了对象的高程信息。

返回：

底部高程值。单位为米。

默认值:

默认值为 0，单位为米。

setBottomAltitude

public void setBottomAltitude(double value)

设置底部高程值。

底部高程为三维场景中的几何对象底部到基准面的垂直高度，若对三维场景中的几何对象设置了拉伸高度，底部高程为拉伸线或拉伸面底部到基准面的垂直高度。

当在三维场景中显示二维几何对象时，利用对象原有的坐标信息，将对象显示在相应的坐标处，同时， 还可以使用该方法返回的底部高程值将相应的对象显示在对应的高度上，也就是该方法的返回值提供了对象的高程信息。

在地表层高度模式下（CLAMP_TO_GROUND），调用该方法对三维场景中的几何对象设置底部高程值不起作用。

参数：

value - 底部高程值。单位为米。

getExtendedHeight

public double getExtendedHeight()

返回拉伸高度值。

返回：

拉伸高度值。单位为米。

默认值:

默认值为 0，单位为米。

setExtendedHeight

public void setExtendedHeight(double value)

设置拉伸高度值。

在地表层高度模式下（CLAMP_TO_GROUND），调用该方法对三维场景中的几何对象设置拉伸高度不起作用。

可对点几何对象（GeoPoint 和 GeoPoint3D）、线几何对象（GeoLine 和 GeoLine3D）、面几何对象（GeoRegion 和 GeoRegion3D）以及文本几何对象（GeoText 和 GeoText3D）设置拉伸高度。

对于点几何对象，对其设置拉伸高度后，在该点的垂直高度上形成拉伸线，如下图所示，白色实线为拉伸线，拉伸线的长度为拉伸高度。

对于线几何对象，对其设置拉伸高度后，会以线对象本身为长、以拉伸高度为宽，形成矩形区域，下图黄色线为三维线几何对象本身，蓝色面域的高为拉伸高度。

对于面几何对象，对其设置拉伸高度后，会以面几何对象的轮廓线为长、以拉伸高度为宽，形成拉伸面。

对于文本几何对象，对其设置拉伸高度后，在文本的锚点的垂直高度上形成拉伸线，如下图所示。

注意：对三维场景中的几何对象设置三维符号（三维模型符号和三维线符号）时，调用该方法设置拉伸高度无效。

参数：

value - 拉伸高度值。单位为米。

getMarkerSymbolID

public int getMarkerSymbolID()

返回三维场景中的点几何对象的点符号的编号。此编号用于唯一标识各点符号。

点状符号可以用户自定义，也可以使用系统自带的点符号库中的点符号。

返回：

三维场景中的点几何对象的点符号的编号。

默认值:

默认值为 0。

setMarkerSymbolID

public void setMarkerSymbolID(int value)

设置三维场景中的点几何对象的点符号的编号。此编号用于唯一标识各点符号。

点状符号可以用户自定义，也可以使用系统自带的点符号库中的点符号。

参数：

value - 三维场景中的点几何对象的点符号的编号。

getMarkerColor

public java.awt.Color getMarkerColor()

返回三维场景中的点几何对象所设置的点符号的颜色。

返回：

三维场景中的点几何对象所设置的点符号的颜色。

默认值:

默认值为 Color[A = 255, R = 255, G = 255, B = 255]。

setMarkerColor

public void setMarkerColor(java.awt.Color color)

设置三维场景中的点几何对象所设置的点符号的颜色。

对三维场景中的点几何对象可设置二维矢量点符号、二维栅格点符号和三维模型符号，对于三维模型符号调用该方法所设的颜色不起作用。

参数：

color - 所要设置的三维场景中的点几何对象所设置的点符号的颜色。

getMarkerSize

public double getMarkerSize()

返回三维场景中的点几何对象所设置的点符号的大小，单位为像素。

返回：

三维场景中的点几何对象所设置的点符号的大小。单位为像素。

默认值:

默认值为 4，单位为像素。

setMarkerSize

public void setMarkerSize(double value)

设置三维场景中的点几何对象所设置的点符号的大小，单位为像素。

当将三维场景中的点几何对象的符号设置为二维矢量或栅格符号时，可使用该方法设置符号的大小；

当将三维场景中的点几何对象的符号设置为三维模型符号或图标文件时，调用该方法设置点符号的大小不起作用， 其中三维模型符号的大小通过 setMarker3DScaleX()、 setMarker3DScaleY()、setMarker3DScaleZ() 三个方法控制；图标文件的大小通过 setMarkerScale() 方法控制。

参数：

value - 所要设置的三维场景中的点几何对象所设置的点符号的大小。单位为像素。

getMarkerFile

public java.lang.String getMarkerFile()

返回三维场景中的点几何对象的图标文件的全路径，即使用该图标实现符号化表示三维场景中的点几何对象。支持 bmp, png, jpg, jpeg, gif 格式的图片文件和 3ds 和 sgm 格式的模型文件。

返回：

三维场景中的点几何对象的图标文件的全路径

默认值:

默认值为一个空字符串。

setMarkerFile

public void setMarkerFile(java.lang.String value)

设置三维场景中的点几何对象的图标文件的全路径，即使用该图标实现符号化表示三维场景中的点几何对象。

参数：

value - 三维符号图标的文件全路径。

getMarkerScale

public double getMarkerScale()

返回三维场景中的点几何对象的图标文件的缩放比率。

返回：

三维场景中的点几何对象的图标文件的缩放比率。

默认值:

默认值为 1.0。

setMarkerScale

public void setMarkerScale(double value)

设置三维场景中的点几何对象的图标文件的缩放比率，仅当将三维场景中的点几何对象的风格设置为图标文件时调用该方法才起作用。

参数：

value - 三维场景中的点几何对象的图标文件的缩放比率。

getMarker3DScaleX

public double getMarker3DScaleX()

返回三维模型符号 X 轴方向的缩放比例。

返回：

三维模型符号 X 轴方向的缩放比例。

默认值:

默认值为 1.0。

setMarker3DScaleX

public void setMarker3DScaleX(double value)

设置三维模型符号 X 轴方向的缩放比例。

参数：

value - 三维模型符号 X 轴方向的缩放比例。

getMarker3DScaleY

public double getMarker3DScaleY()

返回三维模型符号 Y 轴方向的缩放比例。

返回：

三维模型符号 Y 轴方向的缩放比例。

默认值:

默认值为 1.0。

setMarker3DScaleY

public void setMarker3DScaleY(double value)

设置三维模型符号 Y 轴方向的缩放比例。

参数：

value - 三维模型符号 Y 轴方向的缩放比例。

getMarker3DScaleZ

public double getMarker3DScaleZ()

返回三维模型符号 Z 轴方向的缩放比例。

返回：

三维模型符号 Z 轴方向的缩放比例。

默认值:

默认值为 1.0。

setMarker3DScaleZ

public void setMarker3DScaleZ(double value)

设置三维模型符号 Z 轴方向的缩放比例。

参数：

value - 三维三维模型符号 X 轴方向的缩放比例。

getMarker3DRotateX

public double getMarker3DRotateX()

返回三维模型符号绕 X 轴的旋转角度。

返回：

三维模型符号绕 X 轴的旋转角度。

默认值:

默认值为0

setMarker3DRotateX

public void setMarker3DRotateX(double value)

设置三维模型符号绕 X 轴的旋转角度。

下图中红色线为 X 轴、绿色线为 Y 轴，蓝色线为 Z 轴，图中展示了飞机模型绕 X 轴旋转 40 度的效果。

参数：

value - 三维模型符号绕 X 轴的旋转角度。

getMarker3DRotateY

public double getMarker3DRotateY()

返回三维模型符号绕 Y 轴的旋转角度。

返回：

三维模型符号绕 Y 轴的旋转角度。

默认值:

默认值为 0。

setMarker3DRotateY

public void setMarker3DRotateY(double value)

设置三维模型符号绕 Y 轴的旋转角度。

下图中红色线为 X 轴、绿色线为 Y 轴，蓝色线为 Z 轴，图中展示了飞机模型绕 Y 轴旋转 40 度的效果。

参数：

value - 三维模型符号绕 Y 轴的旋转角度。

getMarker3DRotateZ

public double getMarker3DRotateZ()

返回三维模型符号绕 Z 轴的旋转角度。

返回：

三维模型符号绕 Z 轴的旋转角度。

默认值:

默认值为0。

setMarker3DRotateZ

public void setMarker3DRotateZ(double value)

设置三维模型符号绕 Z 轴的旋转角度。

下图中红色线为 X 轴、绿色线为 Y 轴，蓝色线为 Z 轴，图中展示了飞机模型绕 Z 轴旋转 40 度的效果。

参数：

value - 三维模型符号绕 Z 轴的旋转角度。

isMarker3D

public boolean isMarker3D()

返回三维场景中的点几何对象是否使用三维模型符号。

返回：

一个布尔值，表示三维场景中的点几何对象是否使用三维模型符号。true 表示使用三维模型符号，false 表示不使用三维模型符号。

默认值:

默认值为false，表示不使用三维点符号。

setMarker3D

public void setMarker3D(boolean value)

设置三维场景中的点几何对象是否使用三维模型符号。

参数：

value - 三维场景中的点几何对象是否使用三维模型符号。

getMarkerBillboardMode

public MarkerBillboardMode getMarkerBillboardMode()

返回三维场景中的点几何对象的布告板模式。点布告板模式可参见 MarkerBillboardMode 类。

返回：

地标布告板的模式。

默认值:

默认值为 NONE。

setMarkerBillboardMode

public void setMarkerBillboardMode(MarkerBillboardMode markerBillboardMode)

设置三维场景中的点几何对象的布告板模式。当使用图标文件和模型文件设置点几何对象时调用该方法设置有效，使用点符号的点几何对象调用该方法设置风格无效。点布告板模式可参见 MarkerBillboardMode 类。

参数：

markerBillboardMode - 三维场景中的点几何对象的布告板模式。

isMarkerSizeFixed

public boolean isMarkerSizeFixed()

返回三维模型符号是否固定物理大小。

返回：

一个布尔值，表示符号是否固定三维模型符号的物理大小。true表示三维模型符号固定物理大小；false表示三维模型符号不固定物理大小。

setMarkerSizeFixed

public void setMarkerSizeFixed(boolean value)

设置三维模型符号是否固定物理大小。

设置为 true 时，表示固定模型符号的物理大小，此时模型符号在场景中会随着场景的缩放而缩放，表现为像素大小变化。

下图为固定模型符号物理大小的效果图，左图相机高度在170.72m，缩小场景后，相机高度在1.31km。

设置为 false 时，表示不固定模型符号的物理大小，此时符号的像素大小保持不变，即场景的缩放对符号的显示没有影响，而模型符号的物理大小变化。

下图为不固定模型符号物理大小的效果图，左图相机高度在1724.20km，缩小场景后，相机高度在8300.42km。

参数：

value - 三维模型符号是否固定物理大小。

dispose

public void dispose()

释放该对象所占用的资源。当调用该方法之后，此对象不再可用。

getMarkerAnchorPoint

public Point2D getMarkerAnchorPoint()

返回地标的锚点，锚点的位置取决于锚点所用图片，如果锚点放在图片的左下角，则为(0, 0)点，如果锚点放在图片的右上角，则为(1, 1)点，其他位置则两个分量的范围在0-1之间。

返回：

地标的锚点，锚点的位置取决于锚点所用图片。

setMarkerAnchorPoint

public void setMarkerAnchorPoint(Point2D point2D)

设置地标的锚点，锚点的位置取决于锚点所用图片，如果锚点放在图片的左下角，则为(0, 0)点，如果锚点放在图片的右上角，则为(1, 1)点，其他位置则两个分量的范围在0-1之间。

参数：

point2D - 地标的锚点，锚点的位置取决于锚点所用图片。

getLineSymbolID

public int getLineSymbolID()

返回三维场景中的线几何对象的线符号的编号。此编号用于唯一标识各线状符号。

线符号可以用户自定义，也可以使用系统自带的符号库。

返回：

三维场景中的线几何对象的线符号的编号。

默认值:

默认值为0。

setLineSymbolID

public void setLineSymbolID(int value)

设置线状符号的编码。此编码用于唯一标识各线状符号。

线符号可以用户自定义，也可以使用系统自带的符号库。

对三维场景中的线几何对象可设置的线符号包括二维线符号和三维线符号两种，使用该方法有以下两点注意：

1.对在三维场景中显示的二维线几何对象或二维面几何对象的轮廓线，设置三维线符号无效。

2.在非地表高度模式下，对三维场景中的线几何对象或二维面几何对象的轮廓线设置二维线符号无效，在场景中显示时仍然使用编号为0的线符号。

参数：

value - 一个用来设置三维场景中的线几何对象的线符号的编号的整数值。

getLineColor

public java.awt.Color getLineColor()

返回三维场景中的线几何对象或面几何对象轮廓线的线符号的颜色。

返回：

三维场景中的线几何对象或面几何对象轮廓线的线符号的颜色。

默认值:

默认值为 Color[A=255, R=255, G=255, B=0]。

setLineColor

public void setLineColor(java.awt.Color color)

设置三维场景中的线几何对象或面几何对象轮廓线的线符号的颜色。

若调用 setExtendedHeight() 方法对三维场景中的几何对象设置拉伸高度，则调用该方法设置的线符号颜色会影响拉伸线和拉伸面的轮廓线。

若三维线几何对象使用三维线符号时，建议使用默认值，即不使用该方法设置三维线符号的颜色，在三维场景中显示效果好。

参数：

color - 三维场景中的线几何对象或面几何对象轮廓线的线符号的颜色。

getLineWidth

public double getLineWidth()

返回三维场景中的线几何对象或面几何对象轮廓线的线符号的宽度。对于二维线符号，单位为像素；三维线符号，单位为米。

返回：

三维场景中的线几何对象或面几何对象轮廓线的线符号的宽度。

默认值:

默认值为 1。对于二维线符号，单位为像素；三维线符号，单位为米。

setLineWidth

public void setLineWidth(double value)

设置三维场景中的线几何对象或面几何对象轮廓线的线符号的宽度。对于二维线符号，单位为像素；三维线符号，单位为米。

如果调用 setExtendedHeight() 方法对三维场景中的几何对象设置拉伸高度，则调用该方法设置的值会影响拉伸线和拉伸面的轮廓线的线宽。

参数：

value - 三维场景中的线几何对象或面几何对象轮廓线的线符号的宽度。

getFillSymbolID

public int getFillSymbolID()

返回三维场景中的面几何对象的填充符号的编号。此编号用于唯一标识各普通填充风格的填充符号。

填充符号可以用户自定义，也可以使用系统自带的符号库。

返回：

三维场景中的面几何对象的填充符号的编码。

默认值:

默认值为 0。

setFillSymbolID

public void setFillSymbolID(int value)

设置三维场景中的面几何对象的填充符号的编号。此编号用于唯一标识各普通填充风格的填充符号。

填充符号可以用户自定义，也可以使用系统自带的符号库。

在非地表高度模式下，对三维场景中的面几何对象或拉伸面设置填充符号无效，在场景中显示时仍然使用编号为0的填充符号。

参数：

value - 一个整数用来设置三维场景中的面几何对象的填充符号的编码。

getFillForeColor

public java.awt.Color getFillForeColor()

返回三维场景中的面几何对象的填充符号的前景色。

返回：

三维场景中的面几何对象的填充符号的前景色。

默认值:

默认值为 Color[A=255, R=255, G=255, B=255]。

setFillForeColor

public void setFillForeColor(java.awt.Color color)

设置三维场景中的面几何对象的填充符号的前景色。

通过 setExtendedHeight() 方法对三维场景中的线、面几何对象设置拉伸高度，调用该方法所设置的值会影响面几何对象和拉伸面的颜色。

参数：

color - 三维场景中的面几何对象的填充符号的前景色。

getFillBackColor

public java.awt.Color getFillBackColor()

返回三维场景中的面几何对象的填充符号的背景色。当填充模式为渐变填充时，该颜色为填充终止色。

返回：

Color对象，表示三维场景中的面几何对象的填充符号的背景色。

默认值:

默认值为 Color[A=255, R=255, G=255, B=255]。

setFillBackColor

public void setFillBackColor(java.awt.Color value)

设置三维场景中的面几何对象的填充符号的背景色。当填充模式为渐变填充时，该颜色为渐变填充终止色。

仅当三维场景中的面几何对象的高度模式设置为地表高度模式（CLAMP_TO_GROUND）时，通过该方法所设置的颜色值对填充符号才起作用。

参数：

value - Color对象，一个颜色值。

setFillGradientAngle

public void setFillGradientAngle(double value)

渐变填充的旋转角度，以度为单位，精确到0.1度，逆时针方向为正方向。有关各渐变填充风格类型的定义，请参见 FillGradientMode。

仅当三维场景中的面几何对象的高度模式设置为地表高度模式（CLAMP_TO_GROUND）时，通过该方法所设置的值对填充符号才起作用。

对于不同的渐变填充，其旋转的后的效果各异，但都是以最小外接矩形的中心为旋转中心，逆时针旋转的。具体请参见 getFillGradientAngle() 方法。

参数：

value - 用来设置渐变填充的旋转角度。单位为度。

getFillGradientAngle

public double getFillGradientAngle()

渐变填充的旋转角度，以度为单位，精确到0.1度，逆时针方向为正方向。有关各渐变填充风格类型的定义，请参见 FillGradientMode。

对于不同的渐变填充，其旋转的后的效果各异，但都是以最小外接矩形的中心为旋转中心，逆时针旋转的:

线性渐变

当设置的角度为0-360度的任意角度时，经过起始点和终止点的线以最小外接矩形的中心为旋转中心逆时针旋转，渐变风格随之旋转， 依然从线的起始端渐变到终止端的线性渐变。如下列举在特殊角度的渐变风格：

1. 当渐变填充角度设置为0度或者360度的时候，那么渐变填充风格为由左到右从起始色到终止色的线性渐变，如图所示起始色为黄色，终止色为粉红色；

   

2. 当渐变填充角度设置为180度时，渐变填充风格与1中描述的风格正好相反，即从右到左，从起始色到终止色线性渐变；

   

3. 当渐变填充角度设置为90度时，渐变填充风格为由下到上，起始色到终止色的线性渐变;

   

4. 当渐变填充角度设置为270度时，渐变填充风格与3中描述的风格正好相反，即从上到下，起始色到终止色线性渐变。

   

辐射渐变

渐变填充角度设置为任何角度（不超出正常范围）时，将定义辐射渐变的圆形按照设置的角度进行旋转，由于圆是关于填充范围的最小外接矩形的中心点对称的， 所以旋转之后的渐变填充的风格始终保持一样，即从中心点到填充范围的边界，从前景色到背景色的辐射渐变。

圆锥渐变

当渐变角度设置为0-360度之间的任何角度，该圆锥的所有母线将发生旋转，以圆锥的中心点，即填充区域的最小外接矩形的中心为旋转中心，逆时针方向旋转。 如图所示的例子中 ，旋转角度为90度，所有的母线都从起始位置（旋转角度为零的位置）开始旋转到指定角度，以经过起始点的母线为例，其从0度位置旋转到90度位置。

四角渐变

根据给定的渐变填充角度，将发生渐变的正方形以填充区域范围的中心为中心进行相应的旋转，所有正方形都是从初始位置即旋转角度为零的默认位置开始旋转。 渐变依然是从内部的正方形到外部的正方形发生从起始色到终止色的渐变。

返回：

渐变填充的旋转角度。

默认值:

默认值为 0。单位为度。

setFillGradientOffsetRatioX

public void setFillGradientOffsetRatioX(int value)

设置渐变填充中心点相对于填充区域范围中心点的水平偏移百分比。设填充区域范围中心点的坐标为（x0,y0），填充中心点的坐标为（x，y）， 填充区域范围的宽度为 a，水平偏移百分比为 dx，则

x=x0 + a*dx/100

该百分比可以为负，当其为负时，填充中心点相对于填充区域范围中心点向 x 轴负方向偏移。该方法对辐射渐变、圆锥渐变、四角渐变和线性渐变填充有效。

仅当三维场景中的面几何对象的高度模式设置为地表高度模式（CLAMP_TO_GROUND）时，通过该方法所设置的值对填充符号才起作用。

参数：

value - 用于设置填充中心点的水平偏移量的值。

getFillGradientOffsetRatioX

public int getFillGradientOffsetRatioX()

返回渐变填充中心点相对于填充区域范围中心点的水平偏移百分比。设填充区域范围中心点的坐标为（x0,y0），填充中心点的坐标为（x，y）， 填充区域范围的宽度为 a，水平偏移百分比为 dx，则

x=x0 + a*dx/100 该百分比可以为负，当其为负时，填充中心点相对于填充区域范围中心点向 x 轴负方向偏移。该方法对辐射渐变、圆锥渐变、四角渐变和线性渐变填充有效。

返回：

填充中心点相对于填充区域范围中心点的水平偏移百分比。

默认值:

默认值为 0。

setFillGradientOffsetRatioY

public void setFillGradientOffsetRatioY(int value)

设置填充中心点相对于填充区域范围中心点的垂直偏移百分比。设填充区域范围中心点的坐标为（x0,y0），填充中心点的坐标为（x，y）， 填充区域范围的高度为 b，垂直偏移百分比为 dy，则

y=y0 + b*dy/100

该百分比可以为负，当其为负时，填充中心点相对于填充区域范围中心点向 y 轴负方向偏移。该方法对辐射渐变、圆锥渐变、四角渐变和线性渐变填充有效。

仅当三维场景中的面几何对象的高度模式设置为地表高度模式（CLAMP_TO_GROUND）时，通过该方法所设置的值对填充符号才起作用。

参数：

value - 用来设置填充中心点的垂直偏移量的值。

getFillGradientOffsetRatioY

public int getFillGradientOffsetRatioY()

返回填充中心点相对于填充区域范围中心点的垂直偏移百分比。设填充区域范围中心点的坐标为（x0,y0），填充中心点的坐标为（x，y）， 填充区域范围的高度为 b，垂直偏移百分比为 dy，则

y=y0 + b*dy/100

该百分比可以为负，当其为负时，填充中心点相对于填充区域范围中心点向 y 轴负方向偏移。该方法对辐射渐变、圆锥渐变、四角渐变和线性渐变填充有效。

返回：

填充中心点的垂直偏移量。

默认值:

默认值为 0。

setFillGradientMode

public void setFillGradientMode(FillGradientMode fillGradientMode)

设置渐变填充风格的渐变类型。关于各渐变填充类型的定义，请参见 FillGradientMode。

仅当三维场景中的面几何对象的高度模式设置为地表高度模式（CLAMP_TO_GROUND）时，通过该方法所设置的值对填充符号才起作用。

参数：

fillGradientMode - 指定渐变填充风格的渐变类型。

另请参见：

FillGradientMode

getFillGradientMode

public FillGradientMode getFillGradientMode()

返回渐变填充风格的渐变类型。关于各渐变填充类型的定义，请参见 FillGradientMode。

返回：

渐变填充风格的渐变类型。

另请参见：

FillGradientMode

默认值:

默认值为 NONE 类型。

getFillMode

public FillMode3D getFillMode()

返回三维几何体对象的填充模式。三维几何体对象的填充模式分为轮廓填充，区域填充，轮廓和区域填充，详细信息请参见 FillMode3D 类。

返回：

三维几何体对象的填充模式。

默认值:

默认值为 LINE_AND_FILL。

setFillMode

public void setFillMode(FillMode3D fill3DMode)

设置三维几何体对象的填充模式。三维几何体对象的填充模式分为轮廓填充，区域填充，轮廓和区域填充，详细信息请参见 FillMode3D 类。

参数：

fill3DMode - 三维几何体对象的填充模式。

getSideTextureFiles

public java.lang.String[] getSideTextureFiles()

返回用于侧面纹理渲染的一系列图片文件的全路径。对三维线、面几何对象设置拉伸高度时，会形成拉伸面，拉伸面就是侧面。 三维体对象的侧面将使用该方法返回的图片进行纹理渲染。

返回：

侧面纹理文件的全路径。

默认值:

默认值为一个空的字符串。

setSideTextureFiles

public void setSideTextureFiles(java.lang.String[] value)

设置用于侧面纹理渲染的一系列图片文件的全路径。对三维线、面几何对象设置拉伸高度时，会形成拉伸面，拉伸面就是侧面。 三维体对象的侧面将使用该方法指示的图片进行纹理渲染。

将三维线、面几何对象的高度模式设置为非地表高度模式时，对其拉伸面设置侧面贴图才起作用。

例如：形成了9个拉伸面，如果设置9张侧面贴图，则每个面一张贴图；设置8张侧面贴图，则前7个面分别各用一张贴图，最后两个面共用一张贴图； 设置7张侧面贴图，前6个拉伸面各用一张贴图，后三个面共用一张贴图；依次类推。

参数：

value - 侧面纹理文件的全路径。

getTilingU

public double getTilingU()

返回侧面纹理横向重复字段。

该字段代表侧面纹理横向重复次数或重复尺寸，当 TextureRepeatMode 设置为 REPEATTIMES （按次数重复模式）时，该字段表示用户指定的纹理重复次数；当 TextureRepeatMode 设置为 REALSIZE （按尺寸重复模式）时，该字段表示用户指定的纹理贴图单次重复所占的尺寸。

注意:该方法的返回值类型是 double，即允许是小数。

返回：

侧面纹理横向重复字段。

默认值:

默认值为 1。

setTilingU

public void setTilingU(double value)

设置侧面纹理横向重复字段。

该字段代表侧面纹理横向重复次数或重复尺寸，当 TextureRepeatMode 设置为 REPEATTIMES （按次数重复模式）时，该字段表示用户指定的纹理重复次数；当 TextureRepeatMode 设置为 REALSIZE （按尺寸重复模式）时，该字段表示用户指定的纹理贴图单次重复所占的尺寸。

注意:该方法的参数类型是 double，即允许是小数。

参数：

value - 侧面纹理横向重复字段。

getTilingV

public double getTilingV()

返回侧面纹理纵向重复字段。

该字段代表侧面纹理纵向重复次数或重复尺寸，当 TextureRepeatMode 设置为 REPEATTIMES （按次数重复模式）时，该字段表示用户指定的纹理重复次数；当 TextureRepeatMode 设置为 REALSIZE （按尺寸重复模式）时，该字段表示用户指定的纹理贴图单次重复所占的尺寸。

注意:该方法的返回值类型是 double，即允许是小数。

图1 侧面纹理纵向按次数重复模式示意图。

图2 侧面纹理纵向按尺寸重复模式示意图（ 模型侧面高度为100米，按照50米进行重复）

返回：

侧面纹理纵向重复字段。

默认值:

默认值为 1。

setTilingV

public void setTilingV(double value)

设置侧面纹理纵向重复字段。

该字段代表侧面纹理纵向重复次数或重复尺寸，当 TextureRepeatMode 设置为 REPEATTIMES （按次数重复模式）时，该字段表示用户指定的纹理重复次数；当 TextureRepeatMode 设置为 REALSIZE （按尺寸重复模式）时，该字段表示用户指定的纹理贴图单次重复所占的尺寸。

注意:该方法的参数类型是 double，即允许是小数。

图1 侧面纹理纵向按次数重复模式示意图。

图2 侧面纹理纵向按尺寸重复模式示意图（ 模型侧面高度为100米，按照50米进行重复）

参数：

value - 侧面纹理纵向重复字段。

getTopTextureFile

public java.lang.String getTopTextureFile()

返回顶部纹理文件全路径，该方法中存储的是由分号隔开的纹理图片文件全路径。三维体对象的顶部将使用该方法所指示的图片进行纹理渲染。

返回：

顶部纹理文件全路径。

默认值:

默认值为一个空的字符串。

setTopTextureFile

public void setTopTextureFile(java.lang.String value)

设置顶部纹理文件全路径，该方法中设置的是由分号隔开的纹理图片文件全路径。三维体对象的顶部将使用该方法所指示的图片进行纹理渲染。

参数：

value - 顶部纹理文件全路径。

getTopTilingV

public double getTopTilingV()

返回顶面纹理纵向重复字段。

该字段代表顶面纹理纵向重复次数或重复尺寸，当 TextureRepeatMode 设置为 REPEATTIMES （按次数重复模式）时，该字段表示用户指定的纹理重复次数；当 TextureRepeatMode 设置为 REALSIZE （按尺寸重复模式）时，该字段表示用户指定的纹理贴图单次重复所占的尺寸。

注意:该方法的返回值类型是 double，即允许是小数。

返回：

顶面纹理纵向重复字段。

默认值:

默认值为 1。

setTopTilingV

public void setTopTilingV(double value)

设置顶面纹理纵向重复字段。

该字段代表顶面纹理纵向重复次数或重复尺寸，当 TextureRepeatMode 设置为 REPEATTIMES （按次数重复模式）时，该字段表示用户指定的纹理重复次数；当 TextureRepeatMode 设置为 REALSIZE （按尺寸重复模式）时，该字段表示用户指定的纹理贴图单次重复所占的尺寸。

注意:该方法的参数类型是 double，即允许是小数。

参数：

value - 顶面纹理纵向重复字段。

getTopTilingU

public double getTopTilingU()

返回顶面纹理横向重复字段。

该字段代表顶面纹理横向重复次数或重复尺寸，当 TextureRepeatMode 设置为 REPEATTIMES （按次数重复模式）时，该字段表示用户指定的纹理重复次数；当 TextureRepeatMode 设置为 REALSIZE （按尺寸重复模式）时，该字段表示用户指定的纹理贴图单次重复所占的尺寸。

注意:该方法的返回值类型是 double，即允许是小数。

返回：

顶面纹理横向重复字段。

默认值:

默认值为 1。

setTopTilingU

public void setTopTilingU(double value)

设置顶面纹理横向重复字段。

该字段代表顶面纹理横向重复次数或重复尺寸，当 TextureRepeatMode 设置为 REPEATTIMES （按次数重复模式）时，该字段表示用户指定的纹理重复次数；当 TextureRepeatMode 设置为 REALSIZE （按尺寸重复模式）时，该字段表示用户指定的纹理贴图单次重复所占的尺寸。

注意:该方法的参数类型是 double，即允许是小数。

参数：

value - 顶面纹理横向重复字段。

getTubeSides

public int getTubeSides()

返回定义符号时所使用的面片数目。

例如当绘制一个圆形管道时，我们可以通过设置面片数目来决定使用多少个点来组成这个圆，面片数目越大圆形管道越精细。

返回：

定义符号时所使用的面片数目。

默认值:

默认值为 32。

setTubeSides

public void setTubeSides(int value)

设置定义符号时所使用的面片数目。

例如当绘制一个圆形管道时，我们可以通过设置面片数目来决定使用多少个点来组成这个圆，面片数目越大圆形管道越精细。

参数：

value - 所要设置的面片数目。

isFiletEnabled

public boolean isFiletEnabled()

返回是否使用倒角方式处理管道拐点处。适用于带截面的线。

若为true，则程序在拐弯处插入若干个点使管道拐弯处平滑，若为false，则不使用倒角。

返回：

一个布尔值，表示是否使用倒角方式处理管道拐点处。true表示使用倒角方式处理管道拐点处；false表示不使用倒角方式处理管道拐点处。

默认值:

默认值为true，表示使用倒角方式处理管道拐点处。

setFiletEnabled

public void setFiletEnabled(boolean value)

设置是否使用倒角方式处理管道拐点处。适用于带截面的线。

若为true，则程序在拐弯处插入若干个点使管道拐弯处平滑，若为false，则不使用倒角。

参数：

value - 是否使用倒角方式处理管道拐点处。

getTopTextureRepeatMode

public TextureRepeatMode getTopTextureRepeatMode()

返回顶部纹理重复模式。

返回：

返回顶部纹理重复模式。

setTopTextureRepeatMode

public void setTopTextureRepeatMode(TextureRepeatMode textureRepeatMode)

设置顶部纹理重复模式。

参数：

textureRepeatMode - 顶部纹理重复模式。

getTextureRepeatMode

public TextureRepeatMode getTextureRepeatMode()

返回侧面纹理重复模式。

返回：

返回侧面纹理重复模式。

setTextureRepeatMode

public void setTextureRepeatMode(TextureRepeatMode textureRepeatMode)

设置侧面纹理重复模式。

参数：

textureRepeatMode - 侧面纹理重复模式。

getAnchorOffsetMode

public AnchorOffsetMode getAnchorOffsetMode()

获取标签专题图文字偏移模式。

返回：

文字偏移模式

setAnchorOffsetMode

public void setAnchorOffsetMode(AnchorOffsetMode mode)

设置标签专题图文字偏移模式。

参数：

mode - 文字偏移模式