public class GeoText3D extends Geometry3D
该类提供了三维文本几何对象的编辑信息,可以通过设置此类来对三维文本几何对象以及其子对象进行编辑操作。
该类仅在 Windows、Linux 平台版本中支持。
一个三维文本几何对象是由一个或多个部分组成,每个部分称为三维文本几何对象的一个子对象,每个子对象都是一个 TextPart3D
的实例。三维文本几何对象的文字内容是各个子对象的文字内容之和,还可以通过设置各个子对象的放置位置,使一个三维文本几何对象中的各部分文字具有自己的放置风格。同一个三维文本几何对象的所有子对象都使用相同的文本风格,即使用该类的 setTextStyle()
方法定义的文本风格。
注意:
1.三维中的文本采用 BillBoard 技术,文本总是会自动放在最上层显示,始终朝着人,表面和视线垂直,不总是贴地面。
2.该类的对象调用 getGeoModel()
方法无效,即返回值为null。
构造器和说明 |
---|
GeoText3D()
构造一个新的 GeoText3D 对象。
|
GeoText3D(GeoText3D geoText3D)
根据指定的 GeoText3D 对象构造一个与其相同的新对象。
|
GeoText3D(TextPart3D part)
根据指定的参数来构造一个 GeoText3D 的新对象。
|
GeoText3D(TextPart3D part,
TextStyle textStyle)
根据指定的参数来构造一个 GeoText3D 的新对象。
|
限定符和类型 | 方法和说明 |
---|---|
int |
addPart(TextPart3D part)
在三维文本几何对象中添加子对象。
|
GeoText3D |
clone()
返回当前 GeoText3D 对象的一个拷贝。
|
void |
dispose()
释放该对象所占用的资源。
|
boolean |
fromXML(String xml)
根据传入的 XML 字符串重新构造几何对象。
|
TextPart3D |
getPart(int index)
返回此 GeoText3D 类实例的指定索引的子对象。
|
int |
getPartCount()
返回三维文本几何对象的子对象个数。
|
String |
getText()
返回三维文本几何对象的文本字符串。
|
TextStyle |
getTextStyle()
返回三维文本几何对象的文本风格。
|
int |
indexOf(TextPart3D part)
返回指定的子对象在此三维文本几何对象中的索引。
|
boolean |
insertPart(int index,
TextPart3D part)
在三维文本几何对象的指定位置插入一个子对象。
|
boolean |
isEmpty()
判断几何对象是否为空值,不同的几何对象的是否为空的条件各异,请参见各具体几何类型的该方法。
|
boolean |
removePart(int index)
删除指定索引的子对象。
|
void |
setEmpty()
清空几何对象中的空间数据,但几何对象的标识符和几何风格保持不变。
|
boolean |
setPart(int index,
TextPart3D part)
修改指定索引的子对象,即用新的三维文本子对象来替换原来的三维文本子对象。
|
void |
setTextStyle(TextStyle textStyle)
设置三维文本几何对象的文本风格。
|
convertToGeoModel3D, convertToGeoModel3D, convertToGeoModel3D, getBoundingBox, getGeoModel, getInnerPoint3D, getPosition, getRotationX, getRotationY, getRotationZ, getScaleX, getScaleY, getScaleZ, getStyle3D, getVolume, offset, setPosition, setRotationX, setRotationY, setRotationZ, setScaleX, setScaleY, setScaleZ, setStyle3D
addCustomGeometryCreatedListener, getBounds, getID, getInnerPoint, getStyle, getType, getVariantID, hitTest, mirror, offset, removeCustomGeometryCreatedListener, resize, rotate, setBounds, setID, setStyle, toXML
public GeoText3D()
public GeoText3D(GeoText3D geoText3D)
geoText3D
- 指定的 GeoText3D 对象。public GeoText3D(TextPart3D part)
part
- 给定的三维文本几何对象的子对象。public GeoText3D(TextPart3D part, TextStyle textStyle)
part
- 给定的三维文本几何对象的子对象。textStyle
- 指定的文本风格。public String getText()
public int getPartCount()
public TextStyle getTextStyle()
其中缩放比例(getFontScale()
/setFontScale()
)与文本固定大小、文本字体高度的关系如下:
1)在屏幕图层中,kml中的文本大小只支持缩放比,与文本字体高度和是否固定大小无关;
2)在三维标签专题图和文本数据集中:
a. 在 setTextStyle
设置为固定大小的情况下,是通过文本字体高度(setFontHeight()
)来改变文字在场景中显示的大小。此时的缩放比例 (setFontScale()
)即使设置了也不生效。
b. 在 TextStyle
不固定大小的情况下,是通过缩放比例(setFontScale()
)来改变文字在场景中的显示的大小。文本字体高度(setFontHeight()
)即使设置了也不生效。
public void setTextStyle(TextStyle textStyle)
textStyle
- 三维文本几何对象的文本风格。public boolean isEmpty()
Geometry
isEmpty
在类中 Geometry
Geometry.offset(double, double)
public int addPart(TextPart3D part)
part
- 待添加的三维文本几何对象的子对象。public TextPart3D getPart(int index)
index
- 指定的子对象索引。IndexOutOfBoundsException
- 如果 index<0 或 index>= getPartCount()
。public boolean insertPart(int index, TextPart3D part)
index
- 插入的位置,即子对象的索引值。part
- 要插入的子对象。IndexOutOfBoundsException
- 如果 index <0 或 index>= getPartCount()
。public int indexOf(TextPart3D part)
part
- 指定的子对象。public boolean removePart(int index)
index
- 指定的子对象索引。IndexOutOfBoundsException
- 如果 index <0 或 index>= getPartCount()
。public boolean setPart(int index, TextPart3D part)
index
- 指定子对象的索引。part
- 指定的子对象。IndexOutOfBoundsException
- 如果 index <0 或 index>= getPartCount()
。public GeoText3D clone()
public void setEmpty()
Geometry
public void dispose()
dispose
在接口中 IDisposable
dispose
在类中 Geometry
public boolean fromXML(String xml)
Geometry
调用该方法时,首先将该几何对象的原始数据清空,然后根据传入的 XML 字符串重新构造该几何对象。
GML (Geography Markup Language)即地理标识语言, GML 能够表示地理空间对象的空间数据和非空间属性数据。GML 是基于 XML 的空间信息编码标准,由开放式地理信息系统协会 OpenGIS Consortium (OGC) 提出,得到了许多公司的大力支持,如 Oracle、Galdos、MapInfo、CubeWerx 等。
GML 作为一个空间数据编码规范,提供了一套基本的标签、公共的数据模型,以及用户构建应用模式(GML Application Schemas)的机制。
fromXML
在类中 Geometry
xml
- XML 格式的字符串。Geometry.offset(double, double)
Copyright © 2021–2024 SuperMap. All rights reserved.