# 3D 模型查看器（STL / OBJ / glTF）

上传 STL、OBJ、GLB 或 glTF 模型，服务端解析出顶点数、三角面数、包围盒尺寸、法线/UV、glTF 材质与动画列表，并在浏览器中用 three.js 实时渲染：拖动旋转、滚轮缩放、着色/线框/法线模式、网格与坐标轴。超大模型自动按步长抽样预览（统计仍为精确值）。

> 标准页面: https://elysiatools.com/zh/tools/3d-model-viewer

- **分类:** Media

- **关键词:** 3d 查看器, stl, obj, gltf, glb, 网格检视, three.js

## 概述

解析规则：二进制 STL = 80 字节头 + uint32 LE 三角数 + 每 50 字节一个三角形（12 字节法线 + 9×float 顶点 + uint16 属性）；ASCII STL 扫描 vertex 行；OBJ 逐行解析 v/vn/vt/f，n 边形扇形三角化（索引支持 1 起与负数）；GLB 按 magic 0x46546C67 校验并读取 JSON + BIN 双块，accessor 按 componentType（5126 float / 5125 uint32 / 5123 uint16 / 5122 int16 / 5121 uint8 / 5120 int8）与 byteStride 解码。预览网格上限 8 万三角形（超出按步长抽样），统计面板始终为精确值。KHR_draco_mesh_compression / EXT_meshopt_compression 压缩的几何无法在服务端解压，仅提供结构信息。

## 输入项

- **3D 模型文件（STL / OBJ / GLB / glTF）** (file): Upload a .stl, .obj, .glb or .gltf file
- **初始渲染模式** (select)
- **查看器背景** (select)
- **自动旋转** (checkbox)

## 适用场景

- 打印或切片前核对 STL 的三角面数量、法线与包围盒尺寸
- 在浏览器中预览 OBJ / glTF 的拓扑、材质名称和动画列表，无需安装建模软件
- 向同事或客户快速展示可交互模型，并附带精确网格统计

## 工作原理

- 上传单个 .stl、.obj、.glb 或 .gltf 文件（上限约 25MB）。
- 服务端按格式解析：二进制/ASCII STL、带 n 边形扇形三角化的 OBJ、含 JSON+BIN 的 GLB/glTF，输出精确顶点、三角面、包围盒及材质/动画信息。
- 页面嵌入 three.js 查看器，默认着色、暗色影棚并可自动旋转；可切换线框或法线，拖动旋转、滚轮缩放，并显示网格与坐标轴。
- 预览网格上限约 8 万三角面，超出按步长抽样；Draco / meshopt 压缩几何无法在服务端解压，仅提供结构信息。

## 使用案例

- 3D 打印前检查 STL 校准件或切片网格是否完整、尺寸是否符合预期
- 核对游戏或 Web 项目中 GLB/glTF 的材质、动画列表与包围盒
- 协作或教学时打开 OBJ，用线框或法线模式观察拓扑

## 常见问题

### 支持哪些文件格式？

支持 STL（二进制与 ASCII）、OBJ、GLB 和 glTF。

### 超大模型会怎样？

预览按步长抽样至约 8 万三角面，统计面板仍显示精确的顶点、三角面和包围盒。

### Draco 或 meshopt 压缩的 glTF 能看到网格吗？

服务端无法解压这类压缩几何，仅报告节点、材质等结构信息。

### 可以改查看方式吗？

可选择初始渲染模式（着色、线框、法线）、背景（暗色或亮色影棚）以及是否自动旋转。

### 文件大小有限制吗？

单个模型文件上限约为 25MB。

## 相关工具

- [时间序列预测与季节性分析](https://elysiatools.com/zh/tools/time-series-forecast-seasonality-analyzer): 从 CSV 或 JSON 时间序列数据中预测未来数期，并在一份报告中查看趋势、季节项和残差分解
- [JSON 路径可视化器](https://elysiatools.com/zh/tools/json-path-visualizer): 将 JSON 或 JSONL 以可展开树形结构展示，并为每个节点生成可复制的 JSONPath 表达式
- [结构化日志解析器](https://elysiatools.com/zh/tools/structured-log-analyzer): 自动识别常见日志格式，提取核心字段并推断字段类型，支持导出为 JSON、CSV 或 SQL。
- [训练/测试集分层切分器](https://elysiatools.com/zh/tools/train-test-split-with-stratification): 读取 CSV/JSON 数据集,按目标列做分层抽样的 train/validation/test 切分(默认 70/15/15,随机种子可复现),或分层 k 折交叉验证;输出每折类别分布报告与偏差条、重复行泄漏检查、SMOTE 过采样预览(仅在训练折上做最近邻插值),并可导出各折 CSV 为 ZIP。
- [音频和弦进行检测器](https://elysiatools.com/zh/tools/audio-chord-progression-detector): 在本地估算音频中的和弦顺序，并以 ZIP 下载 CSV、JSON、SVG 时间线和方法说明。
- [播客章节标记生成器（ID3 / Podcasting 2.0）](https://elysiatools.com/zh/tools/podcast-chapter-marker-builder): 粘贴时间码章节列表，一次生成全部交付格式：Podcasting 2.0 章节 JSON（v1.2.0）与 RSS podcast:chapters 标签、可选把 ID3v2.4 CHAP+CTOC 章节帧直接烧入上传的 MP3（毫秒为普通大端 uint32、偏移 0xFFFFFFFF、每章嵌 TIT2 子帧、保留原有标签帧）、Vorbis CHAPTER001 注释对（OGG/Opus）、mp4chaps 文本、YouTube 说明栏时间戳块与 SRT 副车文件，并附各播放器真实支持情况（Apple 自 2025 起支持 RSS JSON；Pocket Casts/Overcast 仅读内嵌 ID3；Spotify 两者都不读）。
- [文本编码取证与修复](https://elysiatools.com/zh/tools/text-encoding-forensics-and-repair): 检查编码、BOM、换行风格和乱码迹象，并生成带评分的本地修复候选。
- [数据集不平衡检测与重采样](https://elysiatools.com/zh/tools/dataset-imbalance-detector-resampler): 检测 CSV 或 JSON 数据集中的类别不平衡，对比重采样策略，并预览平衡后的输出数据集

## 示例

- [7Z Viewer Samples](https://elysiatools.com/zh/samples/7z-viewer-samples): A small 7Z archive with text and JSON files for in-browser preview
- [RAR Viewer Samples](https://elysiatools.com/zh/samples/rar-viewer-samples): A small RAR archive with text and JSON files for in-browser preview
- [TAR Viewer Samples](https://elysiatools.com/zh/samples/tar-viewer-samples): A small TAR archive with text and JSON files for in-browser preview
- [ZIP Viewer Samples](https://elysiatools.com/zh/samples/zip-viewer-samples): A small ZIP archive with text and JSON files for in-browser preview

## 相关内容

- [文本分析、可读性与内容检查工具](https://elysiatools.com/zh/hubs/text-analyze): 在一个专题中比较文本统计、语言识别、可读性评分、情感分析、内容审核和模式分析工具。
- [JSON 交换与格式翻译工具](https://elysiatools.com/zh/hubs/json-convert): 在一个专题里比较 JSON 与 CSV、YAML、TOML、GraphQL、XML、Markdown、Excel、BSON、EDN 等结构化格式之间的转换工具。
- [文本大小写、编码与规范化转换工具](https://elysiatools.com/zh/hubs/text-convert): 在一个专题中比较文本大小写转换、全半角转换、编码转换、Quoted-Printable 处理和行内文本规范化工具。
- [JSON 检查、对比与转换工具](https://elysiatools.com/zh/hubs/json-utility): 把 JSON 格式化、差异对比、路径检查、Schema 校验、合并、转换和导出工具集中到一个专题中，适合 API 与数据处理流程。
