AnimatedDrawings 常见问题排查让手绘角色动起来时的 9 个报错逐个讲清楚【免费下载链接】AnimatedDrawingsCode to accompany A Method for Animating Childrens Drawings of the Human Figure项目地址: https://gitcode.com/GitHub_Trending/an/AnimatedDrawingsAnimatedDrawings 是一个把你二维手绘角色变成动画的工具。围绕它的故障排除本文把安装、起标注服务、导出动画这几步最容易卡住的地方按你会看到什么现象整理成可照着做的修复步骤每个都附确认修好的办法。下面按修复要花多少功夫分成四组。哪组卡住就从哪组看起。快速修装环境、开服务、改端口几分钟搞定conda 建环境就报架构错在 M1/M2 的 Mac 上执行conda create --name animated_drawings python3.8.13时如果将要安装的包里全是osx-64Intel 架构的字样说明 conda 装错了架构。处理打开~/.condarc把subdirs改成只留osx-arm64和noarch删掉osx-64再清缓存重建conda clean --all conda create --name animated_drawings python3.8.13 --yespip 卡在 PyOpenGLpip install -e .在 PyOpenGL 那一步报错多半是缺系统图形库。先装系统依赖再把 PyOpenGL 固定到项目锁定的版本3.1.6最后重装# Ubuntu sudo apt-get install libgl1-mesa-dev libglu1-mesa-dev freeglut3-dev # macOS brew install freeglut pip install PyOpenGL3.1.6 pip install -e .启动时端口被占用本地跑 TorchServe 时如果报 8080/8081 端口被占先查出占用的进程结束它lsof -i :8080 kill -9 PID或者干脆换个端口启动避开冲突。改完再 ping 一下确认返回{status: Healthy}。重跑一步Docker 无响应、标注不准Docker 里 ping 一直没有响应docker run之后访问http://localhost:8080/ping等一会儿仍无反应或返回空。通常是服务没初始化完或给 Docker 的内存太小。处理先再等 10 秒重试同时看容器日志确认初始化状态docker logs docker_torchserve日志里若是内存或 CUDA 相关报错把 Docker Desktop 内存调到 16GB或加-e CPU_ONLYtrue用 CPU 方式启动。正常时 ping 返回 Healthy。检测不到人标注文件是空的跑python image_to_animation.py drawings/garlic.png garlic_out后标注目录是空的说明模型没认出人。问题多在图本身。处理人物尽量正面、线条清晰、背景干净尺寸落在 512~1024 之间比较稳然后重跑。关节点歪了或者 mask 残缺关节位置不对时跑标注修正工具在浏览器里把关节拖到正确位置再提交python fix_annotations.py garlic_out/它会在 http://127.0.0.1:5050 起网页端口可用--port改。若 mask角色与背景的分离图有缺用绘图软件手补角色区域纯白、背景纯黑。改完重新出动画python annotations_to_animation.py garlic_out动画不对劲导不出、角色扭曲、多人重叠导出后没文件或文件打不开用render.start(...)跑导出却拿不到视频或文件损坏。先查OUTPUT_VIDEO_PATH指向的目录能不能写再确认配置里controller的MODE是video_render。MP4 用avc1这类常见编码器想要透明背景就导出 gif 而不是 mp4。controller: MODE: video_render OUTPUT_VIDEO_PATH: ./output/high_quality.mp4 OUTPUT_VIDEO_CODEC: avc1角色扭来扭去关节角度怪肢体翻转或角度异常几乎都是骨骼映射没对上。改对应 retarget 配置里的char_joint_bvh_joints_mapping把角色关节映射到正确的 BVH 关节或直接换一份和你动作骨架匹配的 retarget 配置examples/config/retarget/下有多种骨架可选。多角色叠在一起多角色场景里角色互相遮挡是因为起点相同。在场景配置ANIMATED_CHARACTERS里给每个角色不同的starting_location一个左移一个右移就分开了。全都不行的兜底看日志、跑测试、找文档先读日志直接以模块方式运行python -m animated_drawings.render 你的config.yaml时DEBUG 级日志会写到当前目录的log.txt。重点看标注阶段检测/分割、重定向阶段骨骼映射、渲染阶段窗口/导出三处报错。跑官方测试自证系统没问题分不清是环境坏了还是自己的配置写错就跑一遍官方测试pytest tests/test_render.py测试能过说明核心链路是好的问题多半出在你自己的配置或素材上。文档和社区入口每个配置字段怎么写都写在 examples/config/README.md 里拿不准的字段先翻这里。交互式窗口、导出等场景有现成示例比如 examples/config/mvc/interactive_window_example.yaml。项目的贡献与问题反馈流程见 CONTRIBUTING.md。【免费下载链接】AnimatedDrawingsCode to accompany A Method for Animating Childrens Drawings of the Human Figure项目地址: https://gitcode.com/GitHub_Trending/an/AnimatedDrawings创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考