3D 模型资产预览 (3D Models)

Sharp Stock 深度支持游戏开发中主流的 3D 模型格式。美术、程序及策划人员可直接在资产库中审阅模型细节，无需开启沉重的专业建模软件或引擎编辑器。

3D模型格式预览

1. 支持的格式规范

系统原生支持以下主流 3D 交换格式：

FBX：行业标准的 3D 交换格式，广泛支持骨骼、动画及材质信息。
GLTF / GLB：高效、轻量化的现代通用传输格式，是 Web 与跨平台游戏开发的首选。

2. 交互预览功能

360 度全方位观察

选中 3D 模型资产后，右侧详情面板将自动激活交互式视口：

旋转：按住鼠标左键并拖动，从任意方向观察模型。
平移：按住鼠标右键并拖动，移动当前观察中心。也可以使用鼠标中键平移。
缩放：按住 Ctrl 并滚动鼠标滚轮，放大查看细节或缩小观察整体轮廓。直接滚动滚轮会继续滚动外层页面。
重置视角：点击工具栏中的重置按钮，或先点击视口再按 R，恢复默认取景。
坐标轴 Gizmo：右下角会显示 X、Y、Z 坐标轴。正向端点使用标准轴色，负向端点使用对应的浅色版本；点击任一轴向圆点，可以快速切换到对应的正交观察方向。
放大预览：打开模型的放大预览后，以上操作、渲染模式和快捷键仍然可用。

渲染与辅助显示

视口右上角的小按钮用于切换渲染模式；左上角的 i 按钮会在鼠标指向或键盘聚焦时显示完整操作说明：

光照：显示模型原有材质、贴图和视口灯光，适合检查最终外观。
无光照：保留颜色与贴图，但不受视口灯光影响，适合检查贴图本身。
无纹理：隐藏贴图并保留光照，适合检查模型轮廓、表面起伏和法线表现。
线框：以线框显示模型，适合快速检查网格密度与拓扑分布。
视口背景：3D 视口使用随浅色、深色主题变化的中性渐变背景，避免与透明图片使用的棋盘格混淆。
辅助网格：点击网格按钮或按 G 显示、隐藏地面参考网格。网格原点包含红色 X 轴线和蓝色 Z 轴线，便于判断地面坐标走向。
自动旋转：点击自动旋转按钮或按 A 开启、关闭转台展示。默认关闭，避免影响手工观察。
模型动画：当文件包含动画时，工具栏会出现播放/暂停按钮。预览器默认播放文件中的第一个动画片段。

智能材质与贴图识别

系统会自动分析并尝试加载模型关联的贴图。若贴图文件位于模型同级目录或标准的 textures 子文件夹中，预览器将自动呈现带有纹理的真实渲染效果。

3. 组织管理建议

资源存放规范：建议将模型文件及其配套贴图存放在统一的文件夹内，以便系统能够精准地进行纹理关联。
性能化标签：利用标签系统，为模型标注“高模/低模”、“LOD层级”或“所属角色”，实现资源的快速检索。

4. 常见问题排查

预览模型时为何没有贴图？
- 请核实贴图文件是否位于模型同级或 textures 目录下。此外，请检查模型导出时记录的相对路径是否正确。
是否支持动作预览？
- 支持播放和暂停模型文件中的第一个动画片段。当前暂不提供动画片段列表、时间轴和逐帧控制。