Install 安装步骤
- 双击运行 超级硬装系列下载器.exe
- 搜索 超级硬装场景，点击 下载并安装，自动部署到 Plugins 目录
- 重启 SketchUp，确认菜单 扩展程序 - 超级硬装场景 及 8 个工具栏按钮出现
- 首次使用自动加载默认参数（相机高度 1200mm，视角 60°）
⚠️ 本插件依赖「超级硬装插件管理器」，请确保管理器已安装并启动。
Toolbar 工具栏（8 按钮）
放置箭头
两点标记
创建场景
批量生成
场景管理
面板管理
场景微调
构图+行走
行走模式
WASD 漫游
全景导出
立方体贴图
全景预览
360° 查看
参数设置
相机/导出
★ Workflow 完整工作流
5 步完成从标记到全景交付的完整流程：
1
放置箭头
两点定位 + 方向
2
批量创建场景
一键转 SU 场景
3
场景微调
构图线 + 行走
4
全景导出
6 面 → 等距矩形
5
全景预览
Three.js 360°
💡 箭头是临时标记，生成场景后可一键「清理箭头」。场景保留在模型中不受影响。
Arrow 放置箭头工具
两步操作：点击位置 → 拖动确定朝向。箭头尖端方向 = 相机看向。
| 阶段 | 操作 | 说明 |
|---|---|---|
| 第 1 点 | 单击 | 确定相机位置（箭头底部中心） |
| 第 2 点 | 移动 + 单击 | 确定朝向；靠近轴线 ±10° 自动吸附 |
| 连续 | 继续点击 | 放完后自动回到第 1 步，连续放置 |
| 退出 | Esc | 退出工具，箭头保留 |
📐 相机高度（默认 1200mm）在「参数设置」中调整，所有箭头共享。
Generate 批量创建场景
一键将所有箭头标记转为 SketchUp 场景页面。
自动计算
- 相机 eye = 箭头位置 + 高度
- 朝向 = 箭头 Z 轴投影到 XY
- FOV = 参数设置中的值
命名规则
- 自动递增「场景1, 场景2…」
- 跳过已存在名称
- 面板可后续重命名
渲染保护
- 箭头导出前自动隐藏
- 生成后恢复原相机
- 一次 Undo 可撤销全部
静默 API
- 供流水线批量调用
- 无箭头不弹窗
- 返回生成数量
Manager 场景管理面板
HtmlDialog 面板，集中管理所有场景。
基础操作
- 列表显示所有场景
- 点击切换当前场景
- 重命名 / 删除
排序 / 批量
- 拖拽排序场景顺序
- 批量删除
- 全选 / 反选
Tweak 场景微调工具
构图辅助线 + 快捷更新场景相机。Overlay 持续绘制，不随工具切换消失。
构图辅助线
- 三分法网格（红线）
- 安全框遮罩（黑色半透明）
- 红色边界线
宽高比选择
- 16:9 / 4:3 / 1:1
- 匹配视口（无遮罩）
- 自定义 W:H
场景操作
- 「更新场景」按钮
- 保存当前相机到场景
- 顶部显示场景名称
交互控制
- 中键旋转视角
- Shift+中键 平移
- 滚轮缩放
- Esc 退出
💡 Overlay 注册到 model，即使退出微调工具，构图线可保持显示。Window → Overlays 可开关。
FPS Walk 行走模式
D5 风格第一人称行走：WASD 移动 + 右键环视。底部 HUD 按钮一键进入。
| 按键 | 功能 |
|---|---|
| W / S | 前进 / 后退 |
| A / D | 左平移 / 右平移 |
| Q / E | 下降 / 上升 |
| 右键拖动 | 环视（鼠标灵敏度可调） |
| ↑↓←→ | 方向键也可代替 WASD |
| Esc | 退出行走模式 |
速度预设
- 慢 50 mm/帧
- 普通 100 mm/帧
- 快 200 mm/帧
- 极速 500 mm/帧
灵敏度预设
- 低 0.15
- 中 0.3
- 高 0.5
- 极高 0.8
支持本地全景转换成视频最高支持4k
Panorama 全景导出 & 预览
对选定场景导出六面立方体贴图，DLL 拼接为等距矩形全景图。
导出分辨率
- 2K（2048px）
- 4K（4096px）
- 6K（6144px）
- 8K（8192px）
- 16K（16384px）
导出设置
- 格式 jpg / png
- 关闭阴影加速
- 统一光照避免接缝
- 隐藏箭头防渲染
DLL 拼接
- 6 面 → 等距矩形
- pano_stitcher.dll
- 原生 C 性能
全景查看器
- Three.js 球形全景
- 鼠标拖拽 360° 浏览
- 滚轮缩放 FOV
- HtmlDialog 窗口
💡 导出采用异步 timer 驱动，支持取消，大批量场景也不会冻死 SketchUp。
Settings 参数设置
| 参数 | 默认值 | 说明 |
|---|---|---|
| 相机高度 | 1200 mm | 箭头位置 + 此值 = 相机 eye.z |
| 相机 FOV | 60° | 透视角度，越小越远摄 |
| 导出格式 | jpg | jpg / png 可选 |
| 抗锯齿 | 开启 | 六面导出抗锯齿 |
| 构图线宽高比 | viewport | 16:9 / 4:3 / 1:1 / 自定义 |
| 退出模式 | together | 退出微调同时关闭 Overlay |
| 行走速度 | 普通 (100) | 慢/普通/快/极速 |
| 鼠标灵敏度 | 中 (0.3) | 低/中/高/极高 |
✅ 设置保存在
%APPDATA%/cjyz_arrow_scene_settings.json，重启 SU 后保留。FAQ 常见问题
箭头放错位置了怎么办？
箭头是普通 ComponentInstance，可以移动 / 旋转 / 删除，和普通组件一样操作。也可一键「清理箭头」全部删除重放。
生成场景后还能修改相机吗？
当然可以。用「场景微调」工具进入后，自由调整视角，然后点击顶部「更新场景」按钮保存到当前场景页面。
全景拼接有明显接缝？
导出时插件自动关闭阴影 + 雾效 + AO + 统一光照方向，消除六面亮度差异。如仍有问题请检查是否有 后处理插件（如 Enscape overlay）干扰。
行走模式 WASD 无反应？
请确认已点击底栏「→ 行走」按钮激活 FPS 模式（按钮变橙色）。仅进入「场景微调」工具不会自动进入行走模式。如果仍无反应，可能是另一个程序持有键盘 Hook（如输入法全局热键）冲突。
导出的全景图很大/很慢？
16K 单面 16384px，6 面总像素极大，建议大场景使用 4K~6K。导出采用异步 timer，不会冻死 SU，但单面导出时间取决于场景复杂度。可在导出对话框中「取消」。
场景管理面板能排序吗？
可以。面板支持拖拽排序场景顺序，排序结果同步到 SketchUp 的 Scene Tabs，幻灯片播放按此顺序。
Tips 高效技巧
🎯 批量放箭头
俯视图中连续点击快速布置多个相机位置，朝向靠近轴线自动吸附。
📐 微调构图
进入微调后选择 16:9 比例，三分法线辅助构图，对齐后更新场景。
🚶 行走定位
FPS 行走找到最佳视角后按 Esc 退出行走但不退出微调，直接更新场景。
🌐 批量全景
选多个场景一次导出，DLL 拼接每张仅几秒，批量交付全景漫游项目。
🔄 静默 API
外部插件可调用 SceneGenerator.generate_from_arrows_silent 集成到流水线。
🗑 一键清理
生成场景后用「清理箭头」清除所有红色标记，保持模型干净。