图观™引擎开发小技巧——三维场景地标点绘制

图观™引擎开发小技巧系列,是我们策划的一档以“数字孪生应用开发实用指南”为主要内容的活动,每篇一个小技能,助您更高效快捷地构建专属数字孪生应用。

——图观™|只为打造精品国产数字孪生应用开发引擎

地标点 简介

在您创建三维场景的过程中,往往会需要凸显目标物体、建筑、事件等重要要素的地理位置、分布情况、具体类别的信息,那么就会使用到地标点绘制功能。小编整理本篇内容,帮助您更加清晰、快速地了解,如何通过图观™统一开发API和接口调试器,进行三维场景地标绘制。

(流渲染地标点示意图)

(端渲染地标点示意图)

目前,图观™统一开发API和接口调试器支持添加和调试:市政设施、地点建筑、人员、交通、飞行器、事件、地名等要素,您只需进行低代码修改,即可自定义在场景中绘制地标数据数据。

实用技巧内容

基于图观™统一开发API和接口调试器,通过低代码调整即可便捷实现地标点的绘制和调试,配置结果所见即所得,具体操作如下:

· 添加地标点

功能描述:在三维场景中添加地标点。

调用方法:

参考描述:

属性 类型 说明
id String 图层 ID (唯一标识)
coordType Number 图层对象 id,新建时调用者自己传入的唯一标识,用于各种操作的对象识别 目前该属性仅支持属性值为 0
coordTypeZ Number Z 轴坐标类别,0:相对 3D 世界 0 海拔;1:相对 3D 世界地表;2:相对 3D 模型表面(单位:米) 目前该属性仅支持属性值为 0
iconName String 内置图标名称,或根据项目,在场景中预置好的图标对象的名称,包含文字样式定义,具体图标名称参考下表和下图
label String 图标标签文本
coord Array XY 轴坐标,X: 经度;Y:纬度
coordZ Number Z 轴高度(单位:米)

具体内置图标名称(iconName)详情:

具体内置图标名称(iconName)效果:

回调数据

回调数据参数描述:

属性 类型 说明
result Number 1:代表成功;0:代表失败
message String 成功或者失败原因

· 更新地标点数据

功能描述:更新三维场景中地标点数据

调用方法:

参数描述:

属性 类型 说明
id String 图层对象 id,新建时调用者自己传入的唯一标识,用于各种操作的对象识别
coordType Number 图层对象 id,新建时调用者自己传入的唯一标识,用于各种操作的对象识别 目前该属性仅支持属性值为 0
coordTypeZ Number Z 轴坐标类别,0:相对 3D 世界 0 海拔;1:相对 3D 世界地表;2:相对 3D 模型表面(单位:米) 目前该属性仅支持属性值为 0
coord Array XY 轴坐标,X:经度;Y:纬度
coordZ Number Z 轴高度(单位:米)

回调数据:

回调数据参数描述:

属性 类型 说明
result Number 1:代表成功;0:代表失败
message String 成功或者失败原因

·更新 地标点样式

功能描述:更新三维场景中地标点样式

调用方法:

属性 类型 说明
id String 图层对象 id,新建时调用者自己传入的唯一标识,用于各种操作的对象识别
iconName String 内置图标名称,或根据项目,在场景中预置好的图标对象的名称,包含文字样式定义,具体图标名称参考上表和上图
label String 图标标签文本

回调数据:

回调数据参数描述:

属性 类型 说明
result Number 1:代表成功;0:代表失败
message String 成功或者失败原因

· 查询地标在点屏幕位置

功能描述:查询地标点在屏幕上位置

调用方法:

参数描述:

查询地标点基于控件矩形区域的 左上角、右上角的位置基于三维场景渲染窗口左上角比值基于三维场景渲染窗口右下角比值回调数据:

回调数据参数描述:

属性 类型 说明
result Number 1:代表成功;0:代表失败
message String 成功或者失败原因
id String 图层对象 id,新建时调用者自己传入的唯一标识,用于各种操作的对象识别
ndc Array Native Device Coordinate:左上角为 -1, -1,右下角为 1, 1
screenPosition Array 屏幕像素坐标,左上角为 0, 0


· 删除地标点

功能描述:删除地标点

调用方法:

参数描述:

属性 类型 说明
id String 图层对象 id,新建时调用者自己传入的唯一标识,用于各种操作的对象识别
overlayType String 图层对象类别

回调数据:

回调数据参数描述:

属性 类型 说明
result Number 1:代表成功;0:代表失败
message String 成功或者失败原因

本篇内容主要围绕地标点添加、更新、查询、删除等基本操作,下篇,小编将整理“ 地标点事件”相关实用指南,记得一定要关注我们哦~

图观™

图观™国产数字孪生应用开发引擎,提供云端三维场景构建、全要素数据融合、场景效果设计、场景服务发布全流程工具,以及基于用户自定义场景的二次开发 SDK,是用户构建数字孪生应用的强有力软件工具包。图观™具有兼顾高渲染效果和大并发访问的双渲染内核,具备大中小屏投放的跨终端渲染能力, 渲染内核技术完全自研可控,不受外国技术制约,充分确保用户系统建设的安全需要。

-官网进入: tuguan.net/login.html

-《 统一开发手册》详细介绍传送地址: tuguan.net/doc/tg-api/


9.16日,图观™数字孪生可视化引擎新版本上线了,新版本更新了端渲染场景编辑器部分功能,新增统一接口调试器、统一开发 API功能,详情可点击详情可 点击产品|图观™V3.0全新上线查看

为了更好的帮助伙伴们打造属于自己的3D可视化场景,助推企业开拓市场。图观™重磅推出 数字孪生精品助推计划,详情可点击蓝字查看


请使用浏览器的分享功能分享到微信等