| Contents |
|---|
| Introduction |
| Application |
| Project |
| Folders And Compositions |
| Example |
| Quick Tips |
| Conclusion |
在本文中，我將介紹使用腳本導航 After Effects 專案和合成的一些基礎知識。我將引用腳本指南中一些最有用的部分，並展示一些有關其工作原理的實際範例。
讓我們開始吧。
app
應用程式引用應用程式 After Effects 本身。要引用 After Effects 中的任何內容，您需要先告訴腳本查看應用程式。
雖然您可以引用安裝After Effects 的設定、檔案和電腦系統（我將在另一篇文章中介紹這些選項），但它很可能是您在應用程式後需要引用的主要物件是一個After Effects專案.
app.newProject()
newProject() 建立一個新的空項目。如果您想在此之前儲存目前的作品，After Effects 將會提示您。
app.open(file)
open() 同時允許您開啟現有項目。將括號留空，它將打開打開的項目對話框，就像導航到“文件”>“文件”一樣。在 After Effects 選單中開啟項目...。或者，您可以引用括號內的檔案來開啟特定項目。
project = new File ("...FilePath/AE Project.aep");
app.open(project);
您將需要建立一個新的 File() 來從腳本中尋找該檔案。我更喜歡將其存儲在變數中以保持整潔。再次，在文件開啟之前，系統會提示您儲存目前項目。
app.project
專案引用在 After Effects 中開啟的目前專案。從這裡，我們可以存取專案中的所有專案、建立新專案以及存取渲染佇列。
app.project.save([file])
save() 儲存項目。如果沒有新增檔案選項，或者如果之前沒有儲存過項目，此方法將彈出儲存對話框，以供使用者儲存項目。請記住 - 您需要在專案中建立一個新文件，然後才能在此方法中引用它。
app.project.importFile(importOptions)
importFile() 的運作方式有點像這樣：
new ImportOptions().file = new File("...FilePath/My File.jpg");
app.project.importFile(file)
我將在另一篇文章中更詳細地介紹匯入檔案。但作為快速概述，您可以使用此方法將文件匯入到專案中。您不僅需要建立一個新文件，還必須建立新的 ImportOptions 來指定要匯入的內容以及匯入方式。這使我們能夠執行諸如導入圖像序列、導入文件以及強制按字母順序排列等操作。
app.project.importFileWithDialog()
importFileWithDialog() 同時開啟匯入素材對話框，讓最終使用者選擇他們的檔案。
app
renderQueue 授予我們存取渲染佇列的權限，並允許我們設定渲染設定甚至渲染合成。我將在另一篇文章中詳細討論這一點。
app.newProject()
activeItem 指目前正在查看的項目，通常是合成、素材圖層、佔位或實體。它一次僅引用一項，如果有多個項處於活動狀態，或沒有項目處於活動狀態，則傳回 null。對於新增圖層或以某種方式影響使用者目前正在處理的內容的腳本，可以方便地引用活動合成。請注意，這與選擇的項目不同。
app.open(file)
選擇是指目前在項目面板中所選的所有項目。這是您在引用所選項目而不是活動項目時所需要的。
project = new File ("...FilePath/AE Project.aep");
app.open(project);
item() 特別指項目中的單一項目 - 無論是組合、實體或您擁有的其他項目。像這樣：
app.project
索引代表項目視窗內項目的索引號，也可以指圖層的名稱。
app.project.save([file])
items 指的是項目內的集合 項目。它用於創建新的作品和資料夾。
這讓我們很好地了解了資料夾和合成。
app.project.importFile(importOptions)
addFolder() 為您的專案建立一個新資料夾。確保名稱參數是一個字串（在“”或“”中）。
addComp() 然而還有更多的參數需要考慮。這是因為創作新作品需要大量資訊：
| Argument | Description |
|---|---|
| name | The name of the composition. Needs to be a string (in " " or ' ') |
| width | The width of your composition |
| height | The height of your composition |
| pixelAspect | The pixel aspect ratio. You are almost certainly looking to set this to Square Pixels, which you can do by setting the ratio to 1. Any other pixel aspect ratio can be set by entering the correct ratio (for example, Anamorphic 2:1 can be set by entering 2, and D1/DV PAL Widescreen can be set by entering 1.46). |
| duration | The duration of the composition in seconds |
| frameRate | The frame rate of the composition |
您可以透過引用資料夾來在資料夾內建立新的組合，如下所示：
app
並且可以透過設定項目的parentFolder屬性在事後將項目移至資料夾：
app.newProject()
建立合成後，您可以使用 openInViewer() 將其設定為活動項目
app.open(file)
使用我所介紹的一些內容，這裡有一個簡短的腳本，允許您打開一個新項目，創建 2 個資料夾和 2 個合成，並將一個合成添加到另一個合成中作為預合成。
project = new File ("...FilePath/AE Project.aep");
app.open(project);
執行此腳本後，您會發現，如果您在 After Effects 中按下撤消鍵，它一次只會撤消每個操作。大多數時候這並不理想，因為腳本經常經歷許多操作，這對最終用戶來說非常耗時且煩人。
app.project
這就是 beginUndoGroup() 和 endUndoGroup() 發揮作用的地方。它們允許您將腳本的操作組合在一起，以便可以一次性撤消它們。 undoString 是您將在 After Effects 中的撤銷選項旁邊看到的內容。如果您的腳本中只有一個 beginUndoGroup() 實例（因為它會自動關閉），則不一定需要添加 endUndoGroup()，但最好將其添加到腳本末尾，以保持您的腳本整潔。
我希望這有助於了解如何在製作 After Effects 腳本時參考 After Effects 專案和合成。在下一篇文章中，我將詳細介紹如何建立彈出窗口，以便使用者與您的腳本互動。
有任何疑問嗎？這裡有問題或不工作嗎？請在評論中告訴我。
以上是腳本編寫：After Effects 專案與合成的詳細內容。更多資訊請關注PHP中文網其他相關文章！
