文档

概述

更新时间:

本文主要介绍临云镜标注工具 SDK 基于全景图像的空间标注能力,包括空间结构、墙线、门、窗、虚拟墙、凹凸墙、特征区等标注行为,以及如何进行空间关联、特征关联的操作,调用OpenAPI进行重建与预览的整体流程。

标注工具SDK简介

临云镜标注工具 SDK 基于全景图像的空间标注能力,SDK可通过NPM及编译后的JS库进行集成开发,嵌入到Web前端页面中为用户提供模型标注的相关能力,SDK包括以下几个主要组成部分:

  1. Canvas: 提供了全景图像的二维空间结构渲染,包含空间结构、墙线、门、窗、虚拟墙等标注操作,以及标注的样式配置及事件监听。

  2. Pano:提供了全景图像的三维空间结构渲染,包含墙线、门、窗、凹凸墙,以及墙高、空间旋转、垂直矫正等操作。

  3. Plane: 提供了对标注空间的二维平面图预览。

  4. Preview: 提供了对标注空间的三维模型预览。

更多关于标注工具SDK的使用和功能说明可参看:《标注工具SDK开发文档》。

1、空间标注(Canvas & Pano)

空间标注是对空间结构及特征物进行特定标注的行为,以实现空间重建时对各类特征进行算法及渲染效果的处理,目前提供透视视图及全景视图两种标注模式进行标注。

  • 【透视视图】示意

透视模式

  • 【全景视图】示意

全景视图

  • 标注功能

包括空间结构、墙线、门、窗、虚拟墙、凹凸墙、特征区,对应在临云镜云端标注工具的功能如下所示:

image.png

2、空间关联

空间关联是指不同空间之间需要通过已标注的【门】、【虚拟墙】、【特征】建立关联关系,来确定整体的三维重建效果。需要调用OpenAPI提交相应的关联关系,具体详见【提交关联关系】示例。

关联关系:门关联、虚拟墙关联、特征关联。

说明

门关联、虚拟墙关联是实现多个不同空间的相互关联关系,也称外关联。特征关联是指单个空间中拍摄了多个点位后,可以在该空间中找到共同可见的同一特征物进行标注,实现单房间多图的位置标定,也称内关联。

临云镜在公有云标注工具中的关联示例:门/虚拟墙关联操作,可以通过【全景视图】双击指定的门/虚拟墙进行关联,也可以通过【实时演算】进行双击,进行连线关联。

说明

标注工具SDK默认不提供任何关联操作,仅提供相应的事件响应/监听接口,请根据具体交互设计进行二次开发,以实现个性化的关联交互方案。

3、平面/模型预览(Plane & Preview)

提供了对标注空间的二维平面图以及三维模型的预览,需要开发者拥有一定的绘图基础,进行个性化开发与交互设计。

  • 【平面预览】示意

平面预览
  • 【三维预览】示意

三维预览

3、重建预览

空间重建是指基于标注工具进行场景标注后的结果,通过OpenAPI上传到云端后,通过空间重建算法进行三维建模的操作。需要调用OpenAPI提交相应的关联关系,具体详见【重建预览】示例。

说明

此部分是标注工具SDK以外的部分,主要以调用OpenAPI为主,需要与标注工具SDK协同使用,才可以看到每次标注后的重建结果,用于模型标注的调优,建议与服务端协同开发。