Shadow Editor Pro 快速入门

本章将指导您完成 Shadow Editor Pro 的安装和基本使用，帮助您快速创建第一个3D场景。

系统要求

硬件要求

• 处理器: Intel Core i5 或同等性能以上
• 内存: 最少 8GB，推荐 16GB 或以上
• 显卡: 支持OpenGL 3.3及以上的独立显卡
• 存储空间: 最少 2GB 可用空间
• 显示器: 1920x1080 或更高分辨率

软件要求

• 操作系统: Windows 10/11（推荐）、Linux、macOS
• 运行环境: 无需额外安装软件（桌面版）
• 网络连接: 用于上传/下载资源（可选）

安装指南

Windows 用户

1. 下载安装包

   从官方网站下载 Windows 版本安装包： ShadowEditor-Windows-0.0.1-Setup.exe

2. 运行安装程序

   双击安装包，按照提示完成安装：

   • 选择安装目录（默认：C:\Program Files\ShadowEditor Pro）
   • 创建桌面快捷方式
   • 添加到开始菜单

3. 启动程序

   安装完成后，可以通过以下方式启动：

   • 双击桌面快捷方式
   • 从开始菜单启动
   • 运行安装目录下的 ShadowEditor.exe

绿色版使用

如果您使用绿色版（无需安装）：

1. 解压下载的压缩包到任意目录
2. 进入 win-unpacked 文件夹
3. 双击 ShadowEditor.exe 启动

Linux/macOS 用户

Linux 和 macOS 版本即将推出，敬请期待。

首次运行

启动程序

1. 启动 Shadow Editor Pro 后，会看到主界面：

   ┌─────────────────────────────────────────────────────────────┐
   │  菜单栏              │                                  │
   ├─────────────────────────────────────────────────────────────┤
   │ 工│                     │                                  │
   │ 具│    3D 视图区域       │     资源面板                   │
   │ 栏│    (主要工作区)      │     (场景/模型/贴图等)          │
   │   │                     │                                  │
   ├─────────────────────────────────────────────────────────────┤
   │ 侧边栏 (属性/层级/脚本) │                                  │
   ├─────────────────────────────────────────────────────────────┤
   │  状态栏                                            │
   └─────────────────────────────────────────────────────────────┘
   

2. 程序会使用默认端口 3000，如果端口被占用，程序将无法正常启动

3. 首次启动会自动创建必要的数据目录

检查环境

启动后，检查以下信息：

• 状态栏 显示 Three.js 版本号（如 r166）
• 端口: 确保3000端口未被占用
• 性能: 检查3D视图是否流畅渲染

创建第一个场景

步骤1：添加几何体

1. 点击菜单栏 物体 → 基本几何体 → 正方体

2. 一个正方体会出现在场景中心

3. 在3D视图中：

   • 左键拖动: 旋转场景
   • 右键拖动: 平移场景
   • 滚轮: 缩放场景

步骤2：调整视角

1. 使用鼠标调整到合适的视角

2. 点击状态栏的 设为默认视角 按钮

3. 在弹出的对话框中点击 确认

   这样每次打开或播放场景时，都会自动定位到这个视角

步骤3：添加脚本

1. 点击右侧边栏的 脚本 选项卡

2. 点击 新建脚本 按钮

3. 输入脚本名称：正方体旋转，点击 确定

4. 在脚本编辑器中输入以下代码：

   /**
    * 每帧更新函数
    * @param {number} delta - 帧间隔时间（秒）
    */
   function update(delta) {
     // 获取场景中名称为"正方体"的物体
     const cube = scene.getObjectByName('正方体')
   
     if (cube) {
       // 绕X轴旋转
       cube.rotation.x += delta * 1
       // 绕Y轴旋转
       cube.rotation.y += delta * 0.5
     }
   }
   

5. 点击 保存 按钮保存脚本

步骤4：播放场景

1. 点击菜单栏 播放 → 播放（或按 F5 键）

2. 您会看到正方体开始旋转

3. 点击 播放 → 停止（或按 Esc 键）停止播放

步骤5：保存场景

1. 点击菜单栏 场景 → 保存（或按 Ctrl+S）

2. 在弹出的对话框中：

   • 输入场景名称：旋转正方体
   • 选择分类（可选）
   • 上传缩略图（可选）

3. 点击 确定 保存

步骤6：加载场景

1. 点击右侧 资源面板 的 场景 选项卡

2. 找到刚保存的 旋转正方体 场景

3. 点击 加载 按钮加载场景

基本操作

鼠标操作

键盘快捷键

视图切换

从菜单栏 视图 切换不同视图：

• 透视图: 默认3D透视视图
• 正视图: 从前面观察
• 侧视图: 从侧面观察
• 顶视图: 从顶部观察
• 线框模式: 以线框方式显示

编辑模式

从工具栏或菜单栏 工具 切换编辑模式：

• 选择工具 (Q): 选择和操作物体
• 移动工具 (W): 移动物体位置
• 旋转工具 (E): 旋转物体
• 缩放工具 (R): 缩放物体

上传模型

上传单个文件

1. 点击菜单栏 物体 → 导入模型

2. 选择要上传的模型文件

3. 等待上传完成

4. 模型会自动添加到场景中

上传文件夹

对于包含多个文件的模型（如OBJ + MTL + 贴图）：

1. 点击菜单栏 物体 → 导入模型文件夹

2. 选择包含模型文件的文件夹

3. 在弹出的对话框中选择主模型文件

4. 系统会自动识别相关文件并一起上传

常见问题

Q: 程序无法启动怎么办？

A: 检查以下几点：

1. 确保3000端口没有被其他程序占用
2. 检查防火墙是否允许程序运行
3. 查看错误日志获取详细信息

Q: 3D视图显示为空白？

A: 可能的原因：

1. 显卡驱动过旧，请更新显卡驱动
2. WebGL不支持，请检查浏览器或系统设置
3. 场景中没有任何物体，尝试添加一个物体

Q: 模型导入失败？

A: 检查以下几点：

1. 确认模型格式是否在支持列表中
2. 检查文件是否损坏
3. 对于复杂模型，可能需要等待更长时间
4. 查看控制台错误信息

Q: 如何撤销误操作？

A: 使用以下方法之一：

1. 按快捷键 Ctrl+Z
2. 点击菜单栏 编辑 → 撤销
3. 点击工具栏的撤销按钮

下一步

恭喜您完成了快速入门！现在您已经掌握了基本操作。接下来可以：

1. 📖 阅读功能说明了解更详细的功能
2. 🚀 探索高级功能提升创作能力
3. 💡 查看常见问题解决使用中的问题
4. 📚 参考附录获取详细信息

祝您创作愉快！