自由相机框架

什么是FCFW？

FreeCamera框架（FCFW）是一个SKSE插件，为你的模组提供C++和Papyrus API，用于嵌入自定义相机逻辑。

FCFW是一个模组制作者的资源，而不是一个独立的游戏玩法模组—— 这是一个供其他模组使用的框架。单独使用时，它在游戏中不会有任何可见效果。

如果某个模组要求安装FCFW，请先安装它 作为一项要求。请注意，FCFW本身要求 powerofthree的调整 以正确支持身体部位！

此插件是即将推出的天际电影过场动画生成框架的一部分。 

FCFW能为模组社区提供什么？

观看以下视频，了解FCFW的一些应用示例：

电影过场生成：  使用FCFW实现的Skyrim过场动画——来自Caistorshold模组的场景




录制与回放摄像机路径： 使用FCFW实时录制并回放摄像机路径



示例模组：第二视觉法术——透过他人之眼： 一种让你通过其他角色视角体验世界的法术，由FCFW驱动。



程序化摄像机控制： FCFW可编程摄像机的示例：围绕移动角色平滑环绕，然后返回玩家视角




主要特色

• 完整的 Papyrus 与 SKSE 插件 API 支持。随附全面的示例模组与文档，助您快速上手。
• 通过控制点灵活定义摄像机路径，包括平移、旋转和视野（FOV）。控制点可位于世界坐标，或相对于任意对象参考。提供多种插值模式，用于调整各控制点之间的摄像机行为。
• 多时间线系统允许在同一插件内以及不同插件之间管理多条独立的摄像机时间线。
• 实时录制游戏内镜头运动。录制的镜头时间线可随时回放。
• 播放期间启用用户摄像机旋转控制的选项
• 摄像机时间轴可以导出为YAML文件，以便编辑和分发。导入预制或编辑过的摄像机时间轴，在模组或会话之间共享时间轴。
• 事件回调使您能够动态响应播放事件。例如，使用事件驱动逻辑串联摄像机时间轴序列
  

模组开发者快速入门

从此页面下载示例模组（FCFW_EXAMPLE），或直接从FCFW安装目录（`Documentation/PapyrusExample`）获取。将其安装到你的Data目录中，并在模组列表中激活FCFW_EXAMPLE.esp。

按下以下按键来测试FCFW_EXAMPLE功能：

• 按键‘1’ - 电影轨道序列：从当前摄像机位置平滑过渡至轨道入口（中心为玩家上方的标记参考点），随后围绕标记持续环绕运动（循环）。在此阶段，用户可在环绕过程中自由旋转摄像机。再次按下‘1’将平滑返回初始摄像机位置。
• 按键‘2’ - 播放序列：播放摄像机时间线。时间线可通过录制（按键‘3’）定义，或从导入的YAML（按键‘5’）定义。
• 键位‘3’ - 录制模式：实时记录镜头移动。可通过键位‘4’导出为YAML文件，并通过键位‘2’进行回放。
• 按键“4”——将录制的时间轴导出为YAML文件：将录制的时间轴导出为YAML文件，以便外部编辑及后续导入/使用。导出的时间轴文件可在天际数据文件夹中找到（`FCFW_EXAMPLE_TIMELINE.yaml`）。
• 按键“5”——从YAML文件导入已记录的时间轴：从`FCFW_EXAMPLE_TIMELINE.yaml`导入时间轴。通过按键“2”播放已导入的时间轴。
  

查看`Source/Scripts/FCFW_EXAMPLE_QUESTSCRIPT.psc`，了解如何使用FCFW API实现各种功能。查看注释部分中提出的练习，并开始修改脚本/YAML文件。

插件开发人员的综合参考文档：`Documentation/FCFW_DEVELOPER_REFERENCE.md`

完整API文档（Papyrus）：`Source/Scripts/FCFW_SKSEFunctions.psc`
完整的API文档（C++）：从FCFW获取`include/FCFW_API.h` GitHub.

要了解时间轴YAML文件格式，请查看`Documentation/TimelineFileExample/*.yaml`中的时间轴示例文件：

• FCFW_Timeline_orbitReference.yaml - 围绕参照物的循环轨道
• FCFW_Timeline_trackReferenceAndReturn.yaml - 将摄像机移动到参照物，跟踪一段时间，然后返回
• FCFW_Timeline_worldPath.yaml - 一条预录制的世界空间摄像机路径，末尾带有等待
  

完整的timeline YAML格式说明请见：`Documentation/TimelineFileExample/TIMELINE_FORMAT.md`


要求

• 天际脚本扩展器 (SKSE)
• SKSE插件地址库
• powerofthree的调整

制作人员与源代码

感谢

• CommonLib社区提供了Commonlib。
• 厄什 用于发布源代码 真方向移动，它作为部分相机相关逻辑的参考依据。
• 挑剔龙 为了这个想法，以及他对这一框架的支持。
• 卡西, 维尼, 教练 来自过场动画框架团队的支持。
  

FCFW来源： GitHub