本文主要介绍临云镜标注工具 SDK 基于全景图像的空间标注能力,包括空间结构、墙线、门、窗、虚拟墙、凹凸墙、特征区等标注行为,以及如何进行空间关联、特征关联的操作,调用OpenAPI进行重建与预览的整体流程。
标注工具SDK简介
临云镜标注工具 SDK 基于全景图像的空间标注能力,SDK可通过NPM及编译后的JS库进行集成开发,嵌入到Web前端页面中为用户提供模型标注的相关能力,SDK包括以下几个主要组成部分:
Canvas
: 提供了全景图像的二维空间结构渲染,包含空间结构、墙线、门、窗、虚拟墙等标注操作,以及标注的样式配置及事件监听。Pano
:提供了全景图像的三维空间结构渲染,包含墙线、门、窗、凹凸墙,以及墙高、空间旋转、垂直矫正等操作。Plane
: 提供了对标注空间的二维平面图预览。Preview
: 提供了对标注空间的三维模型预览。
更多关于标注工具SDK的使用和功能说明可参看:《标注工具SDK开发文档》。
1、空间标注(Canvas & Pano)
空间标注是对空间结构及特征物进行特定标注的行为,以实现空间重建时对各类特征进行算法及渲染效果的处理,目前提供透视视图及全景视图两种标注模式进行标注。
【透视视图】示意
【全景视图】示意
标注功能
包括空间结构、墙线、门、窗、虚拟墙、凹凸墙、特征区,对应在临云镜云端标注工具的功能如下所示:
2、空间关联
空间关联是指不同空间之间需要通过已标注的【门】、【虚拟墙】、【特征】建立关联关系,来确定整体的三维重建效果。需要调用OpenAPI提交相应的关联关系,具体详见【提交关联关系】示例。
关联关系:门关联、虚拟墙关联、特征关联。
门关联、虚拟墙关联是实现多个不同空间的相互关联关系,也称外关联。特征关联是指单个空间中拍摄了多个点位后,可以在该空间中找到共同可见的同一特征物进行标注,实现单房间多图的位置标定,也称内关联。
临云镜在公有云标注工具中的关联示例:门/虚拟墙关联操作,可以通过【全景视图】双击指定的门/虚拟墙进行关联,也可以通过【实时演算】进行双击,进行连线关联。
标注工具SDK默认不提供任何关联操作,仅提供相应的事件响应/监听接口,请根据具体交互设计进行二次开发,以实现个性化的关联交互方案。
3、平面/模型预览(Plane & Preview)
提供了对标注空间的二维平面图以及三维模型的预览,需要开发者拥有一定的绘图基础,进行个性化开发与交互设计。
【平面预览】示意
【三维预览】示意
3、重建预览
空间重建是指基于标注工具进行场景标注后的结果,通过OpenAPI上传到云端后,通过空间重建算法进行三维建模的操作。需要调用OpenAPI提交相应的关联关系,具体详见【重建预览】示例。
此部分是标注工具SDK以外的部分,主要以调用OpenAPI为主,需要与标注工具SDK协同使用,才可以看到每次标注后的重建结果,用于模型标注的调优,建议与服务端协同开发。