渲染腳本

簡介

Cavalry 可以執行指令碼：

• 用於設定渲染佇列項目。
• 在渲染佇列項目執行的每次渲染之前。
• 在渲染佇列項目執行的每次渲染之後。

以下 API 都在 render 命名空間中。它們僅在渲染佇列項目中可用。可以在渲染管理器中的渲染佇列項目的指令碼選項卡上將指令碼新增到相應的編輯器中。

使用動態渲染時，動態索引可以透過 api.getDynamicIndex() 成員存取。

任何 JavaScript 執行都將阻止後續渲染，直到指令碼執行完成。這是有意為之，以便在任何下載/替換資源或以某種方式更改場景的過程完成後，再開始下一次渲染。

指令碼在整個序列渲染之前和之後執行，而不是在每張單獨圖片之前和之後執行。

類型

設定渲染指令碼

新增在任何渲染設定開始之前執行的指令碼，因此可用於影響渲染佇列項目本身。

預渲染指令碼

新增可用於操作和準備場景進行渲染的指令碼。

後渲染指令碼

新增在渲染佇列項目完成後執行的指令碼。

指令碼可以包括使用 JavaScript API 執行諸如修改屬性、從網路拉取新資訊、替換和重新載入資源等任務。

成員函式

composition → string

回傳渲染佇列項目中每個合成畫面的 layerId。作為預渲染和後渲染指令碼的一部分可用。

console.log(render.composition);

path → string

回傳渲染的檔案路徑——任何動態權杖/路徑都已完全解析。作為後渲染指令碼的一部分可用。

console.log(render.path);

renderQueueItem → string

回傳 renderQueueItemId 以便對其進行更改。作為設定渲染指令碼的一部分可用。

console.log(render.renderQueueItem);