2.3.1 单点测量


单点测量

单点测量是指计算三维空间中某个位置的具体坐标信息,并用文字进行展示的效果。

主要包括添加(创建)、更新、显隐、删除和获取结果5种操作。

注意:可创建空的测量图层,也可创建预设的测量图层,如需创建预设测量图层,则IsLoad, IsActive, Points 三个参数需要同时配置

下图是单点测量效果:

  

参数说明

单点测量可配置的参数如下表所示:

配置项 配置说明 值类型 备注
LayerOptionsName 图层配置对象名称 string 分析图层需配置为:AnalysisLayerOptions
DataSourceTypeName 数据源类型 string as_point代表单点测量
PointColor 点颜色 R,G,B,A 颜色取值范围在0-1.0之间,如 "0.9,0.8,0.8,1.0"
PointSize 点大小 float 点大小取值范围在1-10之间
TextVisible 是否显示文字 bool 默认为false。如为false,则TextLiftUpStyle配置都无效
TextLiftUp 文字抬高高度 float 默认为0.0
IsDepthTest 是否开启深度测试 bool 默认为false。false不开启,结果会浮在场景上,true实际显示位置
Style 添加样式 string 配置文字样式,配置信息参考文字样式配置
IsLoad 是否初始化加载点 bool 默认为false
IsActive 是否激活分析 bool 默认为true,表示是否可操作场景进行绘制
Points 坐标点集 x,y,z列表 需传入经度,纬度,高程坐标集,中间用;分隔,并以;结尾
IsWorld 是否世界坐标点 bool 传入的坐标是否是世界坐标。true-世界坐标,false-经纬度坐标。默认为true
NonIntersect 非相交图层 int列表 该分析与场景哪些类型图层不相交。1-分析,2-地形,3-模型,4-矢量(未贴地),5-矢量模板阴影体,6-矢量(贴地),7-倾斜摄影。默认为1,即与除分析之外所有图层都相交

获取结果说明

单点测量可以通过图层对象的GetLayerResult() 方法获取结果。获取的结果值对象参数如下表所示:

配置项 配置说明 值类型 备注
DataSourceTypeName 数据源类型 string as_point代表单点测量
ClickPoints 点击点坐标 x,y,z列表 鼠标点击场景形成的关键点的经度,纬度,高程坐标列表,中间用;分隔,并以;结尾

代码调用示例

Javascript调用

var pointMeasure = null; 
var FontUrl = "C:\\WINDOWS\\Fonts\\msyh.ttf";//文字字体路径
//创建单点测量
function createPointMeasure(){
    if(pointMeasure == null){
        //创建图层配置信息
        var mlo = map.CreateLayerOptions("pointMeasure");//创建图层配置对象,任意名称
        mlo.AddConfig("LayerOptionsName", "AnalysisLayerOptions");//图层配置对象名称, AnalysisLayerOptions代表分析图层数据配置
        mlo.AddConfig("DataSourceTypeName", "as_point");//数据源类型,as_point代表点测量
        mlo.AddConfig("PointColor", "0.0,1.0,1.0,1.0");//点颜色
        mlo.AddConfig("PointSize", "10");//点大小
        mlo.AddConfig("TextVisible", "true");//是否显示文字
        mlo.AddConfig("TextLiftUp", "1");//文字抬高高度
        mlo.AddConfig("IsDepthTest","true");//是否开启深度测试。false不开启,结果会浮在场景上,true实际显示位置
        //mlo.AddConfig("NonIntersect","1,2");//非相交图层,1-分析,2-地形,3-模型,4-矢量(未贴地),5-矢量模板阴影体,6-矢量(贴地),7-倾斜摄影数据
        //创建文字符号
        var pSymbol = map.CreateSymbol("AnalysisTextSymbol");//创建符号对象,AnalysisTextSymbol代表文字符号
        pSymbol.AddConfig("FillingColor", "0.93,0.93,0.93,1");//设置文字颜色(RGBA)
        pSymbol.AddConfig("Font", FontUrl);//设置字体路径,绝对路径
        pSymbol.AddConfig("Size", "40");//字体精度大小
        pSymbol.AddConfig("CharacterSize", "10");//文字大小
        pSymbol.AddConfig("CharacterMode", "1");//字符大小变化模式。0:随对象变化显示,1:随相机远近变化,2:随相机远近变化,同时不超过上限值
        pSymbol.AddConfig("AlignmentMode", "5");//文字对齐方式
        pSymbol.AddConfig("AxisAlignment", "6");//设置文字旋转模式。旋转轴0-7,6:自动
        pSymbol.AddConfig("RemoveDuplicateLabels", "false");//是否移除重复的标注            
        pSymbol.AddConfig("IsEmbolden", "false");//字体是否加粗
        pSymbol.AddConfig("IsTransform", "false");//字体是否为斜体
        pSymbol.AddConfig("IsUnderline", "false");//字体是否有下划线
        pSymbol.AddConfig("IsBack", "true");//是否设置背景色
        pSymbol.AddConfig("BackColor", "0.42,0.47,0.85,1");//背景颜色,IsBack为true有效
        pSymbol.AddConfig("FieldPrecision","2");//显示精度
        pSymbol.AddConfig("IsDepthTest","true");//是否开启深度测试。默认为true
        //创建样式
        var pStyle = map.CreateStyle("Text");//创建样式
        pStyle.AddSymbol("AnalysisTextSymbol", pSymbol.GetConfig());//将符号对象添加到样式,第一参数为符号类型
        //将样式添加到图层配置里
        mlo.AddConfig("Style", pStyle.GetConfig());//添加样式
        pointMeasure = map.CreateLayer("AnalysisLayer", mlo);//创建分析图层,第一项参数为AnalysisLayer
        map.AddLayer(pointMeasure); //添加分析图层
    }else{
        alert("请勿重复创建!");
    }
}
//更新单点测量
function updatePointMeasure(){
   if(null != pointMeasure){
        //创建图层配置信息
        var mlo = map.CreateLayerOptions("pointMeasure");//创建图层配置对象,任意名称
        mlo.AddConfig("LayerOptionsName", "AnalysisLayerOptions");//图层配置对象名称, AnalysisLayerOptions代表分析图层数据配置
        mlo.AddConfig("DataSourceTypeName", "as_point");//数据源类型,as_point代表点测量
        mlo.AddConfig("PointColor", "1.0,0.0,1.0,1.0");//点颜色
        mlo.AddConfig("TextVisible", "true");//是否显示文字
        mlo.AddConfig("TextLiftUp", "20");//文字抬高高度
        mlo.AddConfig("IsDepthTest","false");//是否开启深度测试。false不开启,结果会浮在场景上,true实际显示位置
        //创建文字符号
        var pSymbol = map.CreateSymbol("AnalysisTextSymbol");//创建符号对象,AnalysisTextSymbol代表文字符号
        pSymbol.AddConfig("FillingColor", "1.0,0.0,0.0,1.0");//设置文字颜色(RGBA)
        pSymbol.AddConfig("Font", FontUrl);//文字字体路径,绝对路径
        pSymbol.AddConfig("Size", "20");//字体精度大小
        pSymbol.AddConfig("CharacterSize", "8");//文字大小
        pSymbol.AddConfig("CharacterMode", "1");//字符大小变化模式。0:随对象变化显示,1:随相机远近变化,2:随相机远近变化,同时不超过上限值
        pSymbol.AddConfig("AlignmentMode", "5");//文字对齐方式
        pSymbol.AddConfig("AxisAlignment", "6");//设置文字旋转模式。旋转轴0-7,6:自动
        pSymbol.AddConfig("RemoveDuplicateLabels", "false");//是否移除重复的标注            
        pSymbol.AddConfig("IsEmbolden", "false");//字体是否加粗
        pSymbol.AddConfig("IsTransform", "true");//字体是否为斜体
        pSymbol.AddConfig("IsUnderline", "false");//字体是否有下划线
        pSymbol.AddConfig("IsBack", "true");//是否设置背景色
        pSymbol.AddConfig("BackColor", "0,1.0,1.0,1");//背景颜色,是否设置背景色为true有效
        pSymbol.AddConfig("FieldPrecision","6");//显示精度
        pSymbol.AddConfig("IsDepthTest","true");//是否开启深度测试。默认为true
        //创建样式
        var pStyle = map.CreateStyle("Text");//创建样式
        pStyle.AddSymbol("AnalysisTextSymbol", pSymbol.GetConfig());//将符号对象添加到样式,第一参数为符号类型
        //将样式添加到图层配置里
        mlo.AddConfig("Style", pStyle.GetConfig());//添加样式
        pointMeasure.UpdateLayerOptions(mlo);//更新图层
    }else{
        alert("请创建测量对象!");
    }
}
//获取单点测量结果
function getPointMeasure(){
    if(pointMeasure){
        var opt = pointMeasure.GetLayerResult();//获取图层结果
        //判断当前图层数据源类型
        if(opt.GetConfigValueByKey("DataSourceTypeName") == "as_point")
        {
            var points = opt.GetConfigValueByKey("ClickPoints");//获取点击点坐标
            alert("ClickPoints:" + points);
        }
    }else{
        alert("请创建测量对象!");
    }
}
//删除单点测量
function removePointMeasure(){
    if(pointMeasure){
        map.RemoveLayer(pointMeasure);//删除图层
        pointMeasure = null;
    }else{
        alert("没有测量对象!");
    }
}

C++调用

BaseObjectCOMLib::ILayerObjectPtr pointMeasure;//单点测量图层对象
//创建单点测量
void Cf2c0PointDlg::OnBnClickedcreatepointmeasure()
{
    if(pointMeasure)
    {
        return;
    }
    ConfigOptionsCOMLib::ILayerOptionsPtr tlo = (ConfigOptionsCOMLib::ILayerOptionsPtr)map->CreateLayerOptions(""); //创建图层配置对象,任意名称
    tlo->AddConfig("LayerOptionsName", "AnalysisLayerOptions");//图层配置对象名称, AnalysisLayerOptions代表分析图层数据配置
    tlo->AddConfig("DataSourceTypeName", "as_point");//数据源类型,as_point代表点测量
    tlo->AddConfig("PointColor", "0.0,1.0,1.0,1.0");//点颜色
    tlo->AddConfig("PointSize", "10");//点大小
    tlo->AddConfig("TextVisible", "true");//是否显示文字
    tlo->AddConfig("TextLiftUp", "1");//文字抬高高度
    tlo->AddConfig("IsDepthTest","true");//是否开启深度测试。false不开启,结果会浮在场景上,true实际显示位置
    //tlo->AddConfig("NonIntersect","1,2");//非相交图层,1-分析,2-地形,3-模型,4-矢量(未贴地),5-矢量模板阴影体,6-矢量(贴地),7-倾斜摄影数据
    //创建文字符号
    ConfigOptionsCOMLib::ISymbolObjectPtr pSymbol = (ConfigOptionsCOMLib::ISymbolObjectPtr)map->CreateSymbol("AnalysisTextSymbol");//创建符号对象,AnalysisTextSymbol代表文字符号
    pSymbol->AddConfig("FillingColor", "0.93,0.93,0.93,1");//设置文字颜色(RGBA)
    pSymbol->AddConfig("Font", "C:\\WINDOWS\\Fonts\\simhei.ttf");//设置字体类型,字体文件一定要存在
    pSymbol->AddConfig("Size", "40");//字体精度大小
    pSymbol->AddConfig("CharacterSize", "10");//文字大小
    pSymbol->AddConfig("CharacterMode", "1");//字符大小变化模式。0:随对象变化显示,1:随相机远近变化,2:随相机远近变化,同时不超过上限值
    pSymbol->AddConfig("AlignmentMode", "5");//文字对齐方式
    pSymbol->AddConfig("AxisAlignment", "6");//设置文字旋转模式。旋转轴0-7,6:自动
    pSymbol->AddConfig("RemoveDuplicateLabels", "false");//是否移除重复的标注            
    pSymbol->AddConfig("IsEmbolden", "false");//字体是否加粗
    pSymbol->AddConfig("IsTransform", "false");//字体是否为斜体
    pSymbol->AddConfig("IsUnderline", "false");//字体是否有下划线
    pSymbol->AddConfig("IsBack", "true");//是否设置背景色
    pSymbol->AddConfig("BackColor", "0.42,0.47,0.85,1");//背景颜色,IsBack为true有效
    pSymbol->AddConfig("FieldPrecision","2");//显示精度
    pSymbol->AddConfig("IsDepthTest","true");//是否开启深度测试。默认为true
    //创建样式
    ConfigOptionsCOMLib::IStylePtr pStyle = (ConfigOptionsCOMLib::IStylePtr)map->CreateStyle("Text");//创建样式
    pStyle->AddSymbol("AnalysisTextSymbol", pSymbol->GetConfig());//将符号对象添加到样式,第一参数为符号类型
    //将样式添加到图层配置里
    tlo->AddConfig("Style", pStyle->GetConfig());//添加样式
    pointMeasure = map->CreateLayer("AnalysisLayer", tlo);//创建分析图层,第一项参数为AnalysisLayer
    map->AddLayer(pointMeasure);//添加图层
}

//更新单点测量
void Cf2c0PointDlg::OnBnClickedupdatepointmeasure()
{
    if(!pointMeasure)
    {
        return;
    }
    ConfigOptionsCOMLib::ILayerOptionsPtr tlo = (ConfigOptionsCOMLib::ILayerOptionsPtr)map->CreateLayerOptions(""); //创建图层配置对象,任意名称
    tlo->AddConfig("LayerOptionsName", "AnalysisLayerOptions");//图层配置对象名称, AnalysisLayerOptions代表分析图层数据配置
    tlo->AddConfig("DataSourceTypeName", "as_point");//数据源类型,as_point代表点测量
    tlo->AddConfig("PointColor", "1.0,0.0,1.0,1.0");//点颜色
    tlo->AddConfig("TextVisible", "true");//是否显示文字
    tlo->AddConfig("TextLiftUp", "20");//文字抬高高度
    tlo->AddConfig("IsDepthTest","false");//是否开启深度测试。false不开启,结果会浮在场景上,true实际显示位置
    //创建文字符号
    ConfigOptionsCOMLib::ISymbolObjectPtr pSymbol = (ConfigOptionsCOMLib::ISymbolObjectPtr)map->CreateSymbol("AnalysisTextSymbol");//创建符号对象,AnalysisTextSymbol代表文字符号
    pSymbol->AddConfig("FillingColor", "1.0,0.0,0.0,1.0");//设置文字颜色(RGBA)
    pSymbol->AddConfig("Font", "C:\\WINDOWS\\Fonts\\simhei.ttf");//设置字体类型,字体文件一定要存在
    pSymbol->AddConfig("Size", "20");//字体精度大小
    pSymbol->AddConfig("CharacterSize", "8");//文字大小
    pSymbol->AddConfig("CharacterMode", "1");//字符大小变化模式。0:随对象变化显示,1:随相机远近变化,2:随相机远近变化,同时不超过上限值
    pSymbol->AddConfig("AlignmentMode", "5");//文字对齐方式
    pSymbol->AddConfig("AxisAlignment", "6");//设置文字旋转模式。旋转轴0-7,6:自动
    pSymbol->AddConfig("RemoveDuplicateLabels", "false");//是否移除重复的标注            
    pSymbol->AddConfig("IsEmbolden", "false");//字体是否加粗
    pSymbol->AddConfig("IsTransform", "true");//字体是否为斜体
    pSymbol->AddConfig("IsUnderline", "false");//字体是否有下划线
    pSymbol->AddConfig("IsBack", "true");//是否设置背景色
    pSymbol->AddConfig("BackColor", "0,1.0,1.0,1");//背景颜色,是否设置背景色为true有效
    pSymbol->AddConfig("FieldPrecision","6");//显示精度
    pSymbol->AddConfig("IsDepthTest","true");//是否开启深度测试。默认为true
    //创建样式
    ConfigOptionsCOMLib::IStylePtr pStyle = (ConfigOptionsCOMLib::IStylePtr)map->CreateStyle("Text");//创建样式
    pStyle->AddSymbol("AnalysisTextSymbol", pSymbol->GetConfig());//将符号对象添加到样式,第一参数为符号类型
    //将样式添加到图层配置里
    tlo->AddConfig("Style", pStyle->GetConfig());//添加样式
    pointMeasure->UpdateLayerOptions(tlo);//更新图层
}

//获取单点测量结果
void Cf2c0PointDlg::OnBnClickedgetpointmeasure()
{
    if(!pointMeasure)
    {
        return;
    }
    ConfigOptionsCOMLib::ILayerOptionsPtr opt = pointMeasure->GetLayerResult();
    std::string DataSourceTypeName = opt->GetConfigValueByKey("DataSourceTypeName");//获取数据源类型
    if(DataSourceTypeName == "as_point")
    {
        CString ClickPoints = opt->GetConfigValueByKey("ClickPoints");//获取点击点坐标
        MessageBox(L"ClickPoints:"+ ClickPoints);
    }
}

//删除单点测量
void Cf2c0PointDlg::OnBnClickedremovepointmeasure()
{
    if(!pointMeasure)
    {
        return;
    }
    map->RemoveLayer(pointMeasure);//删除单点测量
    pointMeasure = NULL;
}

C#调用

ILayerObject pointMeasure = null; 
string FontUrl = "C:\\WINDOWS\\Fonts\\msyh.ttf";//文字字体路径
//创建单点测量
private void createPointMeasure_Click(object sender, EventArgs e)
{
    if (pointMeasure == null)
    {
        //创建图层配置信息
        ILayerOptions mlo = map.CreateLayerOptions("pointMeasure");//创建图层配置对象,任意名称
        mlo.AddConfig("LayerOptionsName", "AnalysisLayerOptions");//图层配置对象名称, AnalysisLayerOptions代表分析图层数据配置
        mlo.AddConfig("DataSourceTypeName", "as_point");//数据源类型,as_point代表点测量
        mlo.AddConfig("PointColor", "0.0,1.0,1.0,1.0");//点颜色
        mlo.AddConfig("PointSize", "10");//点大小
        mlo.AddConfig("TextVisible", "true");//是否显示文字
        mlo.AddConfig("TextLiftUp", "1");//文字抬高高度
        mlo.AddConfig("IsDepthTest", "true");//是否开启深度测试。false不开启,结果会浮在场景上,true实际显示位置
        //创建文字符号
        ISymbolObject pSymbol = map.CreateSymbol("AnalysisTextSymbol");//创建符号对象,AnalysisTextSymbol代表文字符号
        pSymbol.AddConfig("FillingColor", "0.93,0.93,0.93,1");//设置文字颜色(RGBA)
        pSymbol.AddConfig("Font", FontUrl);//设置字体路径
        pSymbol.AddConfig("Size", "40");//字体精度大小
        pSymbol.AddConfig("CharacterSize", "10");//文字大小
        pSymbol.AddConfig("CharacterMode", "1");//字符大小变化模式。0:随对象变化显示,1:随相机远近变化,2:随相机远近变化,同时不超过上限值
        pSymbol.AddConfig("AlignmentMode", "5");//文字对齐方式
        pSymbol.AddConfig("AxisAlignment", "6");//设置文字旋转模式。旋转轴0-7,6:自动
        pSymbol.AddConfig("RemoveDuplicateLabels", "false");//是否移除重复的标注            
        pSymbol.AddConfig("IsEmbolden", "false");//字体是否加粗
        pSymbol.AddConfig("IsTransform", "false");//字体是否为斜体
        pSymbol.AddConfig("IsUnderline", "false");//字体是否有下划线
        pSymbol.AddConfig("IsBack", "true");//是否设置背景色
        pSymbol.AddConfig("BackColor", "0.42,0.47,0.85,1");//背景颜色,IsBack为true有效
        pSymbol.AddConfig("FieldPrecision", "2");//显示精度
        pSymbol.AddConfig("IsDepthTest","true");//是否开启深度测试。默认为true
        //创建样式
        IStyle pStyle = map.CreateStyle("Text");//创建样式
        pStyle.AddSymbol("AnalysisTextSymbol", pSymbol.GetConfig());//将符号对象添加到样式,第一参数为符号类型
        //将样式添加到图层配置里
        mlo.AddConfig("Style", pStyle.GetConfig());//添加样式
        pointMeasure = map.CreateLayer("AnalysisLayer", mlo);//创建分析图层,第一项参数为AnalysisLayer
        map.AddLayer(pointMeasure); //添加分析图层
    }
    else
    {
        MessageBox.Show("请勿重复创建!");
    }
}
//更新单点测量
private void updatePointMeasure_Click(object sender, EventArgs e)
{
    if (null != pointMeasure)
    {
        //创建图层配置信息
        ILayerOptions mlo = map.CreateLayerOptions("pointMeasure");//创建图层配置对象,任意名称
        mlo.AddConfig("LayerOptionsName", "AnalysisLayerOptions");//图层配置对象名称, AnalysisLayerOptions代表分析图层数据配置
        mlo.AddConfig("DataSourceTypeName", "as_point");//数据源类型,as_point代表点测量
        mlo.AddConfig("PointColor", "1.0,0.0,1.0,1.0");//点颜色
        mlo.AddConfig("TextVisible", "true");//是否显示文字
        mlo.AddConfig("TextLiftUp", "20");//文字抬高高度
        mlo.AddConfig("IsDepthTest", "false");//是否开启深度测试。false不开启,结果会浮在场景上,true实际显示位置
        //创建文字符号
        ISymbolObject pSymbol = map.CreateSymbol("AnalysisTextSymbol");//创建符号对象,AnalysisTextSymbol代表文字符号
        pSymbol.AddConfig("FillingColor", "1.0,0.0,0.0,1.0");//设置文字颜色(RGBA)
        pSymbol.AddConfig("Font", FontUrl);//设置字体路径
        pSymbol.AddConfig("Size", "20");//字体精度大小
        pSymbol.AddConfig("CharacterSize", "8");//文字大小
        pSymbol.AddConfig("CharacterMode", "1");//字符大小变化模式。0:随对象变化显示,1:随相机远近变化,2:随相机远近变化,同时不超过上限值
        pSymbol.AddConfig("AlignmentMode", "5");//文字对齐方式
        pSymbol.AddConfig("AxisAlignment", "6");//设置文字旋转模式。旋转轴0-7,6:自动
        pSymbol.AddConfig("RemoveDuplicateLabels", "false");//是否移除重复的标注            
        pSymbol.AddConfig("IsEmbolden", "false");//字体是否加粗
        pSymbol.AddConfig("IsTransform", "true");//字体是否为斜体
        pSymbol.AddConfig("IsUnderline", "false");//字体是否有下划线
        pSymbol.AddConfig("IsBack", "true");//是否设置背景色
        pSymbol.AddConfig("BackColor", "0,1.0,1.0,1");//背景颜色,是否设置背景色为true有效
        pSymbol.AddConfig("FieldPrecision", "6");//显示精度
        pSymbol.AddConfig("IsDepthTest","true");//是否开启深度测试。默认为true
        //创建样式
        IStyle pStyle = map.CreateStyle("Text");//创建样式
        pStyle.AddSymbol("AnalysisTextSymbol", pSymbol.GetConfig());//将符号对象添加到样式,第一参数为符号类型
        //将样式添加到图层配置里
        mlo.AddConfig("Style", pStyle.GetConfig());//添加样式
        pointMeasure.UpdateLayerOptions(mlo);//更新图层
    }
    else
    {
        MessageBox.Show("请创建测量对象!");
    }
}
//获取单点测量结果
private void button1_Click(object sender, EventArgs e)
{
    if (pointMeasure != null)
    {
        ILayerOptions opt = pointMeasure.GetLayerResult();//获取图层结果
        //判断当前图层数据源类型
        if (opt.GetConfigValueByKey("DataSourceTypeName") == "as_point")
        {
            string points = opt.GetConfigValueByKey("ClickPoints");//获取点击点坐标
            MessageBox.Show("ClickPoints:" + points);
        }
    }
    else
    {
        MessageBox.Show("请创建测量对象!");
    }
}
//删除单点测量
private void removePointMeasure_Click(object sender, EventArgs e)
{
    if (pointMeasure!=null)
    {
        map.RemoveLayer(pointMeasure);//删除图层
        pointMeasure = null;
    }
    else
    {
        MessageBox.Show("没有测量对象!");
    }
}

results matching ""

    No results matching ""