com.supermap.data

类 TextPart3D

  • java.lang.Object
    • com.supermap.data.InternalHandle
      • com.supermap.data.InternalHandleDisposable
        • com.supermap.data.TextPart3D
  • 所有已实现的接口:
    IDisposable


    public class TextPart3D
    extends com.supermap.data.InternalHandleDisposable
    三维文本子对象类。

    一个三维文本对象是由一个或多个三维文本子对象构成的,三维文本对象的文字内容是各个子对象的文字内容之和,还可以通过设置各个子对象的放置位置,使一个三维文本对象中的各部分文字具有自己的放置风格。而关于三维文本子对象的文字内容的其他风格,如:文字的对齐方式、字体颜色、字体的大小以及其他文字的风格都由他们所属的三维文本对象的 setTextStyle() 方法设置来统一决定。具体内容,请参见 GeoText3D 类。

    当该类的实例已被 dispose() 方法释放后,再调用该类成员的时候,则抛出 ObjectDisposedException 异常。

    示范代码:
    以下代码示范如何构造一个三维文本子对象,并将其添加到三维文本几何对象中,将三维文本几何对象添加到 SceneControl 的图层中。
     public void textPart3DTest(){
            
            // 构造一个三维文本子对象,设置三维文本子对象
            TextPart3D textPart3D = new TextPart3D();
            textPart3D.setAnchorPoint(new Point3D(22, 50, 45));
            textPart3D.setText("示例");
            textPart3D.setX(22.5);
            textPart3D.setY(52.2);
            textPart3D.setZ(45.0);
    
            // 对三维文本子对象进行平移操作
            textPart3D.offset(2, 5, 6);
    
            // 用三维文本子对象构造一个三维文本几何对象
            GeoText3D geoText3D = new GeoText3D(textPart3D);
    
            // 构造一个 SceneControl 对象并将上面得到的三维对象添加到第0号图层中
            SceneControl scenecontrol = new SceneControl();
            
            Layer3D layer3D = scenecontrol.getScene().getLayers().get(0);
            //layer3D.getFeatures()方法只针对KML类型三维图层,当为其他类型的图层时,返回值为null。
            if(layer3D.getFeatures()!=null)
                {
                    layer3D.getFeatures().add(geoText3D);
                }
                else
                {
                   JOptionPane.showMessageDialog(null, "获取三维要素集合对象失败,必须为KML类型的三维图层。");
                }
    
            // 释放对象和 SceneControl 对象
            geoText3D.dispose();
            scenecontrol.dispose();
        }
     
    • 构造器概要

      构造器 
      构造器和说明
      TextPart3D()
      构造一个新的 TextPart3D 对象。
      TextPart3D(String text, double x, double y, double z)
      根据指定的参数来构造一个 TextPart3D 的新对象。
      TextPart3D(String text, Point3D anchorPoint)
      根据指定的参数来构造一个 TextPart3D 的新对象。
      TextPart3D(TextPart3D part)
      根据指定的 TextPart3D 对象构造一个与其完全相同的新对象。
    • 方法概要

      所有方法 实例方法 具体方法 
      限定符和类型 方法和说明
      TextPart3D clone()
      返回当前 TextPart3D 对象的一个拷贝。
      void dispose()
      释放该对象所占用的资源。
      Point3D getAnchorPoint()
      返回此三维文本子对象的锚点,锚点与该子对象的文本对齐方式共同决定该子对象的显示位置。
      String getText()
      返回此三维文本子对象的文本内容。
      double getX()
      返回此三维子对象锚点的 X 坐标。
      double getY()
      返回此三维子对象锚点的 Y 坐标。
      double getZ()
      返回此三维子对象锚点的 Z 坐标。
      void offset(double dx, double dy, double dz)
      将此三维文本子对象的锚点的坐标值调整指定的量。
      void setAnchorPoint(Point3D anchorPoint)
      设置此三维文本子对象的锚点,锚点与该子对象的文本对齐方式共同决定该子对象的显示位置。
      void setText(String text)
      设置此三维文本子对象的文本内容。
      void setX(double x)
      设置此三维子对象锚点的 X 坐标。
      void setY(double y)
      设置此三维子对象锚点的 Y 坐标。
      void setZ(double z)
      设置此三维子对象锚点的 Z 坐标。
      • 从类继承的方法 com.supermap.data.InternalHandleDisposable

        makeSureNativeObjectLive
    • 构造器详细资料

      • TextPart3D

        public TextPart3D()
        构造一个新的 TextPart3D 对象。
      • TextPart3D

        public TextPart3D(TextPart3D part)
        根据指定的 TextPart3D 对象构造一个与其完全相同的新对象。
        参数:
        part - 指定的 TextPart3D 对象。
        抛出:
        ObjectDisposedException - 当指定的三维文本对象已被 dispose() 方法释放后,再传入时。
      • TextPart3D

        public TextPart3D(String text,
                          Point3D anchorPoint)
        根据指定的参数来构造一个 TextPart3D 的新对象。
        参数:
        text - 指定的三维文本子对象的文本内容。
        anchorPoint - 指定的三维文本子对象的锚点。
      • TextPart3D

        public TextPart3D(String text,
                          double x,
                          double y,
                          double z)
        根据指定的参数来构造一个 TextPart3D 的新对象。
        参数:
        text - 指定的三维文本子对象的文本内容。
        x - 指定的三维文本子对象锚点的 X 坐标值,单位为度。
        y - 指定的三维文本子对象锚点的 Y 坐标值,单位为度。
        z - 指定的三维文本子对象锚点的 Z 坐标值,单位为米。
    • 方法详细资料

      • dispose

        public void dispose()
        释放该对象所占用的资源。当调用该方法之后,此对象不再可用。
      • getText

        public String getText()
        返回此三维文本子对象的文本内容。
        返回:
        此三维文本子对象的文本内容。
        默认值:
        默认值为一个空的字符串。
      • setText

        public void setText(String text)
        设置此三维文本子对象的文本内容。
        参数:
        value - 此三维文本子对象的文本内容。
      • getAnchorPoint

        public Point3D getAnchorPoint()
        返回此三维文本子对象的锚点,锚点与该子对象的文本对齐方式共同决定该子对象的显示位置。
        返回:
        此三维文本子对象的锚点。
        默认值:
        默认值为{X = 0, Y = 0, Z = 0}。
      • setAnchorPoint

        public void setAnchorPoint(Point3D anchorPoint)
        设置此三维文本子对象的锚点,锚点与该子对象的文本对齐方式共同决定该子对象的显示位置。
        参数:
        point3D - 此三维文本子对象的锚点。
      • getX

        public double getX()
        返回此三维子对象锚点的 X 坐标。单位为度。
        返回:
        此三维子对象锚点的 X 坐标。单位为度。
        默认值:
        默认值为 0,单位为度。
      • getY

        public double getY()
        返回此三维子对象锚点的 Y 坐标。单位为度。
        返回:
        此三维子对象锚点的 Y 坐标。单位为度。
        默认值:
        默认值为0,单位为度。
      • setX

        public void setX(double x)
        设置此三维子对象锚点的 X 坐标。单位为度。
        参数:
        value - 此三维子对象锚点的 X 坐标。单位为度。
      • setY

        public void setY(double y)
        设置此三维子对象锚点的 Y 坐标。单位为度。
        参数:
        value - 此三维子对象锚点的 Y 坐标。单位为度。
      • getZ

        public double getZ()
        返回此三维子对象锚点的 Z 坐标。单位为米。
        返回:
        此三维子对象锚点的 Z 坐标。单位为米。
        默认值:
        默认值为0,单位为米。
      • setZ

        public void setZ(double z)
        设置此三维子对象锚点的 Z 坐标。单位为米。
        参数:
        value - 此三维子对象锚点的 Z 坐标。单位为米。
      • offset

        public void offset(double dx,
                           double dy,
                           double dz)
        将此三维文本子对象的锚点的坐标值调整指定的量。
        参数:
        dx - 沿 X 轴方向的偏移量。单位为度。
        dy - 沿 Y 轴方向的偏移量。单位为度。
        dz - 沿 Z 轴方向的偏移量。单位为米。
      • clone

        public TextPart3D clone()
        返回当前 TextPart3D 对象的一个拷贝。
        覆盖:
        clone 在类中 Object
        返回:
        通过克隆操作得到的 TextPart3D 对象。

Copyright © 2021–2024 SuperMap. All rights reserved.