ScanDot README

项目的 README,来自 github.com/faizfahmi77/ScanDot。合并为一个 markdown 文件:README.md。

ScanDot

CI

ScanDot is an experimental Android app for capturing and viewing 3D point clouds on a supported phone. It combines ARCore camera tracking and depth estimates, saves scans locally, and provides an interactive viewer.

The repository also contains a separate video photogrammetry pipeline that runs on a workstation using FFmpeg and COLMAP. The Android app does not reconstruct ordinary video with photogrammetry on the phone.

Current status

This is an early prototype. Results can contain gaps, drift and noise; they are not textured meshes or validated measurements. Reflective, transparent and textureless subjects are difficult. Capture quality and device compatibility need further testing.

Try the preview

Download the preview APK. The release notes describe compatibility and signing limitations.

Build the Android app

You need JDK 17, Android SDK 36, and an Android device with ARCore Depth support. Camera permission is required; Google Play Services for AR may require installation or an update.

cd android-app
./gradlew assembleDebug lintDebug testDebugUnitTest

On Windows, use gradlew.bat in place of ./gradlew. The debug APK is written to android-app/app/build/outputs/apk/debug/app-debug.apk. Install it as an update to preserve existing app data.

In the app, name the scan, tap Start scan, and move slowly around the subject in good light. Save it, then open it from Results. Scans are stored in the app's private storage; uninstalling the app removes them.

Workstation video pipeline

The benchmark requires Python 3.12 or newer, FFmpeg, FFprobe and a compatible COLMAP installation. Dense reconstruction requires a compatible COLMAP configuration. From the repository root:

python -m processing.benchmark prepare "path/to/input.mp4" --output "path/to/new-run" --fps 5
python -m processing.benchmark reconstruct "path/to/new-run" --colmap "path/to/colmap" --dense

The output directory must not already exist. Omit --dense for a sparse-only run. See the subcommand --help output for options. A successful run does not establish complete or accurate geometry.

The Python tests use the standard library:

python -m unittest discover -s tests -v

Project structure

android-app/  Android capture, local storage and point-cloud viewer
processing/   Video preparation and COLMAP orchestration
tests/        Python tests with synthetic fixtures
tools/        Workstation utilities

CI runs the Android build, lint and JVM tests, plus the Python unit tests. It does not exercise a camera, ARCore tracking, GPU reconstruction or measurement accuracy.

See the wiki for installation, capture and troubleshooting guides. See CONTRIBUTING.md for development checks and LICENSE for reuse terms.

ScanDot (faizfahmi77/ScanDot)

正在搜索数据库…

这是什么?这是一款实验性的 Android 应用,可在支持的手机上采集三维点云,将其保存在本地,并通过交互式查看器进行查看。
这只是手机应用,还是也有桌面工具?主要是手机应用。仓库中还有一套单独的 Python 视频处理流程,需要在工作站上运行,并依赖 FFmpeg 和 COLMAP,但手机应用本身不会对视频进行摄影测量。
不自己构建,怎么试用?下载预览版 APK 并安装即可。发布说明中包含兼容性和签名方面的限制。
能用扫描结果来测量东西吗?不能。结果可能存在缺失、漂移和噪点。它们不是带纹理的网格模型,也没有经过验证的测量精度;反光、透明或没有纹理的物体很难采集。
支持哪些手机?只有支持 ARCore Depth 的手机才能采集和重新打开扫描结果。可能需要安装或更新 Google Play 服务中的 AR 组件,并且应用需要相机权限。
我的扫描结果保存在哪里?保存在手机上应用的私有存储空间中。卸载应用后,这些数据会被一并删除。
全深度模式有什么作用?它会对缺失的深度信息进行插值,以填补扫描中的空缺,但可能会使表面变形,因此 README 将其列为可选模式。
能用普通手机视频生成三维模型吗?手机上不行。需要在工作站上运行单独的流程:使用 FFmpeg 提取帧,再运行稀疏或稠密的 COLMAP 重建。不过 README specifies 说明,即使运行成功,也不能保证几何结构完整或准确。
在查看器中,已保存的扫描结果可以做什么?可以旋转、平移和缩放,之后也可以在“结果”中重新打开。
自动化检查涵盖哪些内容?CI 会运行 Android 构建、lint、JVM 测试和 Python 单元测试。它不测试相机、ARCore 跟踪、GPU 重建或测量精度。
大小
0.1 MB
星标
544
更新
提交Nov 13
时长
5天
提交 · 90 天