Viewer

概览

Viewer是基于@manycore/aholo-viewer搭建的快速在线查看器，可以导入任意支持的资源直接查看展示效果，支持由@manycore/aholo-splat-transform生成的lod格式数据

由于浏览器无法直接访问本地文件，对于chunk-lod的数据，需要使用服务器或者CDN承载。可以使用@manycore/aholo-splat-dev-server快速承载。

使用指南

• 左侧面板用于导入支持的格式数据和配置相机

  支持导入本地文件，url和剪贴板数据(url)，如果使用本地数据，仅支持完整的单个数据，不支持chunk-lod形式的数据。

  相机提供可3种可切换的坐标系: OpenCV(-Y为上方向，点云坐标系)，OpenGL(+Y为上方向，常规模型坐标系)，Aholo(+Z为上方向，aholo平台数据默认坐标系)。

• 右侧面板用于控制3DGS相关功能和管线配置，可以参考3dgs-preset-config

本地搭建快速验证平台

安装相关依赖

npm install @manycore/aholo-splat-transform -g
npm install @manycore/aholo-splat-dev-server -g

使用方式

@manycore/aholo-splat-transform完整使用指南可以参考使用指南，此处不再赘述。

@manycore/aholo-splat-dev-server

@manycore/aholo-splat-dev-server提供两个可执行命令，splat-dev-server是一个完整的本地快速承载服务，提供了快速承载相关资源， merge-lod提供将多个lod-meta.json和相关资源合并成一个新的lod-meta.json，用于将分块处理的大型3DGS文件chunk-lod合并回一个。

• splat-dev-server: 用于启动快速承载Viewer使用的资源的服务器

  splat-dev-server [options] <dir>
  Options:
     --help     Show help                                             [boolean]
     --version  Show version number                                   [boolean]
  -a, --address  Address to listen               [string] [default: "127.0.0.1"]
  -p, --port     Port to listen                         [number] [default: 3000]

  启动后可看到如下输出

  ========================================
  Splat dev server started
  Host: 127.0.0.1:3000
  Root: ./chunk-lod
  Base URL: http://127.0.0.1:3000
  ========================================

  通过Base URL访问Root下资源即可，可以直接填入Viewer对应的位置。

  注意：当在Viewer种使用时浏览器可能弹出权限要求，请允许。Viewer不会访问未被承载的资源，也不会收集任何用户信息。

• merge-lod: 用于把多个chunk-lod的生成结果合并为一个，通常用于分块生成chunk-lod后合并为一个完整的大型chunk-lod

  merge-lod -i <meta-files...> -o <output_dir>
  
  Options:
       --help     Show help                                             [boolean]
       --version  Show version number                                   [boolean]
   -i, --input    Input lod meta files(lod-meta.json)          [array] [required]
   -o, --output   Output directory                            [string] [required]