render-stl-png

将 STL 文件渲染为 PNG 图像，采用美观、一致的 3D 视角（类似 Blender 的默认透视效果）和纯色外观。

这是一个确定性软件渲染器：
- 无需 OpenGL
- 无需依赖 Blender
- 使用简易相机、Z 缓冲和朗伯着色

输入

• STL 文件路径（支持 ASCII 或二进制格式）
• 输出 PNG 路径

参数

• --size <px>：图像宽度/高度（正方形），默认 1024
• --bg "#rrggbb"：背景颜色，默认 #0b0f14
• --color "#rrggbb"：模型基础颜色，默认 #4cc9f0
• --azim-deg <deg>：相机绕 Z 轴的方位角，默认 -35
• --elev-deg <deg>：相机仰角，默认 25
• --fov-deg <deg>：透视视场角，默认 35
• --margin <0..0.4>：视图边距比例，默认 0.08
• --light-dir "x,y,z"：定向光向量，默认 -0.4,-0.3,1.0

使用方法

单次渲染

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

使用封装脚本（推荐）

封装脚本会创建缓存的虚拟环境（确保 pillow 可用）并运行渲染器。

bash scripts/render_stl_png.sh /path/to/model.stl /tmp/model.png --color "#ffb703"

说明

• 本工具适用于宣传/预览图片，不追求照片级真实感。
• 如需影棚灯光/材质效果，请使用 Blender。但本工具能以快速、可复现的方式满足 80% 的常规需求。