渲染STL为PNG

从一个美观、一致的3D角度（类似Blender的默认透视视角）将STL文件渲染为PNG，并采用纯色填充。

这是一个确定性软件渲染器：

• 无需OpenGL
• 无需依赖Blender
• 采用简易相机 + Z缓冲 + 朗伯着色

输入

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

参数

• --size <像素数>：图像宽度/高度（正方形），默认值为1024
• --bg "#rrggbb"：背景颜色，默认值为#0b0f14
• --color "#rrggbb"：网格基础颜色，默认值为#4cc9f0
• --azim-deg <角度>：相机绕Z轴的方位角，默认值-35
• --elev-deg <角度>：相机仰角，默认值25
• --fov-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%的效果。