STL转PNG渲染

技能简介

将STL格式的3D模型文件渲染为PNG图片，采用固定的”类Blender”默认视角，无需OpenGL或Blender依赖，通过纯软件实现确定性渲染。

能做什么

• 从STL文件（ASCII或二进制格式）生成带光照的3D预览图
• 自定义图片尺寸、背景色、模型颜色、相机角度和光源方向
• 通过包装脚本自动创建虚拟环境并安装依赖，简化使用流程
• 批量生成风格一致的营销或展示用缩略图

使用说明

安装准备

该技能依赖Python 3和pillow库。推荐使用包装脚本自动处理环境：

bash scripts/render_stl_png.sh /path/to/model.stl /tmp/model.png

直接运行（需手动安装依赖）

pip install pillow
python3 scripts/render_stl_png.py --stl /path/to/model.stl --out /tmp/model.png

常用参数示例

python3 scripts/render_stl_png.py \
  --stl /path/to/model.stl \
  --out /tmp/model.png \
  --size 1200 \
  --color "#ffb703" \
  --bg "#0b0f14" \
  --azim-deg -35 \
  --elev-deg 25

输入与输出

见下方输入与输出表格。

风险提示

• 本工具用于营销/预览图片，非照片级真实感渲染
• 需要专业灯光和材质效果时，建议使用Blender替代
• 大型STL文件可能消耗较多内存和处理时间
• 软件渲染速度低于GPU加速方案

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/ajmwagar/render-stl-png/SKILL.md
来源类型：GitHub仓库