核心用法
render-stl-png 是一款专为快速生成 STL 模型预览图设计的确定性软件渲染器。用户只需提供 STL 文件路径（ASCII 或二进制格式）和输出 PNG 路径，即可从类 Blender 默认视角生成标准化的 3D 渲染图。
关键参数控制
- 图像尺寸：
--size控制正方形画布像素（默认 1024px） - 视觉风格：
--color设置模型基色，--bg设置背景色，支持 HEX 色值 - 相机视角：
--azim-deg（方位角 -35°）、--elev-deg（仰角 25°）、--fov-deg（视野 35°）复刻经典 3D 软件默认视角 - 构图边距：
--margin（0-0.4）控制模型与边缘留白比例 - 光源方向：
--light-dir自定义平行光向量
执行方式
支持直接 Python 调用，或更推荐的 Bash 包装脚本（自动管理虚拟环境与 pillow 依赖）。
显著优点
| 优势 | 说明 |
|------|------|
| **零外部依赖** | 纯 Python 实现，无 OpenGL、无 Blender、无 GPU 要求 |
| **确定性输出** | 相同输入参数必得相同像素结果，适合 CI/CD 自动化 |
| **极轻量快速** | 秒级渲染，无需等待重型软件启动 |
| **参数化可控** | 所有视觉要素均可通过命令行精确复现 |
| **CI 友好** | 包装脚本自动处理虚拟环境，即插即用 |
潜在缺点与局限性
- 非真实感渲染：采用简单 Lambert 漫反射着色，无阴影、无环境光遮蔽、无材质系统
- 单光源限制：仅支持单一方向光，无法实现复杂布光
- 固定视角范式：虽可调参数，但缺乏交互式取景能力
- 正方形画布：输出强制 1:1 比例，宽幅/竖幅构图需后期裁剪
- 无动画/批量：单次单模型渲染，大规模批处理需自行脚本化
适合人群
- 需要为 3D 打印模型快速生成电商/文档预览图的开发者
- 在 CI 流水线中自动化生成产品缩略图的 DevOps 工程师
- 追求"80% 效果、20% 时间"效率比的设计师
- 资源受限环境（无 GPU/无图形界面服务器）下的渲染需求
常规风险
| 风险类别 | 评估 | 说明 |
|---------|------|------|
| 文件安全 | 低 | 仅读取 STL 二进制/文本数据，无网络通信 |
| 依赖安全 | 低 | 仅依赖 pillow（PIL）图像库，主流成熟包 |
| 资源消耗 | 极低 | CPU 软渲染，内存占用与图像尺寸平方成正比（1024px 约数 MB） |
| 输出一致性 | 需注意 | 不同 pillow 版本可能存在像素级差异，建议锁定版本 |
> 明确定位：本工具专为营销/预览场景优化，如需照片级真实感或复杂材质表现，请迁移至 Blender Cycles/Octane 等专业渲染器。