通用说明与界面总览
（一）术语约定
- 单击：按下并松开鼠标左键一次。
- 双击：快速连续单击左键两次。
- 右键单击：按一下鼠标右键。
- 拖动：按住按键不放并移动鼠标，到位后再松开。
- 中键：鼠标滚轮按下的键；滚轮：滚动滚轮本身。
- 组合键 Ctrl+Z 表示先按住 Ctrl 不放，再按 Z 键。
（二）通用技巧
- 数值框（如 X/Y/Z、时长等）：按住左键左右拖动即可增减数值；按住 Ctrl 再单击数值框，可改为键盘输入精确数值，回车确认。
- 文本输入框正在输入文字时，各种全局快捷键会暂停响应，避免打字误触发播放或编辑。
- 标注“会员”的功能需要开通会员，未开通点击时会弹出提示。
（三）界面总览
- 主视图：程序主窗口，3D 燃放场景（窗口模式下位于屏幕左半屏）。
- 时间线：固定在屏幕底部的全宽面板，可用上边缘拖动调整高度。
- 素材库、脚本：浮动窗口，默认停靠在右侧，可通过菜单“窗口”打开或关闭；浮动的窗口都可以拖动标题栏移动位置。
- 播放控制、渲染、账号等入口位于屏幕顶部的菜单栏。
主视图（3D 场景）
（一）鼠标操作
- 选中火点：单击场景中的火点即可选中（以火点为中心约 20 像素范围内的点击都算命中）。按住 Ctrl 再单击火点：把该火点加入或移出当前选中（多选切换）。
- 移动火点：按住左键拖动火点：火点贴着地面水平移动，高度保持不变，移动范围限制在场景中心 ±100 以内。
- 框选火点：在场景空白处按住左键拖出一个矩形选择框，松开鼠标后，框内火点全部选中。按住 Ctrl 再拖动框选：把框内火点追加到当前选中，而不是替换原有选中。
- 清空选中：在空白处单击（拖动距离很小、不足以形成框选）会清空当前所有选中。
- 旋转观察视角：按住鼠标中键拖动：左右拖动水平旋转视角，上下拖动抬头或低头。
- 摄像机前进 / 后退（滚轮）：在主视图（场景区）滚动滚轮：上滚前进、下滚后退，移动方向与键盘 W / S 相同；单次滚动走得比按键一帧更多，连续滚动可连续移动。
注意：鼠标悬停在素材库、时间线等窗口上时，滚轮归该窗口使用（例如时间线缩放），不会移动摄像机。
（二）键盘操作（移动摄像机视角）
以下按键按住不放会持续生效，松开即停止：
- W 前进、S 后退、A 左移、D 右移。
- R 上升、F 下降。
- 左方向键 向左转视角、右方向键 向右转视角。
- 上方向键 抬头、下方向键 低头（俯仰最大约 89 度，不会翻过头）。
（三）射向辅助（暂停状态、选中单发片段后显示）
在暂停状态下选中单发片段（一次点火一发、非盆花，且已设置点火位置）后，场景中会显示弹道辅助：
- 白色虚线：从点火位置沿实际发射方向延伸（细段虚线），末端为圆圈（带十字线）。
- 橙色实曲线：实测飞行轨迹（含空气阻力），末端圆点为爆炸点；虚线是发射方向的延长线，实曲线受重力向下偏移，二者在起点相切（属正常现象）。
- 圆圈下方两行文字：礼花弹名称、当前角度（水平射向角，如“-45°”）；起点下方显示点火位置名称。
- 调整射向：把鼠标移到某个圆圈上（圆圈变金黄、光标变手型），按住左键左右拖动——水平射向角随之调整（范围 -90°~90°，吸附为 5° 的整数倍），拖动中圆圈变橙色加粗；鼠标移动距离与圆圈屏幕移动距离大致同步（跟手）。
- 多选多个单发片段时，所有选中片段都显示辅助；拖动其中任意一个圆圈，其余选中片段按相同档位增量同步调整。
注意：抓住圆圈的操作优先于火点拾取与框选，在圆圈上按下不会误拖火点或框选。
时间线面板
（一）播放控制
- “|<”按钮：回到开头（时间归零并暂停）。
- “播放/暂停”按钮：开始或暂停播放，按钮文字随状态变化；鼠标悬停会提示“播放/暂停（Space）”。
- 时间读数：显示“当前 xx.xx s / 共 xx.xx s”。
- 空格键：播放 / 暂停。
- 播放时时间轴会自动平移，让播放头始终保持在画面中间。
（二）定位时间（标尺与轨道空白处）
- 在时间标尺上单击：播放头跳到该位置并自动暂停。
- 在标尺上按住左键拖动：播放头跟随鼠标连续移动，画面同步刷新。
- 在轨道区的空白处单击：清空片段选中，同时把播放头定位到该位置。
- 在轨道区空白处按住左键拖动：播放头跟随鼠标移动（与标尺效果相同）。
注意：定位时间会自动取消当前选中的摄像机关键帧（关键帧编辑期间时间被锁定，拖动时间即解除锁定）。
（三）片段（烟花）操作
- 单击片段：选中该片段。
- Ctrl+单击片段：多选切换（加入或移出选中集合）。
- 右键单击片段：选中该片段并弹出右键菜单。
- 拖动片段：改变片段位置。上下拖动可以换到其他轨道；移动时自动吸附到 0.1 秒网格，按住 Ctrl 拖动可临时取消吸附；若拖动的片段处于多选状态，所有选中片段一起移动；属于同一编组的片段会整组一起移动（整组换轨时不会越出轨道范围）。
- 双击片段：打开该片段的属性窗口。
片段右键菜单：
（四）框选片段
按住 Ctrl，在轨道空白处按住左键拖出选择框，松开鼠标后，效果开始时间落在框内的片段被全部选中。（不按 Ctrl 时，空白处拖动用于定位时间，不会框选。）
（五）缩放与平移时间轴
- 滚动滚轮：以鼠标所在位置为中心缩放时间轴（每次缩放 1.1 倍，范围约 10~500 像素/秒）。
- 按住中键拖动：左右平移时间轴。
（六）效果时间把手与散布手柄
- 效果时间把手：把鼠标移到把手附近（约 ±15 像素）按住左键左右拖动，可整体调整该处片段的效果时间；属于同一编组的片段会一起移动。悬停提示“拖动调整效果时长”。
- 组尾散布手柄：左右拖动，把编组内的片段散开或合拢（末端跟随鼠标）。
（七）摄像机轨道会员
- 轨道内常显“单击添加关键帧”提示。
- 单击轨道空白处：立即在该点击位置对应的时间处添加一个关键帧（镜头姿态取该时刻的值），并取消原有的关键帧选中；若点击位置命中已有关键帧（菱形附近），则不会重复添加，而是选中它并可直接拖动。
- 单击关键帧菱形：选中该关键帧，并打开“摄像机关键帧属性”窗口。
- 按住左键拖动关键帧：调整该关键帧的时间。
- 右键单击：弹出菜单——“删除”：删除当前选中的关键帧；“添加关键帧”：在右键位置添加一个关键帧并自动选中。
- 未开通会员时该轨道为只读：可以看到关键帧标记与镜头动画，但不能增删改；单击空白处会弹出会员提示。
（八）调整时间线高度
把鼠标移到时间线面板的上边缘（±5 像素内），光标变为上下箭头后按住左键上下拖动，即可调整面板高度（最低 80 像素）。
（九）时间线键盘快捷键
摄像机关键帧属性窗口
选中摄像机关键帧后自动出现，可拖动标题栏移动位置。
脚本窗口
通过菜单“窗口 → 脚本”打开。以表格形式列出当前编排的发射脚本，顶部提供筛选条件。
- 双击数值单元格：进入编辑；回车或点击其他位置提交，Esc 取消。
- 提交的数值会自动限制到规范范围内（越界数值导出时同样会被自动修正）。
- 双击“效果名”文本单元格：手工指定效果名（仅支持 ASCII 字符）；清空内容后恢复为按烟花弹名称自动转写。
素材库窗口
通过菜单“窗口 → 资源库”打开（窗口标题为“素材库”）。窗口顶部依次为：当前路径、“联网更新”按钮、页签、筛选与搜索区。
共三个页签：通用礼花 / 编排项目 / 本项目。
（一）联网更新（通用按钮）
单击“联网更新”：连接服务器校验素材库差异，下载缺失或损坏的烟花弹。更新过程中按钮不可用，可单击“取消更新”；完成后单击“关闭并刷新素材库”刷新列表。
（二）通用礼花页签（列表视图）
- 单击行：选中。
- 双击行：文件夹 → 进入该文件夹。
- 双击行：
.lfb烟花弹 → 打开烟花弹编辑器（设计器）。 - 双击行：
.lfc盆花 → 打开盆花编辑器。
右键单击行（菜单项随文件类型出现）：
（三）编排项目页签（封面网格视图）
- 鼠标悬停在封面上：显示名称、时长与操作提示，光标变为手型。
- 单击封面：选中（显示蓝色边框）。
- 双击封面：把该项目加载到时间线。
- 右键单击封面：菜单为“打开时间线 / 删除文件”（删除有确认提示）。
- 文件夹卡片：双击进入该文件夹。
（四）本项目页签
显示当前项目已加载的烟花弹与盆花：
- 双击：打开对应的编辑器（弹库编辑 / 盆花编辑）。
- 右键单击：可“添加到时间线”，或“删除”项目内条目。
主菜单栏
（一）文件
（二）编辑
（三）渲染
（四）账号（登录后显示）
- 账号与会员状态…：查看账号与会员信息。
- 开通 / 续费会员。
- 领取离线登录码（每月 3 次）。
- 退出登录。
（五）窗口
其他编辑窗口
（一）项目设置（文件 → 项目设置）
包含封面录制、背景（图片 / 颜色）、地面、场景、亮度与辉光等画面参数，以及背景音乐的添加 / 清除；所有设置随项目文件一起保存。
（二）设计器（编辑 → 烟花设计器；也可在素材库双击 .lfb 打开）
用于编辑烟花弹的参数与发射方向：
- 主视图中按住左键拖动地球，可旋转观察视角。
- 常用按钮：保存（“保存”表示有未保存的修改）/ 添加 / 复制 / 删除 / 清空所有方向 / 经纬范围 / 随机方向 / 生成并关闭 / 取消。
- 各数值框按第一章的通用技巧调整。
（三）盆花编辑器
打开方式：时间线右键菜单“组合为盆花”、素材库双击 .lfc 盆花文件（或在右键菜单选择“编辑盆花”）。
用于调整盆花中每一发的效果、时间与方向等参数，保存后写回素材库文件。
注意：某盆花正在编辑中时，不能在素材库中删除它，请先关闭盆花编辑器。
（四）编辑火点位置（编辑 → 编辑火点位置）
提供“新增 / 环形分布 / 线性分布”等工具，用于逐个或批量布置 3D 场景中的火点。
（五）触发点设计器（编辑 → 触发点设计器）会员
- 顶部设置风格、数量、抑制半径等参数。
- 在主视图中按住左键拖动框选要纳入装配的发射点。
- 在右侧触发曲线上单击定位，设置各步的装填时间。
- 按提示进入装配后，跟随向导操作：
选择发射顺序
选择单筒形状
完成
（六）空中图案生成（编辑 → 空中图案生成…）会员
- 先在主视图中框选发射点（左键拖动框选，Ctrl 追加选择）。
- 在窗口中选择图案来源：文字（可输入内容、调整高度）或图片（支持 PNG / JPG / BMP / GIF）。
- 设置亮度阈值等参数后生成；生成的图案以当前播放头时间作为开始时间，逐发对应框选的发射点，并且不会被自动重排到其他轨道。
渲染控制窗口
在菜单“渲染 → 开始渲染”后出现（需会员并已安装合成器）。
说明：设置好时长后点击“开始”即开始渲染，画面帧保存在 png 文件夹；渲染过程中不播放声音；渲染结束后程序会自动调用合成器（
ffmpeg.exe）把画面与音轨合成视频。在线作品库与系统托盘
（一）在线作品库
独立窗口，可通过托盘菜单等入口打开。
- 页签“在线作品库 / 本地库”：单击切换。
- 播放 / 暂停按钮：单击切换；按钮获得焦点时按 空格 键与单击等效。
- 静音按钮：音乐、燃放音效各有一个，单击在“静音 / 已静音”之间切换。
- 音量滑块：按住拖动调整音量；滑块获得焦点时可用键盘方向键微调。
- 在线库：单击条目查看详情；用“上一页 / 下一页”按钮翻页，可刷新列表。
- 本地库：双击封面加载并播放；右键单击封面删除。
- 关闭按钮：关闭作品库窗口。
（二）系统托盘菜单
右键单击系统托盘中的程序图标，打开菜单：
键盘快捷键速查表
主视图（3D 场景）
| 按键 | 功能 |
|---|---|
| 滚轮（场景区） | 前进 / 后退 |
| W / S / A / D | 前进 / 后退 / 左移 / 右移 |
| R / F | 上升 / 下降 |
| 左 / 右方向键 | 向左 / 向右转动视角 |
| 上 / 下方向键 | 抬头 / 低头 |
射向辅助（暂停、选中单发片段后）
| 按键 | 功能 |
|---|---|
| 鼠标左键拖动圆圈 | 调整水平射向角（-90°~90°，5° 一档） |
多选时其余选中片段同步增减。
时间线
| 快捷键 | 功能 |
|---|---|
| Ctrl+Z / Ctrl+Y | 撤销 / 重做 |
| Ctrl+S | 保存项目 |
| Ctrl+C / Ctrl+V | 复制 / 粘贴片段 |
| Ctrl+A | 全选片段 |
| Delete | 删除选中片段 |
| Esc | 取消选中 / 取消框选 / 终止拖动 |
| 左 / 右方向键 | 选中片段左移 / 右移 0.1 秒（Shift：1 秒） |
| 空格 | 播放 / 暂停 |
摄像机自由定位（勾选“使用键盘自由定位”后）
| 按键 | 功能 |
|---|---|
| W / S / A / D | 摄像机前进 / 后退 / 左移 / 右移 |
| 方向键 | 转动视角（鼠标中键拖动同样可以转动视角） |
在线作品库
| 按键 | 功能 |
|---|---|
| 空格 | 触发当前获得焦点的按钮（播放 / 暂停、静音等） |
通用
| 操作 | 功能 |
|---|---|
| 数值框拖动 | 调整数值 |
| Ctrl+单击数值框 | 输入精确数值（回车确认） |