系統文件與路徑

出自Light Stream (CN)

程序將數據存儲在三個不同的位置:項目文件夾(project folder)中存放您構建的一切;程序文檔文件夾(program documents folder)中存放庫、工作區(workspace)和工作日誌;而Windows 系統本身則存放程序設置和許可證。了解這一點在三種情況下很有必要:將項目轉移到另一台計算機時、在轉移或重新安裝後項目中找不到圖片和視頻時,以及技術支持要求您發送工作日誌時。

程序文檔文件夾是當前用戶系統文檔(Documents)文件夾中的 Light Stream 文件夾;程序在首次啟動時會自行創建它。項目文件夾是您在創建項目時自己選擇的,而安裝文件夾則是在安裝嚮導中選擇的。在複製或刪除任何內容之前,請先打開這些文件夾,核實其中實際存放的內容。

簡而言之:各類內容存放位置

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

項目文件夾

它是如何生成的

  1. 選擇File(文件) → New Project(新建項目)(Ctrl+N),或在Welcome to Light Stream(歡迎使用 Light Stream)歡迎窗口中點擊Create(創建)。
  2. 在Create Project(創建項目)窗口中設置Project Name(項目名稱)——文件和文件夾都將以此命名。
  3. 在Path(路徑)字段中指定在何處創建該文件夾:手動輸入,或使用Open(打開)按鈕。首次使用時,程序會建議使用程序文檔文件夾中的 Scenes 子文件夾,之後則會建議您上次選擇的文件夾。將項目保存在存放場地工作資料的位置會更方便。
  4. 如有需要,修改Frames Per Second for Project(項目的每秒幀數)——新建的合成將以此幀率創建。
  5. 點擊Create(創建)。

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

如果無法寫入所選位置,程序會以No write access(無寫入權限)的提示進行警告。系統盤根目錄和Program Files文件夾通常會出現這種情況——請選擇其他位置,例如Documents(文檔)。

接下來,不妨把這個文件夾當作場地文件夾:將項目中使用的所有圖片、視頻、音頻和模型都放入其中。程序能夠在項目文件夾內部(而非整個磁盤)搜索丟失的文件。

項目文件內部存放的內容

.ls 文件是一個單一文件,匯集了您構建的一切:

  • 映射(mapping)上的固定裝置及其尺寸、地址和名稱;
  • 設備(Player、轉換器、端口)及地址分配(patching);
  • 合成、布局(layout)、效果及其關鍵幀;
  • 整個 3D 場景,包括導入模型的幾何體:導入後,原始模型文件 *.obj 或 *.fbx 已不再需要,項目在沒有它的情況下也能打開;
  • 項目中使用過的固定裝置——因此即使在沒有您自定義固定裝置庫的計算機上,項目也能正常打開;
  • 導出文件夾以及標記了哪些合成需要導出的信息。

項目文件中沒有的是媒體文件本身。圖片、視頻、視頻序列、音軌、模型貼圖以及布局的背景圖片仍保存在磁盤上,項目中只記錄了指向它們的路徑。如果此類文件被重命名、刪除,或留在了舊計算機上,項目中的相應效果就會失去圖片。

視頻序列的幀

作為視頻序列(video sequence)導入項目的視頻,程序會預先將其拆分為單獨的幀——否則將無法流暢播放。這些幀被寫入項目文件夾內的 Import\Video 子文件夾:每個視頻都會生成一個以視頻文件名命名的文件夾,裡面存放編號文件 00000000.png、00000001.png,依此類推。

由此可得出以下幾點:

  • 導入視頻後,項目文件夾會成倍增大——解包後的幀比原始視頻占用的空間大得多。請提前規劃磁盤空間;
  • 這些幀就是序列本身:刪除該文件夾,效果將不再顯示任何內容,必須重新導入;
  • 轉移項目時必須連同 Import 子文件夾一起轉移,否則在新計算機上必須重新導入視頻;
  • 如果第二次導入同一個視頻,程序不會覆蓋舊的幀,而是在旁邊新建一個名稱中帶編號的文件夾。

項目備份副本

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

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

  1. 關閉程序。
  2. 將損壞的 .ls 文件另存到別處——以防日後還有用。
  3. 複製帶 .backup 後綴的文件,並從副本文件名中去掉 .backup,使其成為普通的 .ls 文件。
  4. 在程序中打開該文件。

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

程序如何查找丟失的文件

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

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

如果那裡也沒有找到,該效果將保持為空,其在時間軸(timeline)上的名稱會變為紅色。這樣可以立即看出哪些效果丟失了文件:選中該效果,並在Properties(屬性)窗口中重新指定文件。

由此可得出一條簡單的規則:將媒體文件保存在項目文件夾內。這樣一來,無論重命名文件夾還是遷移到另一個磁盤,項目都能正常使用——程序會自動找到所有文件。而如果圖片存放在桌面或 U 盤上,遷移後就必須手動重新選擇。

將項目轉移到另一台計算機

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

  1. 打開項目並選擇File(文件) → Collect Project(收集項目)。項目未打開時,該菜單項不可用。
  2. 指定要收集到的文件夾。最好選擇空文件夾:程序會將項目文件及其使用的所有文件都放入其中。
  3. 等待完成——對於帶有視頻的大型項目,這需要一些時間,在此期間光標會一直顯示等待狀態。

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

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

需要了解的信息:

  • 如果無法寫入所選文件夾,程序會以No write access(無寫入權限)提示進行警告,且不會收集任何內容——請選擇其他位置;
  • 收集完成後,您仍然在原項目中繼續工作,收集得到的副本只是單獨存放在磁盤上;
  • 程序設置、工作區和許可證不會隨項目一起轉移——需要在新計算機上重新設置。

導出文件

合成的導出會將文件放入Export(導出)窗口中Path(路徑)字段指定的文件夾。新項目中,該字段默認設置為項目旁邊的 Export 子文件夾;可以通過Open(打開)按鈕更改。所選文件夾會被記錄在項目中。

文件 命名方式
用於 Light Stream Player 的動畫 取自Export(導出)窗口中File Name(文件名)列的名稱;默認情況下是合成名稱加 .cue 擴展名
用於展示的視頻(Video Render(視頻渲染)模式) 合成名稱加擴展名,擴展名取決於所選編解碼器:.mp4、.mov 或 .avi
PNG Sequence(PNG 序列)模式下的幀 以合成名稱命名並帶 VideoSequence 後綴的文件夾,內部為 000000.png、000001.png 等文件
固定裝置遮罩(mask) 保存時您指定名稱的 *.png 文件

默認文件名取自合成名稱,因此程序會自動從合成名稱中移除 Windows 不允許出現在文件名中的保留字符——\ / : * ? " < > | 等。合成名稱長度限制為 40 個字符。

如果項目中有多台 Light Stream Player 設備,程序會在導出文件夾中為每台設備創建單獨的子文件夾,並將 *.cue 文件分別放入對應文件夾——這樣可以一目了然地看出哪些動畫應加載到哪台播放器上。關於導出的更多內容,請參見文章 導出合成。

程序文檔文件夾

程序首次啟動時,會在系統Documents(文檔)文件夾中創建自己的 Light Stream 文件夾,並將所有與工作場所(而非單個項目)相關的內容保存在其中。

內容 存放位置
默認為新項目建議的文件夾。程序首次啟動時,會根據其中找到的內容填充歡迎窗口中的項目列表:該文件夾及其子文件夾中找到的所有 *.ls 文件都會被列出 Scenes 子文件夾
固定裝置庫:出廠自帶的 fixtures.lslib、您的自定義 UserFixtures.lslib,以及位於 Images 子文件夾中的固定裝置和製造商圖片 Fixtures 子文件夾
效果庫——Effects(效果)窗口的內容,連同您保存的效果(LightStream.effects 文件) Effects 子文件夾
工作區(workspace)——已保存的窗口布局(ls.workspace 文件) 程序文檔文件夾根目錄
程序工作日誌(ls.log 文件) logs 子文件夾

遷移到新計算機時,以下內容值得複製:

  • UserFixtures.lslib 及 Images 子文件夾——如果您製作過自己的固定裝置,並希望在新項目中繼續使用;
  • LightStream.effects——如果您對效果庫做過自定義調整。保存效果庫時,程序會在旁邊保留上一版本的副本,並附加 .backup 後綴;
  • ls.workspace——如果您珍視自己的窗口布局。

複製該文件夾中的文件時應先關閉程序,否則部分更改會在程序退出時被覆蓋寫入:例如,工作區就是在程序關閉時才被保存的。

程序安裝文件夾

安裝路徑在安裝嚮導中設置;默認是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(激活))中停用它——否則許可證密鑰仍會處於占用狀態;
  • 從很舊的版本更新程序後,窗口布局可能會恢復為默認狀態。這是正常現象,您自己的工作區會重新保存。

程序工作日誌

程序會記錄日誌:位於程序文檔文件夾中的 logs 子文件夾,文件為 ls.log。當文件增長到大約一兆字節時,會被移入 archives 子文件夾,記錄則繼續寫入新文件;最多保留十個存檔,舊的存檔會自動刪除。

聯繫技術支持時需要用到日誌:如果程序自行關閉、卡死,或給出了不明原因的錯誤,請在提交請求時附上 logs 文件夾的內容,並說明此前的操作。無需單獨開啟日誌記錄——它始終在運行。

值得備份的內容

備份的最低限度內容:

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

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

參見

取自「http://cn.lightstream.pro/index.php?title=系统文件与路径&oldid=338」