系統文件與路徑

該軟件將數據存儲在三個不同的位置:項目文件夾中保存您構建的一切;程序文檔文件夾中保存庫、工作區和運行日誌;而Windows 系統本身則保存程序設置和許可證。您需要在以下三種情況下了解這一點:將項目轉移到另一台電腦時;轉移或重新安裝後項目中找不到圖片和視頻時;技術支持要求您提供運行日誌時。

確切的文件夾名稱取決於軟件版本以及您的安裝位置,因此下文按用途來稱呼它們:項目文件夾、程序文檔文件夾、安裝文件夾。在複製或刪除任何內容之前,請先在您自己的電腦上打開這些文件夾,核對其中實際存放的內容。

簡要說明:各項內容存放在何處

內容	位置	是否隨項目一起轉移
固定裝置(fixtures)、配接(patching)、合成(compositions)、效果(effects)、3D 場景	項目文件夾中的項目文件 `*.ls`	是,這就是項目本身
圖片、視頻、序列、音頻、模型貼圖	保存在您獲取它們的原始位置;項目中只記錄引用	僅當您將項目收集到一個文件夾中時
導出的動畫 `*.cue`	導出(Export)窗口中選擇的文件夾(默認是項目旁邊的 `Export` 子文件夾)	否,需要重新導出
自定義固定裝置、效果庫、工作區、日誌	程序文檔文件夾	否,需單獨複製
程序設置、最近項目列表、許可證	Windows 系統中,當前用戶的配置文件內	否,需重新設置

項目文件夾

如何創建

選擇文件(File) → 新建項目(New Project)(Ctrl+N)或在歡迎窗口中點擊創建(Create)。
在創建項目(Create Project)窗口中設置項目名稱(Project Name) —— 文件和文件夾都將以此命名。
在路徑(Path)字段中指定要在何處創建該文件夾:可手動輸入,也可點擊打開(Open)按鈕選擇。默認建議使用程序文檔文件夾中的 Scenes 子文件夾,但更方便的做法是將項目保存在您存放該場地工作素材的位置。
如有需要,修改項目每秒幀數(Frames per second for the project) —— 新建的合成將以此幀率創建。
點擊創建(Create)。

程序會在指定位置創建一個以項目命名的文件夾,將擴展名為 .ls 的項目文件放入其中,並同時在旁邊創建一個 Export 子文件夾 —— 它會自動填入導出(Export)窗口的路徑(Path)字段。

此後,可以把這個文件夾當作場地文件夾:將您在項目中使用的所有圖片、視頻、序列、音頻和模型都放入其中。程序只會在項目文件夾內部查找丟失的文件,而不會搜索整個磁盤。

項目文件中包含的內容

.ls 文件是一個單獨的文件,匯集了您構建的全部內容:

映射上的固定裝置及其尺寸、地址和名稱;
設備(Player、轉換器、端口)及配接;
合成、佈局、效果及其關鍵幀;
整個 3D 場景,包括導入模型的幾何體:導入後,原始模型文件 *.obj 或 *.fbx 已不再需要,沒有它項目也能打開;
項目中使用過的固定裝置 —— 因此即便在沒有您自定義固定裝置庫的電腦上,項目也能正常打開;
合成的導出設置。

項目文件中沒有的是媒體文件本身。圖片、視頻、視頻序列、音軌、模型貼圖和佈局背景圖都保存在磁盤上,項目中只記錄指向它們的路徑。如果此類文件被重命名、刪除,或留在了舊電腦上,項目中對應的效果會被標記為丟失。

項目備份

每次保存時,程序都會先把項目的上一個狀態另存為一個副本:項目文件旁邊會出現一個同名並在末尾添加 .backup 的文件。

如果項目在一次失敗的保存之後無法打開:

關閉程序。
把損壞的 .ls 文件挪到別處保存 —— 以防日後還用得上。
複製帶 .backup 的文件,並從副本名稱中去掉 .backup,得到一個普通的 .ls 文件。
在程序中打開它。

這樣您得到的項目將是上一次保存時的狀態。備份只有一份,並且每次保存都會被覆蓋,因此不能把它當作歸檔使用:重要的工作階段請通過文件(File) → 另存為…(Save As…)以不同的名稱分別保存。

程序如何查找丟失的文件

如果按項目中記錄的路徑找不到文件,程序不會立即放棄,而是自行搜索:

在項目文件夾及其所有子文件夾中查找同名文件;
對視頻序列文件夾,還會在項目文件夾內的 Import\Video 子文件夾中查找。

由此得出一條簡單的規則:把媒體文件保存在項目文件夾內。這樣項目文件夾被重命名或遷移到另一塊磁盤後依然能正常使用 —— 程序會自動找到所有文件。而如果圖片存放在桌面或 U 盤上,遷移後就需要手動重新選擇。

將項目轉移到另一台電腦

要連同所有外部文件一起收集項目,請使用文件(File) → 收集項目(Collect Project):

打開項目,選擇文件(File) → 收集項目(Collect Project)。
指定要收集到的文件夾。最好選擇一個空文件夾:程序會把項目文件以及它所使用的全部文件都放入其中。
等待完成 —— 對於包含視頻的大型項目,這需要一些時間。

具體過程是:項目文件的副本被寫入所選文件夾,所有外部文件被複製到 CollectProjectFiles 子文件夾中,並按照它們在磁盤上的原始位置分門別類地存放到對應的嵌套子文件夾里。收集後的項目內部路徑會相對於新文件夾重新構建,因此需要轉移的是整個文件夾,而不是單獨的 .ls 文件。

會被收集的內容包括:效果中的圖片和視頻、視頻序列、音軌、佈局背景圖,以及導入模型的貼圖。

有用的提示:

如果所選文件夾不可寫入,程序會給出提示並且不會收集任何內容 —— 請另選一個位置;
收集完成後,您仍在原項目中繼續工作,收集得到的副本只是單獨存放在磁盤上;
程序設置、工作區和許可證不會隨項目一起轉移 —— 需要在新電腦上重新設置。

導出的文件

合成導出會把文件保存到導出(Export)窗口路徑(Path)字段中指定的文件夾。對於在當前版本中創建的項目,該字段默認就是項目旁邊的 Export 子文件夾;可以通過打開(Open)按鈕更改。

文件	命名方式
Light Stream Player 使用的動畫	合成名稱,擴展名為 `.cue`
用於演示的視頻(視頻渲染模式)	合成名稱,擴展名為 `.mp4`
固定裝置遮罩	保存時您指定的名稱,擴展名為 `*.png`

文件名取自合成名稱,因此名稱中不允許出現字符 \ / : * ? " < > | —— 程序不允許輸入這些字符。

如果項目中有多台 Light Stream Player 設備,程序會在導出文件夾中為每台設備創建單獨的子文件夾,並把 *.cue 文件分別放入對應文件夾 —— 這樣一眼就能看出哪些動畫應加載到哪台播放器上。

程序文檔文件夾

程序首次啟動時,會在系統文檔文件夾中創建自己的文件夾,並把所有與工作場所相關(而非與單個項目相關)的內容保存在其中。該文件夾的確切名稱取決於軟件版本 —— 請在文檔中按程序名稱查找它,並對照下表核實其中的內容。

內容	查找位置
歡迎窗口中展示的演示項目;新建項目也默認建議保存於此	`Scenes` 子文件夾
固定裝置庫:出廠自帶的 `fixtures.lslib`、您的自定義 `UserFixtures.lslib`,以及 `Images` 子文件夾中固定裝置和廠商的圖片	`Fixtures` 子文件夾
效果庫 —— 效果(Effects)窗口的內容以及您保存的效果(文件 `LightStream.effects`)	`Effects` 子文件夾
工作區 —— 已保存的窗口佈局(文件 `ls.workspace`)	程序文檔文件夾根目錄
程序運行日誌	`logs` 子文件夾

遷移到新電腦時,其中值得複製的內容有:

UserFixtures.lslib 及 Images 子文件夾 —— 如果您製作過自己的固定裝置,並希望在新項目中繼續使用;
LightStream.effects —— 如果您按自己的需要調整過效果庫。保存效果庫時,程序會在旁邊留下一份帶 .backup 後綴的舊版本副本;
ls.workspace —— 如果您很看重自己的窗口佈局。

複製這個文件夾中的文件時應先關閉程序,否則部分改動會在程序退出時被覆蓋。

程序安裝文件夾

安裝路徑在安裝嚮導中設置;默認是Program Files中的一個文件夾。程序本體就存放在這裏 —— 例如在 NVIDIA 控制面板中配置性能時選擇的可執行文件(參見 Light Stream - 快速開始)。

不需要把自己的文件放到這裏:普通用戶在Program Files中沒有寫入權限,而且更新程序時該文件夾的內容會被覆蓋。項目、媒體和導出內容請保存在項目文件夾中。

設置、最近項目和許可證

選項(Options)窗口中的設置、文件(File) → 最近文件(Recent Files)列表以及許可證數據,既不保存在項目中,也不在可以複製的獨立文件里:它們記錄在 Windows 系統中,並與本電腦上的用戶賬戶綁定。由此可知:

無法通過複製文件夾的方式把設置轉移到另一台電腦 —— 語言、網卡、音頻設備等都需要重新設置;
同一台電腦上的每個 Windows 用戶都有各自的設置和各自的最近項目列表;
許可證與電腦綁定。在把程序轉移到另一台電腦之前,需要先在激活(Activation)窗口(幫助(Help) → 激活(Activation))中將其停用 —— 否則授權將一直被佔用;
安裝新版本程序後,窗口佈局可能會恢復為默認狀態。這是正常現象,您的工作區需要重新保存。

程序運行日誌

程序會記錄日誌:位於程序文檔文件夾中的 logs 子文件夾,文件為 ls.log。當文件增長到大約 1 MB 時,會被移入 archives 子文件夾,記錄則繼續寫入新文件;最多保留十份歸檔,更早的會自動刪除。

聯繫技術支持時需要用到日誌:如果程序自行關閉、卡死,或提示了不明確的錯誤,請在提交問題時附上 logs 文件夾的內容,並描述此前的操作。無需另外開啟日誌記錄 —— 它始終在運行。

值得備份的內容

備份的最小集合:

整個項目文件夾 —— .ls 文件連同媒體文件。如果媒體文件存放得比較分散,請先執行文件(File) → 收集項目(Collect Project),再備份收集後得到的文件夾。
導出的 *.cue 文件 —— 如果不想在現場重新導出。
程序文檔文件夾中的:帶 Images 子文件夾的 UserFixtures.lslib、LightStream.effects、ls.workspace。

程序設置和許可證無法複製 —— 只能手動恢復,許可證則需要通過停用來轉移。