Stp2Glb/USAGE.md

STP2GLB 使用说明

STP2GLB 支持两种运行模式：CLI命令行模式 和 HTTP服务器模式

---

CLI 命令行模式

基本用法

1. 本地文件转换

STP2GLB.exe --stp input.stp --glb output.glb

2. HTTP URL转换（新功能）

STP2GLB.exe --stp https://example.com/model.stp --glb output.glb

主要参数

参数	说明	默认值	范围
--stp	STP文件路径或HTTP/HTTPS URL（必填）	-	本地路径或URL
--glb	输出GLB文件路径（必填）	-	本地路径
--lin-defl	线性偏差	0.5	0.0-1.0
--ang-defl	角度偏差	0.8	0.0-1.0
--rel-defl	相对偏差模式	false	-
--debug	调试模式（更详细的错误信息）	false	-
--solid-only	仅转换实体	false	-
--max-geometry-num	最大几何体数量（0=无限制）	0	≥0
--tessellation-timeout	网格化超时时间（秒）	30	>0

使用示例

# 本地文件转换，调整精度
STP2GLB.exe --stp model.stp --glb output.glb --lin-defl 0.1 --ang-defl 0.5

# 从URL下载并转换
STP2GLB.exe --stp http://example.com/files/part.step --glb result.glb

# 调试模式转换
STP2GLB.exe --stp model.stp --glb output.glb --debug

# 限制几何体数量
STP2GLB.exe --stp large.stp --glb output.glb --max-geometry-num 100

---

HTTP 服务器模式

启动服务器

STP2GLB.exe --server --port 8080 --host 0.0.0.0

服务器参数

参数	说明	默认值
--server	启动服务器模式	-
--port	服务器端口	8080
--host	监听地址	0.0.0.0
--max-file-size	最大文件大小（MB）	500

API 端点

1. 健康检查

GET /health

响应示例：

{
  "status": "ok",
  "service": "STP2GLB"
}

2. 文件转换

POST /convert

支持两种输入方式：

方式一：文件上传

curl -X POST http://localhost:8080/convert \
  -F "file=@model.stp" \
  -F "linearDeflection=0.1" \
  -F "angularDeflection=0.5"

方式二：HTTP URL（新功能）

curl -X POST http://localhost:8080/convert \
  -F "url=https://example.com/model.stp" \
  -F "linearDeflection=0.1"

转换参数

参数名	说明	默认值
file	STP文件（multipart上传）	-
url	STP文件HTTP/HTTPS URL	-
linearDeflection	线性偏差	0.5
angularDeflection	角度偏差	0.8
relativeDeflection	相对偏差（true/false）	false
debug	调试模式（true/false）	false
solidOnly	仅实体（true/false）	false
maxGeometryNum	最大几何体数量	0

注意： file 和 url 二选一，url 优先级更高

响应示例

成功响应：

{
  "success": true,
  "output_file": "1234567890_5678.glb",
  "output_path": "./output/1234567890_5678.glb",
  "conversion_time": 2.35
}

错误响应：

{
  "success": false,
  "error": "Failed to download from URL: HTTP error: 404 Not Found"
}

---

注意事项

1. URL下载：

   • 仅支持HTTP和HTTPS协议
   • URL必须直接指向.stp或.step文件
   • 下载的临时文件会在转换完成后自动清理

2. 文件大小限制：

   • HTTP服务器模式默认限制500MB
   • 可通过 --max-file-size 参数调整

3. 超时设置：

   • 默认网格化超时30秒
   • 大型复杂模型建议增加超时时间

4. 调试模式：

   • 提供详细的STEP实体转换失败信息
   • 会显著降低转换速度

---

快速测试

# CLI模式测试
STP2GLB.exe --stp https://example.com/test.stp --glb test.glb

# 服务器模式测试
STP2GLB.exe --server --port 8080

# 测试健康检查
curl http://localhost:8080/health

# 测试URL转换
curl -X POST http://localhost:8080/convert \
  -F "url=https://example.com/model.stp"