nuget
STL (Stereolithography) 三角网格三维模型文件解析器
支持 ASCII 文本格式和 Binary 二进制格式的 STL 文件读取， 自动检测文件格式并将数据转换为统一的 Surface 数组。 具体的 ASCII / Binary 解析逻辑分别在 StlAsciiReader 与 StlBinaryReader 这两个 Partial Module 中实现。
StlParser
01 Syntax
Microsoft.VisualBasic.Imaging.Landscape.Stl.StlParser
02 Methods
| Name | Overloads | Summary |
|---|---|---|
| ParseAsciiSTL | 1 | 解析 ASCII 格式的 STL 文件 ASCII STL 格式： solid <name> facet normal ni nj nk outer loop vertex v1x v1y v1z vertex v2x v2y v2z vertex v3x v3y v3z endlo… |
| ParseNormalFromFacet | 1 | 从 "facet normal nx ny nz" 行解析法向量 |
| ParseVertex | 1 | 从 "vertex x y z" 行解析顶点坐标 |
| ParseBinarySTL | 1 | 解析 Binary 格式的 STL 文件 Binary STL 格式： - 80 字节文件头（通常为注释或程序名） - 4 字节 UInt32：三角面总数 - 每个三角面 50 字节： - 12 字节（3×Float32）：法向量 (ni, nj, nk) - 12 字节（3×Float32）：顶点1 (x1, y1, z1)… |
| ParseSTL | 2 | 从 Stream 自动检测格式并解析 STL 模型 |
| IsAsciiSTL | 1 | 判断文件头是否为 ASCII STL 格式（以 "solid" 开头） |
03 Members
ParseAsciiSTL(
StreamReader)解析 ASCII 格式的 STL 文件
ASCII STL 格式： solid <name> facet normal ni nj nk outer loop vertex v1x v1y v1z vertex v2x v2y v2z vertex v3x v3y v3z endloop endfacet endsolid <name>
Parameters
| Name | Type | Description |
|---|---|---|
reader | StreamReader | - |
ParseNormalFromFacet(
String)从 "facet normal nx ny nz" 行解析法向量
ParseVertex(
String)从 "vertex x y z" 行解析顶点坐标
ParseBinarySTL(
BinaryReader)解析 Binary 格式的 STL 文件
Binary STL 格式：
- 80 字节文件头（通常为注释或程序名）
- 4 字节 UInt32：三角面总数
每个三角面 50 字节：
- 12 字节（3×Float32）：法向量 (ni, nj, nk)
- 12 字节（3×Float32）：顶点1 (x1, y1, z1)
- 12 字节（3×Float32）：顶点2 (x2, y2, z2)
- 12 字节（3×Float32）：顶点3 (x3, y3, z3)
- 2 字节 UInt16：属性字节计数（通常为 0，忽略）
Parameters
| Name | Type | Description |
|---|---|---|
reader | BinaryReader | - |
ParseSTL(
String)从文件路径自动检测格式并解析 STL 模型
Parameters
| Name | Type | Description |
|---|---|---|
filePath$ | String | .stl 文件路径 |
Returns
解析后的 SceneModel
ParseSTL(
Stream)从 Stream 自动检测格式并解析 STL 模型
Parameters
| Name | Type | Description |
|---|---|---|
stream | Stream | 包含 STL 数据的流 |
Returns
解析后的 SceneModel
IsAsciiSTL(
Byte())判断文件头是否为 ASCII STL 格式（以 "solid" 开头）