跳过导航链接
com.supermap.data

类 GeoPlacemark

  • 所有已实现的接口:
    IDisposable

    public class GeoPlacemark
extends Geometry3D
    三维地标几何对象类。

    该类继承于 Geometry3D 类，主要用来在三维场景窗口中指定位置处放置几何对象并标注相应的名称。

    该类仅在 Windows、Linux 平台版本中支持。

    注意：该类的对象调用 getGeoModel() 方法无效，即返回值为null。

    对于三维地标几何对象可设置其名称、名称显示的风格以及所关联的几何对象。根据三维地标几何对象所关联的几何对象的不同，三维地标几何对象在三维场景窗口中的显示有所差异，主要分为两种形式：

    • 当三维地标几何对象所关联的几何对象是点对象时，那么在三维场景窗口中的指定位置处将显示该点对象，同时，根据指定的风格显示三维地标几何对象的名称，其中，指定的位置即为该点对象的坐标。
    • 当三维地标几何对象所关联的几何对象是点对象以外的其他几何对象时，那么在三维场景窗口中的指定位置处将只显示该几何对象，而不显示三维地标几何对象的名称。
    示范代码:
    以下代码示范如何构造一个三维几何地标对象，并将其添加到三维几何要素集合中。 
     public void geoPlacemarkTest() {
        // 实例化圆锥体几何对象，并对其进行设置
        GeoCone geoCone=new GeoCone();
        geoCone.setPosition(new Point3D(100, 100, 100));
        geoCone.setBottomRadius(50);
        geoCone.setHeight(150);

        // 构造一个三维几何地标对象并进行相应设置
        GeoPlacemark geoPlacemark = new GeoPlacemark();
        geoPlacemark.setName("Mark");
        geoPlacemark.setGeometry(geoCone);
        geoPlacemark.setNameStyle(new TextStyle());

        // 将三维地标几何对象添加到三维几何要素集合中，假设返回的三维图层为 KML 图层
        SceneControl sceneControl = new SceneControl();
        Layer3D layer3D = sceneControl.getScene().getLayers().get(0);
        Feature3Ds feature3Ds = layer3D.getFeatures();
        feature3Ds.add(geoPlacemark);

        // 释放三维地标对象、三维要素对象
        geoPlacemark.dispose();
        feature3Ds.dispose();
        geoCone.dispose();
    }

    • 构造器详细资料

      • GeoPlacemark

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

      • GeoPlacemark

        public GeoPlacemark(GeoPlacemark geoPlacemark)
        根据给定的 GeoPlacemark 对象构造一个与其完全相同的新对象。
        参数:
        geoPlacemark - 给定的 GeoPlacemark 对象。

      • GeoPlacemark

        public GeoPlacemark(String name,
                    Geometry geometry)
        根据指定的参数来构造一个 GeoPlacemark 的新对象。
        参数:
        name - 指定的三维地标几何对象的名称。
        geometry - 三维地标几何对象所对应的几何对象。

    • 方法详细资料

      • getName

        public String getName()
        返回三维地标几何对象的名称，该名称将显示在三维场景窗口中的指定位置。

        对于三维地标几何对象可设置其名称、名称显示的风格以及所关联的几何对象。根据三维地标几何对象所关联的几何对象的不同，三维地标几何对象在三维场景窗口中的显示有所差异，主要分为两种形式：

        • 当三维地标几何对象所关联的几何对象是点对象时，那么在三维场景窗口中的指定位置处将显示该点对象，同时，根据指定的风格显示三维地标几何对象的名称，其中，指定的位置即为该点对象的坐标。
        • 当三维地标几何对象所关联的几何对象是点对象以外的其他几何对象时，那么在三维场景窗口中的指定位置处将只显示该几何对象，而不显示三维地标几何对象的名称。
        返回:
        三维地标几何对象的名称。
        默认值:
        默认值为 "UntitledPlacemark"。

      • setName

        public void setName(String value)
        设置三维地标几何对象的名称，该名称将显示在三维场景窗口中的指定位置。

        对于三维地标几何对象可设置其名称、名称显示的风格以及所关联的几何对象。根据三维地标几何对象所关联的几何对象的不同，三维地标几何对象在三维场景窗口中的显示有所差异，主要分为两种形式：

        • 当三维地标几何对象所关联的几何对象是点对象时，那么在三维场景窗口中的指定位置处将显示该点对象，同时，根据指定的风格显示三维地标几何对象的名称，其中，指定的位置即为该点对象的坐标。
        • 当三维地标几何对象所关联的几何对象是点对象以外的其他几何对象时，那么在三维场景窗口中的指定位置处将只显示该几何对象，而不显示三维地标几何对象的名称。
        参数:
        value - 三维地标几何对象的名称。

      • getGeometry

        public Geometry getGeometry()
        返回三维地标几何对象所对应的几何对象。该几何对象可以作为三维要素对象显示在三维场景窗口中，同时，该几何对象还用来确定三维地标几何对象名称所显示的位置。

        对于三维地标几何对象可设置其名称、名称显示的风格以及所关联的几何对象。根据三维地标几何对象所关联的几何对象的不同，三维地标几何对象在三维场景窗口中的显示有所差异，主要分为两种形式：

        • 当三维地标几何对象所关联的几何对象是点对象时，那么在三维场景窗口中的指定位置处将显示该点对象，同时，根据指定的风格显示三维地标几何对象的名称，其中，指定的位置即为该点对象的坐标。
        • 当三维地标几何对象所关联的几何对象是点对象以外的其他几何对象时，那么在三维场景窗口中的指定位置处将只显示该几何对象，而不显示三维地标几何对象的名称。
        返回:
        三维地标几何对象所对应的几何对象。
        默认值:
        默认值为空。

      • setGeometry

        public void setGeometry(Geometry value)
        设置三维地标几何对象所对应的几何对象。该几何对象可以作为三维要素对象显示在三维场景窗口中，同时，该几何对象还用来确定三维地标几何对象名称所显示的位置。

        对于三维地标几何对象可设置其名称、名称显示的风格以及所关联的几何对象。根据三维地标几何对象所关联的几何对象的不同，三维地标几何对象在三维场景窗口中的显示有所差异，主要分为两种形式：

        • 当三维地标几何对象所关联的几何对象是点对象时，那么在三维场景窗口中的指定位置处将显示该点对象，同时，根据指定的风格显示三维地标几何对象的名称，其中，指定的位置即为该点对象的坐标。
        • 当三维地标几何对象所关联的几何对象是点对象以外的其他几何对象时，那么在三维场景窗口中的指定位置处将只显示该几何对象，而不显示三维地标几何对象的名称。

        注意：如果要设置的几何对象的类型与原几何对象的类型不相同，那么原几何对象会被释放。

        参数:
        geometry - 三维地标几何对象所对应的几何对象。

      • getNameStyle

        public TextStyle getNameStyle()
        返回三维地标几何对象的名称在显示时的文本风格。

        对于三维地标几何对象可设置其名称、名称显示的风格以及所关联的几何对象。根据三维地标几何对象所关联的几何对象的不同，三维地标几何对象在三维场景窗口中的显示有所差异，主要分为两种形式：

        • 当三维地标几何对象所关联的几何对象是点对象时，那么在三维场景窗口中的指定位置处将显示该点对象，同时，根据指定的风格显示三维地标几何对象的名称，其中，指定的位置即为该点对象的坐标。
        • 当三维地标几何对象所关联的几何对象是点对象以外的其他几何对象时，那么在三维场景窗口中的指定位置处将只显示该几何对象，而不显示三维地标几何对象的名称。
        返回:
        三维地标几何对象的名称在显示时的文本风格。
        默认值:
        默认值为{Alignment=TopLeft,BackColor=Color [A=255, R=0, G=0, B=0],BackOpaque=False,Bold=False,FontHeight=6,FontWidth=0,ForeColor=Color [A=255, R=255, G=255, B=255],IsSizeFixed=False,Italic=False,Outline=False,Rotation=0,Shadow=False,Strikeout=False,Underline=False,Weight=0}

      • setNameStyle

        public void setNameStyle(TextStyle textStyle)
        设置三维地标几何对象的名称在显示时的文本风格。

        对于三维地标几何对象可设置其名称、名称显示的风格以及所关联的几何对象。根据三维地标几何对象所关联的几何对象的不同，三维地标几何对象在三维场景窗口中的显示有所差异，主要分为两种形式：

        • 当三维地标几何对象所关联的几何对象是点对象时，那么在三维场景窗口中的指定位置处将显示该点对象，同时，根据指定的风格显示三维地标几何对象的名称，其中，指定的位置即为该点对象的坐标。
        • 当三维地标几何对象所关联的几何对象是点对象以外的其他几何对象时，那么在三维场景窗口中的指定位置处将只显示该几何对象，而不显示三维地标几何对象的名称。

        注意：该方法参数为 TextStyle 类对象，针对三维地标几何对象名称的文本风格字段设置来说，只有 TextStyle 类对象的setForeColor()、setFontScale()、setOpaqueRate() 方法有效。

        参数:
        textStyle - 三维地标几何对象的名称在显示时的文本风格。

      • clone

        public GeoPlacemark clone()
        从类复制的说明: Geometry
        克隆一个Geometry对象。
        指定者:
        clone 在类中 Geometry
        返回:
        克隆的Geometry对象。

      • dispose

        public void dispose()
        从类复制的说明: Geometry
        释放该对象所占用的资源。当调用该方法之后，此对象不再可用。
        指定者:
        dispose 在接口中 IDisposable
        指定者:
        dispose 在类中 Geometry
跳过导航链接

Copyright © 2021–2024 SuperMap. All rights reserved.