类 GeoStyle3D
- java.lang.Object
-
- com.supermap.data.InternalHandle
-
- com.supermap.data.InternalHandleDisposable
-
- com.supermap.data.GeoStyle3D
-
- 所有已实现的接口:
- IDisposable
- 直接已知子类:
- InternalGeoStyle3D, InternalGeoStyle3D
public class GeoStyle3D extends com.supermap.data.InternalHandleDisposable三维几何对象风格类。该类主要用于设置三维几何对象的显示风格。
- 示范代码:
- 以下代码示范如何为一个三维面几何对象设置三维风格。
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 style)根据给定的 GeoStyle3D 对象构造一个与其完全相同的新对象。
-
方法概要
所有方法 实例方法 具体方法 限定符和类型 方法和说明 GeoStyle3Dclone()返回当前 GeoStyle3D 对象的一个拷贝。voiddispose()释放该对象所占用的资源。booleanfromXML(String xml)根据传入的 XML 字符串重新构造该GeoStyle3D对象。AltitudeModegetAltitudeMode()返回三维场景中的几何对象的高度模式。AnchorOffsetModegetAnchorOffsetMode()获取标签专题图文字偏移模式。doublegetBottomAltitude()返回底部高程值。doublegetExtendedHeight()返回拉伸高度值。ColorgetFillBackColor()返回三维场景中的面几何对象的填充符号的背景色。ColorgetFillForeColor()返回三维场景中的面几何对象的填充符号的前景色。doublegetFillGradientAngle()渐变填充的旋转角度,以度为单位,精确到0.1度,逆时针方向为正方向。FillGradientModegetFillGradientMode()返回渐变填充风格的渐变类型。intgetFillGradientOffsetRatioX()返回渐变填充中心点相对于填充区域范围中心点的水平偏移百分比。intgetFillGradientOffsetRatioY()返回填充中心点相对于填充区域范围中心点的垂直偏移百分比。FillMode3DgetFillMode()返回三维几何体对象的填充模式。intgetFillSymbolID()返回三维场景中的面几何对象的填充符号的编号。ColorgetLineColor()返回三维场景中的线几何对象或面几何对象轮廓线的线符号的颜色。intgetLineSymbolID()返回三维场景中的线几何对象的线符号的编号。doublegetLineWidth()返回三维场景中的线几何对象或面几何对象轮廓线的线符号的宽度。doublegetMarker3DRotateX()返回三维模型符号绕 X 轴的旋转角度。doublegetMarker3DRotateY()返回三维模型符号绕 Y 轴的旋转角度。doublegetMarker3DRotateZ()返回三维模型符号绕 Z 轴的旋转角度。doublegetMarker3DScaleX()返回三维模型符号 X 轴方向的缩放比例。doublegetMarker3DScaleY()返回三维模型符号 Y 轴方向的缩放比例。doublegetMarker3DScaleZ()返回三维模型符号 Z 轴方向的缩放比例。Point2DgetMarkerAnchorPoint()返回地标的锚点,锚点的位置取决于锚点所用图片,如果锚点放在图片的左下角,则为(0, 0)点,如果锚点放在图片的右上角,则为(1, 1)点,其他位置则两个分量的范围在0-1之间。MarkerBillboardModegetMarkerBillboardMode()返回三维场景中的点几何对象的布告板模式。ColorgetMarkerColor()返回三维场景中的点几何对象所设置的点符号的颜色。StringgetMarkerFile()返回三维场景中的点几何对象的图标文件路径,即使用该图标实现符号化表示三维场景中的点几何对象。doublegetMarkerScale()返回三维场景中的点几何对象的图标文件的缩放比率。doublegetMarkerSize()返回三维场景中的点几何对象所设置的点符号的大小,单位为像素。intgetMarkerSymbolID()返回三维场景中的点几何对象的点符号的编号。String[]getSideTextureFiles()返回用于侧面纹理渲染的一系列图片文件路径。TextureRepeatModegetTextureRepeatMode()返回侧面纹理重复模式。doublegetTilingU()返回侧面纹理横向重复字段。doublegetTilingV()返回侧面纹理纵向重复字段。StringgetTopTextureFile()返回顶部纹理文件路径,该方法中存储的是由分号隔开的纹理图片文件路径。TextureRepeatModegetTopTextureRepeatMode()返回顶部纹理重复模式。doublegetTopTilingU()返回顶面纹理横向重复字段。doublegetTopTilingV()返回顶面纹理纵向重复字段。intgetTubeSides()返回定义符号时所使用的面片数目。booleanisFiletEnabled()返回是否使用倒角方式处理管道拐点处。booleanisMarker3D()返回三维场景中的点几何对象是否使用三维模型符号。booleanisMarkerSizeFixed()返回三维模型符号是否固定物理大小。booleanisTessellated()voidsetAltitudeMode(AltitudeMode altitudeMode)设置三维场景中的几何对象的高度模式。voidsetAnchorOffsetMode(AnchorOffsetMode mode)设置标签专题图文字偏移模式。voidsetBottomAltitude(double value)设置底部高程值。voidsetExtendedHeight(double value)设置拉伸高度值。voidsetFiletEnabled(boolean value)设置是否使用倒角方式处理管道拐点处。voidsetFillBackColor(Color value)设置三维场景中的面几何对象的填充符号的背景色。voidsetFillForeColor(Color value)设置三维场景中的面几何对象的填充符号的前景色。voidsetFillGradientAngle(double value)渐变填充的旋转角度,以度为单位,精确到0.1度,逆时针方向为正方向。voidsetFillGradientMode(FillGradientMode fillGradientMode)设置渐变填充风格的渐变类型。voidsetFillGradientOffsetRatioX(int value)设置渐变填充中心点相对于填充区域范围中心点的水平偏移百分比。voidsetFillGradientOffsetRatioY(int value)设置填充中心点相对于填充区域范围中心点的垂直偏移百分比。voidsetFillMode(FillMode3D fill3DMode)设置三维几何体对象的填充模式。voidsetFillSymbolID(int value)设置三维场景中的面几何对象的填充符号的编号。voidsetLineColor(Color value)设置三维场景中的线几何对象或面几何对象轮廓线的线符号的颜色。voidsetLineSymbolID(int value)设置线状符号的编码。voidsetLineWidth(double value)设置三维场景中的线几何对象或面几何对象轮廓线的线符号的宽度。voidsetMarker3D(boolean value)设置三维场景中的点几何对象是否使用三维模型符号。voidsetMarker3DRotateX(double value)设置三维模型符号绕 X 轴的旋转角度。voidsetMarker3DRotateY(double value)设置三维模型符号绕 Y 轴的旋转角度。voidsetMarker3DRotateZ(double value)设置三维模型符号绕 Z 轴的旋转角度。voidsetMarker3DScaleX(double value)设置三维模型符号 X 轴方向的缩放比例。voidsetMarker3DScaleY(double value)设置三维模型符号 Y 轴方向的缩放比例。voidsetMarker3DScaleZ(double value)设置三维模型符号 Z 轴方向的缩放比例。voidsetMarkerAnchorPoint(Point2D value)设置地标的锚点,锚点的位置取决于锚点所用图片,如果锚点放在图片的左下角,则为(0, 0)点,如果锚点放在图片的右上角,则为(1, 1)点,其他位置则两个分量的范围在0-1之间。voidsetMarkerBillboardMode(MarkerBillboardMode value)设置三维场景中的点几何对象的布告板模式。voidsetMarkerColor(Color value)设置三维场景中的点几何对象所设置的点符号的颜色。voidsetMarkerFile(String value)设置三维场景中的点几何对象的图标文件路径,即使用该图标实现符号化表示三维场景中的点几何对象。voidsetMarkerScale(double value)设置三维场景中的点几何对象的图标文件的缩放比率,仅当将三维场景中的点几何对象的风格设置为图标文件时调用该方法才起作用。voidsetMarkerSize(double value)设置三维场景中的点几何对象所设置的点符号的大小,单位为像素。voidsetMarkerSizeFixed(boolean value)设置三维模型符号是否固定物理大小。voidsetMarkerSymbolID(int value)设置三维场景中的点几何对象的点符号的编号。voidsetSideTextureFiles(String[] value)设置用于侧面纹理渲染的一系列图片文件路径。voidsetTessellated(boolean value)voidsetTextureRepeatMode(TextureRepeatMode textureRepeatMode)设置侧面纹理重复模式。voidsetTilingU(double value)设置侧面纹理横向重复字段。voidsetTilingV(double value)设置侧面纹理纵向重复字段。voidsetTopTextureFile(String value)设置顶部纹理文件路径,该方法中设置的是由分号隔开的纹理图片文件路径。voidsetTopTextureRepeatMode(TextureRepeatMode textureRepeatMode)设置顶部纹理重复模式。voidsetTopTilingU(double value)设置顶面纹理横向重复字段。voidsetTopTilingV(double value)设置顶面纹理纵向重复字段。voidsetTubeSides(int value)设置定义符号时所使用的面片数目。StringtoString()返回一个表示此三维场景中的几何对象风格类对象的格式化字符串。StringtoXML()返回表示GeoStyle3D对象的 XML 字符串。
-
-
-
构造器详细资料
-
GeoStyle3D
public GeoStyle3D()
构造一个新的 GeoStyle3D 对象。
-
GeoStyle3D
public GeoStyle3D(GeoStyle3D style)
根据给定的 GeoStyle3D 对象构造一个与其完全相同的新对象。- 参数:
style- 给定的 GeoStyle3D 对象。
-
-
方法详细资料
-
getFillForeColor
public Color getFillForeColor()
返回三维场景中的面几何对象的填充符号的前景色。- 返回:
- 三维场景中的面几何对象的填充符号的前景色。
- 默认值:
- 默认值为 Color[A=255, R=255, G=255, B=255]。
-
setFillForeColor
public void setFillForeColor(Color value)
设置三维场景中的面几何对象的填充符号的前景色。通过
setExtendedHeight()方法对三维场景中的线、面几何对象设置拉伸高度,调用该方法所设置的值会影响面几何对象和拉伸面的颜色。- 参数:
color- 三维场景中的面几何对象的填充符号的前景色。
-
getLineColor
public Color getLineColor()
返回三维场景中的线几何对象或面几何对象轮廓线的线符号的颜色。- 返回:
- 三维场景中的线几何对象或面几何对象轮廓线的线符号的颜色。
- 默认值:
- 默认值为 Color[A=255, R=255, G=255, B=0]。
-
setLineColor
public void setLineColor(Color value)
设置三维场景中的线几何对象或面几何对象轮廓线的线符号的颜色。若调用
setExtendedHeight()方法对三维场景中的几何对象设置拉伸高度,则调用该方法设置的线符号颜色会影响拉伸线和拉伸面的轮廓线。若三维线几何对象使用三维线符号时,建议使用默认值,即不使用该方法设置三维线符号的颜色,在三维场景中显示效果好。
- 参数:
color- 三维场景中的线几何对象或面几何对象轮廓线的线符号的颜色。
-
getLineWidth
public double getLineWidth()
返回三维场景中的线几何对象或面几何对象轮廓线的线符号的宽度。对于二维线符号,单位为像素;三维线符号,单位为米。- 返回:
- 三维场景中的线几何对象或面几何对象轮廓线的线符号的宽度。
- 默认值:
- 默认值为 1。对于二维线符号,单位为像素;三维线符号,单位为米。
-
setLineWidth
public void setLineWidth(double value)
设置三维场景中的线几何对象或面几何对象轮廓线的线符号的宽度。对于二维线符号,单位为像素;三维线符号,单位为米。如果调用
setExtendedHeight()方法对三维场景中的几何对象设置拉伸高度,则调用该方法设置的值会影响拉伸线和拉伸面的轮廓线的线宽。- 参数:
value- 三维场景中的线几何对象或面几何对象轮廓线的线符号的宽度。
-
getMarkerFile
public String getMarkerFile()
返回三维场景中的点几何对象的图标文件路径,即使用该图标实现符号化表示三维场景中的点几何对象。支持 bmp, png, jpg, jpeg, gif 格式的图片文件和 3ds 和 sgm 格式的模型文件。- 返回:
- 三维场景中的点几何对象的图标文件路径
- 默认值:
- 默认值为一个空字符串。
-
setMarkerFile
public void setMarkerFile(String value)
设置三维场景中的点几何对象的图标文件路径,即使用该图标实现符号化表示三维场景中的点几何对象。- 参数:
value- 三维符号图标文件路径。
-
getMarkerScale
public double getMarkerScale()
返回三维场景中的点几何对象的图标文件的缩放比率。- 返回:
- 三维场景中的点几何对象的图标文件的缩放比率。
- 默认值:
- 默认值为 1.0。
-
setMarkerScale
public void setMarkerScale(double value)
设置三维场景中的点几何对象的图标文件的缩放比率,仅当将三维场景中的点几何对象的风格设置为图标文件时调用该方法才起作用。- 参数:
value- 三维场景中的点几何对象的图标文件的缩放比率。
-
getMarkerColor
public Color getMarkerColor()
返回三维场景中的点几何对象所设置的点符号的颜色。- 返回:
- 三维场景中的点几何对象所设置的点符号的颜色。
- 默认值:
- 默认值为 Color[A = 255, R = 255, G = 255, B = 255]。
-
setMarkerColor
public void setMarkerColor(Color value)
设置三维场景中的点几何对象所设置的点符号的颜色。对三维场景中的点几何对象可设置二维矢量点符号、二维栅格点符号和三维模型符号,对于三维模型符号调用该方法所设的颜色不起作用。
- 参数:
color- 所要设置的三维场景中的点几何对象所设置的点符号的颜色。
-
getMarkerSize
public double getMarkerSize()
返回三维场景中的点几何对象所设置的点符号的大小,单位为像素。- 返回:
- 三维场景中的点几何对象所设置的点符号的大小。单位为像素。
- 默认值:
- 默认值为 4,单位为像素。
-
setMarkerSize
public void setMarkerSize(double value)
设置三维场景中的点几何对象所设置的点符号的大小,单位为像素。当将三维场景中的点几何对象的符号设置为二维矢量或栅格符号时,可使用该方法设置符号的大小;
当将三维场景中的点几何对象的符号设置为三维模型符号或图标文件时,调用该方法设置点符号的大小不起作用, 其中三维模型符号的大小通过
setMarker3DScaleX()、setMarker3DScaleY()、setMarker3DScaleZ()三个方法控制;图标文件的大小通过setMarkerScale()方法控制。- 参数:
value- 所要设置的三维场景中的点几何对象所设置的点符号的大小。单位为像素。
-
getFillMode
public FillMode3D getFillMode()
返回三维几何体对象的填充模式。三维几何体对象的填充模式分为轮廓填充,区域填充,轮廓和区域填充,详细信息请参见FillMode3D类。- 返回:
- 三维几何体对象的填充模式。
- 默认值:
- 默认值为
LINE_AND_FILL。
-
setFillMode
public void setFillMode(FillMode3D fill3DMode)
设置三维几何体对象的填充模式。三维几何体对象的填充模式分为轮廓填充,区域填充,轮廓和区域填充,详细信息请参见FillMode3D类。- 参数:
fill3DMode- 三维几何体对象的填充模式。
-
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- 拉伸高度值。单位为米。
-
getSideTextureFiles
public String[] getSideTextureFiles()
返回用于侧面纹理渲染的一系列图片文件路径。对三维线、面几何对象设置拉伸高度时,会形成拉伸面,拉伸面就是侧面。 三维体对象的侧面将使用该方法返回的图片进行纹理渲染。- 返回:
- 侧面纹理文件路径。
- 默认值:
- 默认值为一个空的字符串。
-
setSideTextureFiles
public void setSideTextureFiles(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- 侧面纹理纵向重复字段。
-
getTopTilingU
public double getTopTilingU()
返回顶面纹理横向重复字段。该字段代表顶面纹理横向重复次数或重复尺寸,当 TextureRepeatMode 设置为 REPEATTIMES (按次数重复模式)时,该字段表示用户指定的纹理重复次数;当 TextureRepeatMode 设置为 REALSIZE (按尺寸重复模式)时,该字段表示用户指定的纹理贴图单次重复所占的尺寸。
注意:该方法的返回值类型是 double,即允许是小数。
- 返回:
- 顶面纹理横向重复字段。
- 默认值:
- 默认值为 1。
-
setTopTilingU
public void setTopTilingU(double value)
设置顶面纹理横向重复字段。该字段代表顶面纹理横向重复次数或重复尺寸,当 TextureRepeatMode 设置为 REPEATTIMES (按次数重复模式)时,该字段表示用户指定的纹理重复次数;当 TextureRepeatMode 设置为 REALSIZE (按尺寸重复模式)时,该字段表示用户指定的纹理贴图单次重复所占的尺寸。
注意:该方法的参数类型是 double,即允许是小数。
- 参数:
value- 顶面纹理横向重复字段。
-
getTopTilingV
public double getTopTilingV()
返回顶面纹理纵向重复字段。该字段代表顶面纹理纵向重复次数或重复尺寸,当 TextureRepeatMode 设置为 REPEATTIMES (按次数重复模式)时,该字段表示用户指定的纹理重复次数;当 TextureRepeatMode 设置为 REALSIZE (按尺寸重复模式)时,该字段表示用户指定的纹理贴图单次重复所占的尺寸。
注意:该方法的返回值类型是 double,即允许是小数。
- 返回:
- 顶面纹理纵向重复字段。
- 默认值:
- 默认值为 1。
-
setTopTilingV
public void setTopTilingV(double value)
设置顶面纹理纵向重复字段。该字段代表顶面纹理纵向重复次数或重复尺寸,当 TextureRepeatMode 设置为 REPEATTIMES (按次数重复模式)时,该字段表示用户指定的纹理重复次数;当 TextureRepeatMode 设置为 REALSIZE (按尺寸重复模式)时,该字段表示用户指定的纹理贴图单次重复所占的尺寸。
注意:该方法的参数类型是 double,即允许是小数。
- 参数:
value- 顶面纹理纵向重复字段。
-
getTextureRepeatMode
public TextureRepeatMode getTextureRepeatMode()
返回侧面纹理重复模式。- 返回:
- 返回侧面纹理重复模式。
-
setTextureRepeatMode
public void setTextureRepeatMode(TextureRepeatMode textureRepeatMode)
设置侧面纹理重复模式。- 参数:
textureRepeatMode- 侧面纹理重复模式。
-
getTopTextureRepeatMode
public TextureRepeatMode getTopTextureRepeatMode()
返回顶部纹理重复模式。- 返回:
- 返回顶部纹理重复模式。
-
setTopTextureRepeatMode
public void setTopTextureRepeatMode(TextureRepeatMode textureRepeatMode)
设置顶部纹理重复模式。- 参数:
textureRepeatMode- 顶部纹理重复模式。
-
getTopTextureFile
public String getTopTextureFile()
返回顶部纹理文件路径,该方法中存储的是由分号隔开的纹理图片文件路径。三维体对象的顶部将使用该方法所指示的图片进行纹理渲染。- 返回:
- 顶部纹理文件路径。
- 默认值:
- 默认值为一个空的字符串。
-
setTopTextureFile
public void setTopTextureFile(String value)
设置顶部纹理文件路径,该方法中设置的是由分号隔开的纹理图片文件路径。三维体对象的顶部将使用该方法所指示的图片进行纹理渲染。- 参数:
value- 顶部纹理文件路径。
-
getAltitudeMode
public AltitudeMode getAltitudeMode()
返回三维场景中的几何对象的高度模式。详细信息请参见AltitudeMode类。- 返回:
- 三维几何对象的高度模式。
- 默认值:
- 默认值为
CLAMP_TO_GROUND。
-
setAltitudeMode
public void setAltitudeMode(AltitudeMode altitudeMode)
设置三维场景中的几何对象的高度模式。详细信息请参见AltitudeMode类。- 参数:
altitudeMode- 三维几何对象的高度模式。
-
clone
public GeoStyle3D clone()
返回当前 GeoStyle3D 对象的一个拷贝。
-
dispose
public void dispose()
释放该对象所占用的资源。当调用该方法之后,此对象不再可用。
-
toString
public String toString()
返回一个表示此三维场景中的几何对象风格类对象的格式化字符串。
-
toXML
public String toXML()
返回表示GeoStyle3D对象的 XML 字符串。- 返回:
- 表示
GeoStyle3D对象的 XML 字符串。
-
fromXML
public boolean fromXML(String xml)
根据传入的 XML 字符串重新构造该GeoStyle3D对象。- 参数:
xml- 指定的 XML 字符串。- 返回:
- 如果构建成功返回 true,否则返回 false。
-
getMarkerBillboardMode
public MarkerBillboardMode getMarkerBillboardMode()
返回三维场景中的点几何对象的布告板模式。点布告板模式可参见MarkerBillboardMode类。- 返回:
- 地标布告板的模式。
- 默认值:
- 默认值为
NONE。
-
setMarkerBillboardMode
public void setMarkerBillboardMode(MarkerBillboardMode value)
设置三维场景中的点几何对象的布告板模式。当使用图标文件和模型文件设置点几何对象时调用该方法设置有效,使用点符号的点几何对象调用该方法设置风格无效。点布告板模式可参见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- 三维模型符号是否固定物理大小。
-
getMarkerSymbolID
public int getMarkerSymbolID()
返回三维场景中的点几何对象的点符号的编号。此编号用于唯一标识各点符号。点状符号可以用户自定义,也可以使用系统自带的点符号库中的点符号。
- 返回:
- 三维场景中的点几何对象的点符号的编号。
- 默认值:
- 默认值为 0。
-
setMarkerSymbolID
public void setMarkerSymbolID(int value)
设置三维场景中的点几何对象的点符号的编号。此编号用于唯一标识各点符号。点状符号可以用户自定义,也可以使用系统自带的点符号库中的点符号。
- 参数:
value- 三维场景中的点几何对象的点符号的编号。
-
isMarker3D
public boolean isMarker3D()
返回三维场景中的点几何对象是否使用三维模型符号。- 返回:
- 一个布尔值,表示三维场景中的点几何对象是否使用三维模型符号。true 表示使用三维模型符号,false 表示不使用三维模型符号。
- 默认值:
- 默认值为false,表示不使用三维点符号。
-
setMarker3D
public void setMarker3D(boolean value)
设置三维场景中的点几何对象是否使用三维模型符号。- 参数:
value- 三维场景中的点几何对象是否使用三维模型符号。
-
getLineSymbolID
public int getLineSymbolID()
返回三维场景中的线几何对象的线符号的编号。此编号用于唯一标识各线状符号。线符号可以用户自定义,也可以使用系统自带的符号库。
- 返回:
- 三维场景中的线几何对象的线符号的编号。
- 默认值:
- 默认值为0。
-
setLineSymbolID
public void setLineSymbolID(int value)
设置线状符号的编码。此编码用于唯一标识各线状符号。线符号可以用户自定义,也可以使用系统自带的符号库。
对三维场景中的线几何对象可设置的线符号包括二维线符号和三维线符号两种,使用该方法有以下两点注意:
1.对在三维场景中显示的二维线几何对象或二维面几何对象的轮廓线,设置三维线符号无效。
2.在非地表高度模式下,对三维场景中的线几何对象或二维面几何对象的轮廓线设置二维线符号无效,在场景中显示时仍然使用编号为0的线符号。
- 参数:
value- 一个用来设置三维场景中的线几何对象的线符号的编号的整数值。
-
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 轴的旋转角度。
-
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 轴方向的缩放比例。
-
getAnchorOffsetMode
public AnchorOffsetMode getAnchorOffsetMode()
获取标签专题图文字偏移模式。- 返回:
- 文字偏移模式
-
setAnchorOffsetMode
public void setAnchorOffsetMode(AnchorOffsetMode mode)
设置标签专题图文字偏移模式。- 参数:
mode- 文字偏移模式
-
getMarkerAnchorPoint
public Point2D getMarkerAnchorPoint()
返回地标的锚点,锚点的位置取决于锚点所用图片,如果锚点放在图片的左下角,则为(0, 0)点,如果锚点放在图片的右上角,则为(1, 1)点,其他位置则两个分量的范围在0-1之间。- 返回:
- 地标的锚点,锚点的位置取决于锚点所用图片。
-
setMarkerAnchorPoint
public void setMarkerAnchorPoint(Point2D value)
设置地标的锚点,锚点的位置取决于锚点所用图片,如果锚点放在图片的左下角,则为(0, 0)点,如果锚点放在图片的右上角,则为(1, 1)点,其他位置则两个分量的范围在0-1之间。- 参数:
point2D- 地标的锚点,锚点的位置取决于锚点所用图片。
-
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- 是否使用倒角方式处理管道拐点处。
-
isTessellated
public boolean isTessellated()
-
setTessellated
public void setTessellated(boolean value)
-
setFillSymbolID
public void setFillSymbolID(int value)
设置三维场景中的面几何对象的填充符号的编号。此编号用于唯一标识各普通填充风格的填充符号。填充符号可以用户自定义,也可以使用系统自带的符号库。
在非地表高度模式下,对三维场景中的面几何对象或拉伸面设置填充符号无效,在场景中显示时仍然使用编号为0的填充符号。
- 参数:
value- 一个整数用来设置三维场景中的面几何对象的填充符号的编码。
-
getFillSymbolID
public int getFillSymbolID()
返回三维场景中的面几何对象的填充符号的编号。此编号用于唯一标识各普通填充风格的填充符号。填充符号可以用户自定义,也可以使用系统自带的符号库。
- 返回:
- 三维场景中的面几何对象的填充符号的编码。
- 默认值:
- 默认值为 0。
-
setFillBackColor
public void setFillBackColor(Color value)
设置三维场景中的面几何对象的填充符号的背景色。当填充模式为渐变填充时,该颜色为渐变填充终止色。仅当三维场景中的面几何对象的高度模式设置为地表高度模式(
CLAMP_TO_GROUND)时,通过该方法所设置的颜色值对填充符号才起作用。- 参数:
value- Color对象,一个颜色值。
-
getFillBackColor
public Color getFillBackColor()
返回三维场景中的面几何对象的填充符号的背景色。当填充模式为渐变填充时,该颜色为填充终止色。- 返回:
- Color对象,表示三维场景中的面几何对象的填充符号的背景色。
- 默认值:
- 默认值为 Color[A=255, R=255, G=255, B=255]。
-
setFillGradientAngle
public void setFillGradientAngle(double value)
渐变填充的旋转角度,以度为单位,精确到0.1度,逆时针方向为正方向。有关各渐变填充风格类型的定义,请参见FillGradientMode。仅当三维场景中的面几何对象的高度模式设置为地表高度模式(
CLAMP_TO_GROUND)时,通过该方法所设置的值对填充符号才起作用。对于不同的渐变填充,其旋转的后的效果各异,但都是以最小外接矩形的中心为旋转中心,逆时针旋转的。具体请参见
getFillGradientAngle()方法。- 参数:
value- 用来设置渐变填充的旋转角度。单位为度。
-
getFillGradientAngle
public double getFillGradientAngle()
渐变填充的旋转角度,以度为单位,精确到0.1度,逆时针方向为正方向。有关各渐变填充风格类型的定义,请参见 FillGradientMode。
对于不同的渐变填充,其旋转的后的效果各异,但都是以最小外接矩形的中心为旋转中心,逆时针旋转的:
线性渐变
当设置的角度为0-360度的任意角度时,经过起始点和终止点的线以最小外接矩形的中心为旋转中心逆时针旋转,渐变风格随之旋转, 依然从线的起始端渐变到终止端的线性渐变。如下列举在特殊角度的渐变风格:
- 当渐变填充角度设置为0度或者360度的时候,那么渐变填充风格为由左到右从起始色到终止色的线性渐变,如图所示起始色为黄色,终止色为粉红色;
- 当渐变填充角度设置为180度时,渐变填充风格与1中描述的风格正好相反,即从右到左,从起始色到终止色线性渐变;
- 当渐变填充角度设置为90度时,渐变填充风格为由下到上,起始色到终止色的线性渐变;
- 当渐变填充角度设置为270度时,渐变填充风格与3中描述的风格正好相反,即从上到下,起始色到终止色线性渐变。
辐射渐变
渐变填充角度设置为任何角度(不超出正常范围)时,将定义辐射渐变的圆形按照设置的角度进行旋转,由于圆是关于填充范围的最小外接矩形的中心点对称的, 所以旋转之后的渐变填充的风格始终保持一样,即从中心点到填充范围的边界,从前景色到背景色的辐射渐变。
圆锥渐变
当渐变角度设置为0-360度之间的任何角度,该圆锥的所有母线将发生旋转,以圆锥的中心点,即填充区域的最小外接矩形的中心为旋转中心,逆时针方向旋转。 如图所示的例子中 ,旋转角度为90度,所有的母线都从起始位置(旋转角度为零的位置)开始旋转到指定角度,以经过起始点的母线为例,其从0度位置旋转到90度位置。


四角渐变
根据给定的渐变填充角度,将发生渐变的正方形以填充区域范围的中心为中心进行相应的旋转,所有正方形都是从初始位置即旋转角度为零的默认位置开始旋转。 渐变依然是从内部的正方形到外部的正方形发生从起始色到终止色的渐变。
- 返回:
- 渐变填充的旋转角度。
- 默认值:
- 默认值为 0。单位为度。
- 当渐变填充角度设置为0度或者360度的时候,那么渐变填充风格为由左到右从起始色到终止色的线性渐变,如图所示起始色为黄色,终止色为粉红色;
-
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类型。
-
-
Copyright © 2021–2025 SuperMap. All rights reserved.