轻量级 STL 3D 模型 PNG 渲染工具，纯软件实现零依赖，一键生成营销级预览图
说明：
## 核心用法
`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 等专业渲染器。
