Skip to content

Chen-starry/3dgs-detail-zoom-annotator

Repository files navigation

3DGS Detail Zoom Annotator

一个面向论文配图、实验可视化和 3DGS 对比图制作的轻量级浏览器工具。

很多 3DGS / 重建 / 生成任务的可视化图都会用到“局部框选 + 放大标注”这种表达方式,但真正顺手、开箱即用、还支持批量同步位置的开源小工具并不多。这个项目就是在实际做毕设和论文配图时,为了自用效率写出来的。

Online Demo

https://chen-starry.github.io/3dgs-detail-zoom-annotator/

Features

  • 支持单张或多张图片导入
  • 支持在多张图片的同一相对位置统一框选细节
  • 支持拖动原图中的虚线框
  • 支持拖动放大后的实线框到任意位置
  • 支持调整放大倍率、线条颜色、线条粗细
  • 支持单张导出
  • 支持多张图片打包导出为 ZIP
  • 支持自定义 ZIP 文件名
  • 支持选择固定导出目录
  • 浏览器不支持路径写入时,会自动回退到系统另存为或普通下载
  • 纯前端静态项目,无后端、无数据库、无构建步骤

Use Cases

  • 3DGS / Gaussian Splatting 可视化对比图
  • NeRF / 3D 重建论文图表
  • 消融实验细节放大图
  • 图像修复 / 超分 / 去噪结果对比
  • 任何需要“框选局部细节并放大覆盖”的科研配图场景

Quick Start

Option 1: Direct Open

直接双击打开 index.html 即可使用。

Option 2: Local Static Server

如果你想使用“选择导出路径”功能,推荐在本地起一个静态服务:

python3 -m http.server 8000

然后打开:

http://localhost:8000/

How To Use

  1. 点击“导入图片(可多选)”
  2. 在当前图片上拖出红色虚线框,选择细节区域
  3. 如需调整原始选区,直接拖动虚线框
  4. 如需调整放大图位置,直接拖动放大后的红色实线框
  5. 在左侧调整倍率、线宽、颜色和默认边距
  6. 如果是多张图,可在左侧列表中切换预览
  7. 单张导出点击“导出当前”
  8. 多张导出点击“导出全部 ZIP”

Export Path

项目支持三种导出方式,按优先级自动选择:

  1. 固定导出目录
  2. 系统另存为窗口
  3. 普通浏览器下载

说明:

  • 如果你先点击了“选择导出路径”,之后单张和批量导出都会优先写入这个目录
  • 如果没有固定目录,但浏览器支持文件保存 API,会弹出系统保存窗口
  • 如果浏览器不支持上述能力,则自动回退为普通下载

Browser Support

基础功能在现代浏览器中都可用,包括:

  • Chrome
  • Edge
  • Safari
  • Firefox

但“选择导出路径”依赖 File System Access API,更推荐:

  • Chrome
  • Edge

在 Safari / Firefox 中,通常会回退到:

  • 系统另存为
  • 或普通下载

FAQ

需要 Node.js 吗?

不需要。直接打开 index.html 就能用。

为什么“选择导出路径”按钮有时不可用?

因为这个功能依赖浏览器的文件系统访问能力。

建议:

  • 使用 Chrome 或 Edge
  • 使用 http://localhost 或 HTTPS 环境打开页面

为什么批量导出是 ZIP?

多图逐张下载会触发大量浏览器下载弹窗,体验比较差。ZIP 更适合论文配图和批量结果整理。

Roadmap

  • 连接线 / 引导线样式
  • 多个局部放大框
  • 标注文字 / 序号
  • 更丰富的边框样式
  • 更灵活的导出尺寸控制

License

本项目当前采用 MIT License

Third-Party

项目内包含一个第三方依赖:

  • JSZip v3.10.1,用于批量导出 ZIP

详细说明见:

About

A lightweight browser tool for creating detail zoom annotations for 3DGS and paper figures

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors