
FreeMoCap 开源动作捕捉教程用普通摄像头生成 3D 骨骼运动数据【免费下载链接】freemocapFree Motion Capture for Everyone ✨项目地址: https://gitcode.com/GitHub_Trending/fr/freemocap把 3 台普通 USB 摄像头架在房间三边让一人在镜头前走一段路处理完成后你会得到逐帧的 3D 骨骼坐标文件.npy还可以直接导出成带骨骼网格、相机视锥和地面参考平面的 Blender 场景文件。这个从录制到 3D 重建的完整流程就是 FreeMoCap——一个免费、开源、硬件无关的多摄像头动作捕捉系统不需要动捕服也不需要反光标记点。它是什么解决了什么问题FreeMoCap 的定位是研究级的低成本动作捕捉平台用你能买到的消费级设备产出科研可用的运动数据。无标记点依赖 AI 姿态检测MediaPipe / RTMPose识别人体关键点人空手站在镜头前即可被捕捉硬件无关任何 OpenCV 能驱动的 USB 摄像头都能用文档中测过 Logitech C920/C922/Brio也可以搭配 Cam Link 接微单相机数量灵活2 台可做单平面基础捕捉3-4 台适合大多数全身动作5 台以上可处理遮挡可复现的数据流处理管线校准、三角测量、后处理都在 freemocap/core/pipeline/ 中以节点化模块实现每一步的中间结果落盘可查AGPLv3 许可代码完全开放可审计个人学习和内部使用免费从视频到 3D 骨骼工作原理整个流程可以拆成 4 个阶段理解它们之后你就知道每一步为什么重要。1. 多机位录制与同步。各台摄像头独立录制系统负责帧级对齐输出一个synchronized_videos文件夹里面每台相机的视频帧号严格对应同一时刻。2. ChArUco 标定板校准。这是 FreeMoCap 最有特色的环节用一张棋盘格与 ArUco 标记混合的标定板建立世界坐标系确定每台相机的内参、外参并把地面定义为 Z0 平面。标定板样式如下项目仓库里提供了可直接打印的高清版本标定的含义是测量板子上的物理距离从而把像素坐标换算成真实尺度标定逻辑在 freemocap/core/tasks/calibration/包含 ChArUco 角点检测、观测聚合、外参求解等模块。一个注意点标定只在摄像头位置不变时有效动了相机就要重新标定。3. 2D 关键点检测 多视角三角测量。每台相机的每一帧上检测器先标出人体 2D 关键点然后 freemocap/core/triangulation/ 用各台相机的 2D 观测交叉定位出 3D 坐标并内置离群值剔除和重投影误差检查——某台相机在这一帧看错了时它会被降级或丢弃而不是把坏点写进最终数据。4. 后处理与输出。三角测量出的原始轨迹会经过平滑、刚性约束骨骼长度保持恒定等处理输出身体、左右手、全身体质心等 .npy 文件。如果你装了 Blender点击导出即可一键生成 .blend 场景背后由 freemocap/core/blender/ 以--background模式驱动 Blender 完成详见 Blender 导出指南目前 Blender 导出仅支持 MediaPipe 输出的数据。谁在用它能用到哪儿运动科学 / 康复研究者搭 3-4 台摄像头的小型捕捉角采集步态或康复患者的动作序列用输出的骨骼轨迹做时间-角度分析整套硬件成本远低于商用系统独立游戏 / 动画开发者录制一段表演后处理导出的 .blend 文件里骨骼已经挂好可以直接作为角色动画参考或进一步调整批量录制还能建小动作库教学与演示ChArUco 标定、多视角三角测量本身就是一堂计算机视觉实验课项目文档目录 freemocap-docs/docs/ 里有从摄像头布置到后处理的完整指南适合作实验材料从零跑起来安装与首次运行方式一pip 安装推荐新手FreeMoCap 支持 Python 3.9–3.11推荐 3.11。安装时必须指定cuda或cpu扩展裸装不带检测器pip install freemocap[cuda] # Windows/Linux NVIDIA 显卡 # 或 pip install freemocap[cpu] # macOS或没有可用 GPU 的机器然后启动 GUIfreemocap弹出 Electron 窗口后按向导连接摄像头、拍摄 ChArUco 标定板完成校准再开始录制即可。方式二源码运行适合开发者git clone https://gitcode.com/GitHub_Trending/fr/freemocap cd freemocap uv venv uv sync uv run python freemocap/__main__.py服务默认跑在http://localhost:8005。另开一个终端启动前端需 Node.jscd freemocap-ui npm install npm run devuv sync会自动选择 GPU 加速或 CPU 版本没有支持 GPU 的机器可以改用uv sync --no-default-groups --group cpu。拍摄布置的两个实用建议详见 摄像头设置指南摄像头略高于捕捉区域、向下倾斜约 15-30°多台相机尽量分散在不同 USB 控制器上避免带宽不足掉帧。进阶文档、测试与开发分支使用文档仓库内 freemocap-docs/docs/ 收录架构说明、摄像头设置、后处理post-hoc流程、Blender 导出、GPU 设置等指南后处理工作流可参考 freemocap-docs/docs/guides/posthoc-mocap.mdx测试单元与管线测试集中在 freemocap/tests/覆盖三角测量离群剔除、刚体化、人体测量、实时管线等跑测试前建议先读 TESTING.md开发分支主干 README 顶部专门给了/development分支的说明功能更新比稳定发布更快但可能不稳定贡献代码先读 CONTRIBUTING.mdBug 修复、文档改进、测试用例都是低门槛的切入点第一次运行如果出问题从摄像头是否被系统识别 → 标定板是否清晰无畸变 → 是否重新标定这个顺序排查能解决大多数情况。现在装一个freemocap架好三台摄像头录你的第一条 3D 动作序列吧。【免费下载链接】freemocapFree Motion Capture for Everyone ✨项目地址: https://gitcode.com/GitHub_Trending/fr/freemocap创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考