Gertie 是做什麼的?
Gertie 會將您編寫的小型場景檔案轉換為完成的動畫,產出 Lottie JSON 與動畫 SVG。您決定要畫什麼以及如何移動。Gertie 負責編譯、檢查與渲染。
此版本涵蓋了場景的編寫、編譯、驗證與品質檢查,產出兩種輸出格式,並可匯出為 GIF、APNG、WebP、WebM、ProRes、HEVC、MP4 以及 .lottie 壓縮檔,或直接輸出到符合其限制的平台(Telegram、Discord、Slack、WhatsApp 等),也可以根據分鏡表製作多場景影片(含字幕、轉場與音樂),以及製作文字字元(ASCII)動畫。匯出前請閱讀 references/export.md;製作影片前請閱讀 references/video.md;製作 ASCII 動畫前請閱讀 references/ascii.md。
規則
- 永遠不要手寫 Lottie JSON。請編寫場景檔案並進行編譯。
- 永遠不要提交未通過
qa且錯誤數為零的結果。 - 在編寫第一個場景之前,請閱讀
references/scene.md。跳過此步驟的模型會憑空發明不存在的欄位。 - 如果使用者提供 SVG,請匯入而非重新繪製:請閱讀
references/import.md。 - 如果使用者提供 Lottie 檔案,請閱讀
references/lottie.md。請勿手寫重製。 - 如果使用者提供 PNG 或 JPEG 格式的 Logo、圖示或平面插圖,請進行描繪:請閱讀
references/trace.md。如果它是帶有紋理的繪畫或照片,且使用者希望它稍微動一下(眨眼、歪頭、背景飄移),請閱讀references/cutout.md。 - 如果使用者展示影片或 GIF 並要求「像這樣動的東西」,請閱讀
references/motion-reference.md。 - 如果使用者想要一個包含多個場景(開場、精華片段、解說、廣告)且帶有字幕、轉場或音樂的影片,請閱讀
references/video.md。每個場景寫一個檔案,然後寫一個.story.json,並執行story。 - 如果使用者想要 ASCII 或文字字元動畫(README 橫幅、終端機載入動畫、復古風格、濃密色彩的字元或點陣剪輯),或展示 ASCII 剪輯要求模仿,請閱讀
references/ascii.md。這是一個獨立引擎,擁有自己的場景檔案(.ascii.json)和命令。小主題:將幀寫入文字檔案或生成它們。任何密集或流暢的東西:建立向量場景,通過qa,然後作為配方轉換。多個移動的東西:分層。要模仿剪輯:使用ascii probe檢查其網格和顏色。切勿用字元繪製大型形狀。 - 在繪製超出少數幾個形狀(角色、插圖、場景)的任何東西之前,請閱讀
references/artwork.md:建構順序、曲線路徑、陰影、調色盤、畫布大小。僅由基本圖形或純色組成的場景會引發W-ART-PRIMITIVE和W-ART-FLAT警告。 - 在為超出簡單旋轉或滑動的任何東西編寫關鍵影格之前(尤其是角色),請閱讀
references/motion.md。使用動作預設和骨架預設,而非手動放置關鍵影格:它們能為動畫提供緩動、預期、過衝和擠壓效果。
工作流程
-
理解需求。 確定主題、動作、尺寸以及是否循環。僅在缺少的答案會改變結果時才提問。否則使用預設值:512 x 512 畫布、30 fps、2 秒、循環、透明背景。
-
編寫場景 為
<name>.gertie.json。如果使用者提供 SVG,請先執行node scripts/gertie.mjs import <file.svg> --json並包含結果(請參閱references/import.md)。時間單位為秒。後面的節點會繪製在較早的節點之上。在合適的地方為物件指定motion預設。對於角色,請建立骨架並使用骨架預設(references/motion.md)。 -
檢查它。 在此技能檔案夾內執行
scripts/gertie.mjs中的腳本:node scripts/gertie.mjs qa <name>.gertie.json --json這會編譯場景、驗證輸出、在瀏覽器中渲染採樣影格並執行渲染檢查。檔案會輸出到場景旁的
out/資料夾:<name>.lottie.json、<name>.svg和<name>.sheet.png。檢查會分別渲染 Lottie 和 SVG,並逐格進行比較。 -
修復所有診斷資訊。 每個診斷都包含一個
code、指向場景的path、一個message和一個fix。應用修復方法,編輯場景,然後再次執行qa。先修復錯誤,再閱讀警告。W-LOOP-JUMP和W-R-LOOP表示循環有明顯跳動;W-R-CLIPPED表示某些東西被畫布邊緣切斷。W-SYNC表示同一個群組中的三個或更多子元素以相同的步調執行相同的循環,看起來很機械化:為群組指定一個帶有phase的stagger,或者為每個項目指定自己的phase。E-R-PARITY表示 Lottie 和 SVG 看起來不同,因此兩個輸出中有一個是錯的:它會指出影格、節點和差異圖片(outputs.parity)。簡化該節點的動畫以找出原因,並告知使用者這是否是 Gertie 的錯誤。 -
查看它。 開啟命名為
outputs.sheet的聯繫表單圖片。它以順序顯示八個影格,每個影格都標有影格編號和時間,並繪製在棋盤格上以便檢視透明度。檢查正確的物件是否存在、顏色是否正確、影格之間的動作是否合理、是否有被切斷或重疊的情況。如果不正確,請編輯場景並返回步驟 3。視覺修改最多進行三輪。除錯時序時,可使用--sheet-frames 16獲取更多細節。 -
根據品質標準進行衡量,適用於任何超出快速圖示範圍的東西。將場景頂層的
"tier"設定為您正在製作的類別,然後執行node scripts/gertie.mjs profile <scene>。請參閱下方的「品質分級」。 -
匯出 僅在使用者需要其他格式時才進行:
node scripts/gertie.mjs export <scene> --to <formats>或--for <destination>。請參閱references/export.md。除了lottie、svg和lottie-zip之外,其他格式都需要 ffmpeg。 -
交付
.lottie.json和.svg檔案、場景檔案以及聯繫表單。說明已檢查的項目。如果報告中有baked列表,表示 SVG 對那些屬性每個影格攜帶一個關鍵影格;這是正確的但檔案較大,簡化它們(對 trim start、end 和 offset 使用相同的緩動和時間;對變形或矩形和橢圓尺寸變化不使用過衝緩動)可以縮小體積。
其他命令:
node scripts/gertie.mjs qa <scene> --thorough 渲染每個影格,並檢查是否有單影格閃爍
node scripts/gertie.mjs compile <scene> --json 僅編譯,不啟動瀏覽器;--lottie 或 --svg 僅寫入一種輸出
node scripts/gertie.mjs validate <file> --json 檢查場景或任何 Lottie 檔案
node scripts/gertie.mjs export <scene> --to webm --json 寫入其他格式;請參閱 references/export.md
node scripts/gertie.mjs import <file.svg> --json 將 SVG 轉換為帶有摘要和標記預覽的片段;請參閱 references/import.md
node scripts/gertie.mjs trace <logo.png> --json 將平面 PNG 或 JPEG 描繪成形狀;然後分組;請參閱 references/trace.md
node scripts/gertie.mjs cutout <painting.png> <parts.json> --json 沿輪廓將繪畫剪切成圖層;請參閱 references/cutout.md
node scripts/gertie.mjs grid <image.png> --step 50 在圖片上繪製帶標籤的網格以讀取像素座標
node scripts/gertie.mjs render <file.lottie.json> --times 0.6,1.1 --out frames 在指定時間繪製全尺寸影格
node scripts/gertie.mjs story <video.story.json> --json 從場景建立 MP4,包含字幕、轉場和音樂;請參閱 references/video.md
node scripts/gertie.mjs ascii lint|render|export|gen|from|fx|play ... 文字字元動畫;請參閱 references/ascii.md
node scripts/gertie.mjs ascii probe <clip.mp4> --json 讀取 ASCII 剪輯的網格、顏色和影格率以便模仿
node scripts/gertie.mjs study <clip.mp4> --json 測量影片或 GIF 中的動作並繪製聯繫表單;請參閱 references/motion-reference.md
node scripts/gertie.mjs study <clip.mp4> --crop x,y,w,h --rate source --json 對同一主題以剪輯本身的影格率進行測量,並附上小幅擺動的靜止列表
node scripts/gertie.mjs sample <image-or-clip> --at x,y --at x,y 從像素中打印每個點的色彩值(十六進制);--time seconds 選擇剪輯的影格
node scripts/gertie.mjs profile <scene or file.json> [--tier icon|character|scene] --json 根據品質區間測量路徑、顏色、關鍵影格和緩動
node scripts/gertie.mjs inspect <file.json> --json 描述 Lottie 檔案;也可重新著色、重設時間和渲染,請參閱 references/lottie.md
node scripts/gertie.mjs doctor 報告 Node、瀏覽器和 ffmpeg 是否可用,以及哪些匯出格式可用
退出代碼 0 表示無錯誤,1 表示發現錯誤,2 表示命令無法執行。
品質分級
專業製作的同類動畫在測量時看起來相似。profile 以同樣方式測量您編譯的動畫,並將每個測量值標記為 inside、below 或 above 其分級的區間。它永遠不會失敗;它會告訴您差距在哪裡。validate --json 和 qa --json 在 profile 下包含相同的報告。
| 分級 | 內容 | 最重要的需求 |
|---|---|---|
icon | 圖示或載入動畫,約 512 像素,1.5 到 3 秒 | 形狀少(5 到 20 條路徑,2 到 5 種顏色),但每個動作都有緩動、過衝和乾淨的循環 |
character | 角色或插圖,800 到 1024 像素,2 到 6 秒 | 真正的繪圖:40 到 80 條路徑,6 到 12 種顏色,以及密集的動作(每秒 25 到 60 個關鍵影格,4 種或更多不同的緩動) |
scene | 完整場景,1080 像素,5 到 10 秒 | 更多繪圖(120 到 250 條路徑,12 到 20 種顏色),但動作不比角色多:把幾樣東西動得好即可 |
在場景中使用 "tier": "icon"(或 "character"、"scene")來宣告分級,使報告標記一個區間;沒有宣告時 profile 會報告所有三個分級。在所有分級中,目標是至少有四分之三的區段應用了緩動,至少有四分之一的動畫屬性從其自己的影格開始(偏移,不要同步)。路徑或顏色的 below 表示繪圖過於簡單;每秒關鍵影格的 below 表示物件在姿勢之間停止了移動。
每種輸出能做與不能做的事
- Lottie JSON 可在 lottie-web、dotlottie 播放器和原生行動播放器中播放。適用於應用程式。
- GIF、APNG、WebP、WebM、ProRes、HEVC、MP4 由
export產生。它們是動畫的圖片,而非向量。 - 動畫 SVG 不需要播放器也不需要 JavaScript。在瀏覽器中開啟、在
<img>標籤中和在 README 中播放(已在 Chromium 和 WebKit 中測試;Firefox 尚未測試)。無法暫停或拖動,原生行動應用程式也無法播放。在prefers-reduced-motion啟用時,它會顯示一個靜止影格,由場景可選的頂層poster(秒)決定。變形和矩形或橢圓尺寸的變化在減少動作模式下仍會持續移動。
如果您無法看到圖片
跳過步驟 5。依賴自動檢查,並告知使用者結果已自動檢查但未目視確認。
如果沒有瀏覽器
qa 仍會編譯和驗證,並報告 "render": "skipped",同時附上修復此問題的命令。執行 node scripts/gertie.mjs doctor,按照其指示操作,並告知使用者在問題解決之前,渲染檢查不會執行。
如果您無法執行命令
遵循 references/scene.md 編寫場景檔案,並將其連同編譯命令一起交給使用者。