查看“系统文件与路径”的源代码

[[ru:Системные файлы и пути]] [[en:System Files and Paths]] [[zh:系统文件与路径]]
程序将数据存储在三个不同的位置:'''项目文件夹(project folder)'''中存放您构建的一切;'''程序文档文件夹(program documents folder)'''中存放库、工作区(workspace)和工作日志;而'''Windows 系统'''本身则存放程序设置和许可证。了解这一点在三种情况下很有必要:将项目转移到另一台计算机时、在转移或重新安装后项目中找不到图片和视频时,以及技术支持要求您发送工作日志时。

程序文档文件夹是当前用户系统'''文档(Documents)'''文件夹中的 ''Light Stream'' 文件夹;程序在首次启动时会自行创建它。项目文件夹是您在创建项目时自己选择的,而安装文件夹则是在安装向导中选择的。在复制或删除任何内容之前,请先打开这些文件夹,核实其中实际存放的内容。

== 简而言之:各类内容存放位置 ==

{| class="wikitable"
! 内容 !! 位置 !! 是否随项目一起转移
|-
| 固定装置(fixtures)、地址分配(patching)、合成(compositions)、效果(effects)、3D 场景 || 项目文件夹中的项目文件 <code>*.ls</code> || 是,这就是项目本身
|-
| 图片、视频、音频、模型贴图 || 存放在您获取它们的原始位置;项目中只记录了引用路径 || 仅当将项目收集到一个文件夹中时
|-
| 导入的视频序列(video sequence)的帧 || 项目文件夹内的 <code>Import\Video</code> 子文件夹 || 是,前提是整体转移项目文件夹
|-
| 导出的动画 <code>*.cue</code> || '''Export(导出)'''窗口中'''路径(Path)'''字段指定的文件夹(新项目中默认是项目旁边的 <code>Export</code> 子文件夹) || 否,导出需要重新进行
|-
| 自定义固定装置、效果库、工作区、日志 || 程序文档文件夹 || 否,需单独复制
|-
| 程序设置、最近项目列表、许可证 || Windows 系统中,当前用户配置文件内 || 否,需要重新设置
|}

== 项目文件夹 ==

=== 它是如何生成的 ===

# 选择'''File(文件)''' → '''New Project(新建项目)'''(''Ctrl+N''),或在'''Welcome to Light Stream(欢迎使用 Light Stream)'''欢迎窗口中点击'''Create(创建)'''。
# 在'''Create Project(创建项目)'''窗口中设置'''Project Name(项目名称)'''——文件和文件夹都将以此命名。
# 在'''Path(路径)'''字段中指定在何处创建该文件夹:手动输入,或使用'''Open(打开)'''按钮。首次使用时,程序会建议使用程序文档文件夹中的 <code>Scenes</code> 子文件夹,之后则会建议您上次选择的文件夹。将项目保存在存放场地工作资料的位置会更方便。
# 如有需要,修改'''Frames Per Second for Project(项目的每秒帧数)'''——新建的合成将以此帧率创建。
# 点击'''Create(创建)'''。

程序会在指定位置创建一个以项目命名的文件夹,将扩展名为 <code>.ls</code> 的项目文件放入其中,并同时在旁边创建一个 <code>Export</code> 子文件夹——该文件夹会立即填入'''Export(导出)'''窗口的'''Path(路径)'''字段中。

如果无法写入所选位置,程序会以'''No write access(无写入权限)'''的提示进行警告。系统盘根目录和'''Program Files'''文件夹通常会出现这种情况——请选择其他位置,例如'''Documents(文档)'''。

接下来,不妨把这个文件夹当作场地文件夹:将项目中使用的所有图片、视频、音频和模型都放入其中。程序能够在项目文件夹内部(而非整个磁盘)搜索丢失的文件。

=== 项目文件内部存放的内容 ===

<code>.ls</code> 文件是一个单一文件,汇集了您构建的一切:

* 映射(mapping)上的固定装置及其尺寸、地址和名称;
* 设备(Player、转换器、端口)及地址分配(patching);
* 合成、布局(layout)、效果及其关键帧;
* 整个 3D 场景,包括导入模型的几何体:导入后,原始模型文件 <code>*.obj</code> 或 <code>*.fbx</code> 已不再需要,项目在没有它的情况下也能打开;
* 项目中使用过的固定装置——因此即使在没有您自定义固定装置库的计算机上,项目也能正常打开;
* 导出文件夹以及标记了哪些合成需要导出的信息。

项目文件中'''没有'''的是媒体文件本身。图片、视频、视频序列、音轨、模型贴图以及布局的背景图片仍保存在磁盘上,项目中只记录了指向它们的路径。如果此类文件被重命名、删除,或留在了旧计算机上,项目中的相应效果就会失去图片。

=== 视频序列的帧 ===

作为视频序列(video sequence)导入项目的视频,程序会预先将其拆分为单独的帧——否则将无法流畅播放。这些帧被写入项目文件夹内的 <code>Import\Video</code> 子文件夹:每个视频都会生成一个以视频文件名命名的文件夹,里面存放编号文件 <code>00000000.png</code>、<code>00000001.png</code>,依此类推。

由此可得出以下几点:

* 导入视频后,项目文件夹会成倍增大——解包后的帧比原始视频占用的空间大得多。请提前规划磁盘空间;
* 这些帧就是序列本身:删除该文件夹,效果将不再显示任何内容,必须重新导入;
* 转移项目时必须连同 <code>Import</code> 子文件夹一起转移,否则在新计算机上必须重新导入视频;
* 如果第二次导入同一个视频,程序不会覆盖旧的帧,而是在旁边新建一个名称中带编号的文件夹。

=== 项目备份副本 ===

每次保存时,程序都会先将项目的上一个状态另存为一个副本:项目文件旁会出现一个同名文件,末尾附加 <code>.backup</code>。

如果项目在一次保存失败后无法再打开:

# 关闭程序。
# 将损坏的 <code>.ls</code> 文件另存到别处——以防日后还有用。
# 复制带 <code>.backup</code> 后缀的文件,并从副本文件名中去掉 <code>.backup</code>,使其成为普通的 <code>.ls</code> 文件。
# 在程序中打开该文件。

这样您将得到项目在上一次保存时的状态。备份副本只有一份,并且每次保存时都会被覆盖,因此不能把它当作存档来依赖:重要的工作阶段请通过'''File(文件)''' → '''Save As…(另存为…)'''以单独的名称保存。

=== 程序如何查找丢失的文件 ===

如果按照项目中记录的路径找不到文件,程序不会立即放弃,而是会自行搜索:

* 在项目文件夹及其所有子文件夹中查找同名文件;
* 对视频序列文件夹,还会在项目文件夹内的 <code>Import\Video</code> 子文件夹中查找。

如果那里也没有找到,该效果将保持为空,其在时间轴(timeline)上的名称会变为红色。这样可以立即看出哪些效果丢失了文件:选中该效果,并在'''Properties(属性)'''窗口中重新指定文件。

由此可得出一条简单的规则:将媒体文件保存在项目文件夹内。这样一来,无论重命名文件夹还是迁移到另一个磁盘,项目都能正常使用——程序会自动找到所有文件。而如果图片存放在桌面或 U 盘上,迁移后就必须手动重新选择。

== 将项目转移到另一台计算机 ==

要将项目连同所有外部文件一起收集起来,请使用'''File(文件)''' → '''Collect Project(收集项目)''':

# 打开项目并选择'''File(文件)''' → '''Collect Project(收集项目)'''。项目未打开时,该菜单项不可用。
# 指定要收集到的文件夹。最好选择空文件夹:程序会将项目文件及其使用的所有文件都放入其中。
# 等待完成——对于带有视频的大型项目,这需要一些时间,在此期间光标会一直显示等待状态。

具体过程如下:项目文件的副本会写入所选文件夹,所有外部文件则会被复制到 <code>CollectProjectFiles</code> 子文件夹中,并按照它们在磁盘上原来的位置分布到相应的嵌套子文件夹里。收集后的项目内部路径会相对于新文件夹重新构建,因此必须转移'''整个文件夹''',而不是单独的 <code>.ls</code> 文件。

会被收集的内容包括:效果中的图片和视频、视频序列、音轨、布局背景图片,以及导入模型的贴图。

需要了解的信息:

* 如果无法写入所选文件夹,程序会以'''No write access(无写入权限)'''提示进行警告,且不会收集任何内容——请选择其他位置;
* 收集完成后,您仍然在原项目中继续工作,收集得到的副本只是单独存放在磁盘上;
* 程序设置、工作区和许可证不会随项目一起转移——需要在新计算机上重新设置。

== 导出文件 ==

合成的导出会将文件放入'''Export(导出)'''窗口中'''Path(路径)'''字段指定的文件夹。新项目中,该字段默认设置为项目旁边的 <code>Export</code> 子文件夹;可以通过'''Open(打开)'''按钮更改。所选文件夹会被记录在项目中。

{| class="wikitable"
! 文件 !! 命名方式
|-
| 用于 '''Light Stream Player''' 的动画 || 取自'''Export(导出)'''窗口中'''File Name(文件名)'''列的名称;默认情况下是'''合成名称'''加 <code>.cue</code> 扩展名
|-
| 用于展示的视频('''Video Render(视频渲染)'''模式) || '''合成名称'''加扩展名,扩展名取决于所选编解码器:<code>.mp4</code>、<code>.mov</code> 或 <code>.avi</code>
|-
| '''PNG Sequence(PNG 序列)'''模式下的帧 || 以合成名称命名并带 ''VideoSequence'' 后缀的文件夹,内部为 <code>000000.png</code>、<code>000001.png</code> 等文件
|-
| 固定装置遮罩(mask) || 保存时您指定名称的 <code>*.png</code> 文件
|}

默认文件名取自合成名称,因此程序会自动从合成名称中移除 Windows 不允许出现在文件名中的保留字符——\ / : * ? " &lt; &gt; | 等。合成名称长度限制为 40 个字符。

如果项目中有多台 '''Light Stream Player''' 设备,程序会在导出文件夹中为每台设备创建单独的子文件夹,并将 <code>*.cue</code> 文件分别放入对应文件夹——这样可以一目了然地看出哪些动画应加载到哪台播放器上。关于导出的更多内容,请参见文章 [[导出合成]]。

== 程序文档文件夹 ==

程序首次启动时,会在系统'''Documents(文档)'''文件夹中创建自己的 ''Light Stream'' 文件夹,并将所有与工作场所(而非单个项目)相关的内容保存在其中。

{| class="wikitable"
! 内容 !! 存放位置
|-
| 默认为新项目建议的文件夹。程序首次启动时,会根据其中找到的内容填充欢迎窗口中的项目列表:该文件夹及其子文件夹中找到的所有 <code>*.ls</code> 文件都会被列出 || <code>Scenes</code> 子文件夹
|-
| 固定装置库:出厂自带的 <code>fixtures.lslib</code>、您的自定义 <code>UserFixtures.lslib</code>,以及位于 <code>Images</code> 子文件夹中的固定装置和制造商图片 || <code>Fixtures</code> 子文件夹
|-
| 效果库——'''Effects(效果)'''窗口的内容,连同您保存的效果(<code>LightStream.effects</code> 文件) || <code>Effects</code> 子文件夹
|-
| 工作区(workspace)——已保存的窗口布局(<code>ls.workspace</code> 文件) || 程序文档文件夹根目录
|-
| 程序工作日志(<code>ls.log</code> 文件) || <code>logs</code> 子文件夹
|}

迁移到新计算机时,以下内容值得复制:

* <code>UserFixtures.lslib</code> 及 <code>Images</code> 子文件夹——如果您制作过自己的固定装置,并希望在新项目中继续使用;
* <code>LightStream.effects</code>——如果您对效果库做过自定义调整。保存效果库时,程序会在旁边保留上一版本的副本,并附加 <code>.backup</code> 后缀;
* <code>ls.workspace</code>——如果您珍视自己的窗口布局。

复制该文件夹中的文件时应先关闭程序,否则部分更改会在程序退出时被覆盖写入:例如,工作区就是在程序关闭时才被保存的。

== 程序安装文件夹 ==

安装路径在安装向导中设置;默认是'''Program Files'''内的一个文件夹。程序本身就存放在这里——例如,在 NVIDIA 控制面板中配置性能时选择的可执行文件就在此处(参见 [[Light Stream - 快速开始]])。

不需要把自己的文件放在这里:普通用户对'''Program Files'''没有写入权限,而且程序更新时该文件夹的内容会被覆盖。请将项目、媒体和导出内容保存在项目文件夹中。

== 设置、最近项目与许可证 ==

'''Settings(设置)'''窗口中的设置、'''File(文件)''' → '''Recent Files(最近文件)'''列表以及许可证数据既不保存在项目中,也不保存在可以复制的单独文件中:它们记录在 Windows 系统中,并与本机的用户账户绑定。由此可知:

* 无法通过复制文件夹将设置转移到另一台计算机——语言、网卡、音频设备等都需要重新设置;
* 同一台计算机上的每个 Windows 用户都有各自的设置和各自的最近项目列表;
* 最近项目列表最多保存十条记录——无论是在'''File(文件)''' → '''Recent Files(最近文件)'''菜单中,还是在欢迎窗口中都是如此。多余的条目可通过右键(right-click) → '''Remove from this list(从此列表中删除)'''移除;右键 → '''Show in Explorer(在资源管理器中显示)'''可帮助在磁盘上找到项目文件夹;
* 许可证与计算机绑定。将程序转移到另一台机器之前,必须先在'''Activation(激活)'''窗口('''Help(帮助)''' → '''Activation(激活)''')中停用它——否则许可证密钥仍会处于占用状态;
* 从很旧的版本更新程序后,窗口布局可能会恢复为默认状态。这是正常现象,您自己的工作区会重新保存。

== 程序工作日志 ==

程序会记录日志:位于程序文档文件夹中的 <code>logs</code> 子文件夹,文件为 <code>ls.log</code>。当文件增长到大约一兆字节时,会被移入 <code>archives</code> 子文件夹,记录则继续写入新文件;最多保留十个存档,旧的存档会自动删除。

联系技术支持时需要用到日志:如果程序自行关闭、卡死,或给出了不明原因的错误,请在提交请求时附上 <code>logs</code> 文件夹的内容,并说明此前的操作。无需单独开启日志记录——它始终在运行。

== 值得备份的内容 ==

备份的最低限度内容:

# 整个项目文件夹——<code>.ls</code> 文件连同媒体文件及 <code>Import</code> 子文件夹。如果媒体文件分散存放在各处,请先执行'''File(文件)''' → '''Collect Project(收集项目)''',然后备份收集得到的文件夹。
# 导出的 <code>*.cue</code> 文件——如果不想在现场重新进行导出。
# 程序文档文件夹中的:带 <code>Images</code> 子文件夹的 <code>UserFixtures.lslib</code>、<code>LightStream.effects</code>、<code>ls.workspace</code>。

程序设置和许可证无法复制——需要手动恢复设置,许可证则通过停用后重新激活来转移。

== 参见 ==

* [[Light Stream - 快速开始]]
* [[设置]]
* [[工作区]]
* [[导出合成]]
* [[固定装置库]]
* [[导入OBJ模型]]
* [[术语]]