Dala Amafilimu Enqubo Angadingi Amafa nge-JavaScript, Canvas, ne-Web Audio

Okungokwenziwa yi-procedural-film

procedural-film yikhono le-ejenti lokuguqula isihloko sibe ifilimu emile ecishe ibe yimizuzwana engu-30. Esikhundleni sokuhlanganisa amafayela ezithombe, amavidiyo noma omsindo, ifilimu ngayinye idweba izithombe zayo nge-JavaScript evamile ku-HTML canvas futhi ikhiqize umsindo wayo isebenzisa i-Web Audio API.

Iphrojekthi eqediwe ingakhiqiza isidlali se-HTML esizimele kanye nokukhishwa kwe-MP4. Ngenxa yokuthi izithombe nemisindo kukhiqizwa ngekhodi, ifilimu iza ingenazo nhlobo izimpahla zemidiya.

Indawo yokugcina ikhodi iqukethe ukukhiqizwa okuyisibonelo okuphelele ku-examples/butterfly-life. Ibonisa umjikelezo wokuphila kovemvane i-monarch ngezigcawu ezingu-17, ithatha imizuzwana engu-32 ku-120 bpm, futhi isebenzisa ifremu emile engu-1080-by-1920 kumafreyimu angu-24 ngomzuzwana.

Izici ezibalulekile

• Izithombe ezikhiqizwa ngekhodi: Iphikseli ngayinye idwetshwa nge-JavaScript evamile ne-Canvas.
• Umsindo owenziwe ngokuhlanganiswa: Wonke umsindo ukhiqizwa nge-Web Audio.
• Ukulethwa okungenazo izimpahla: Ifilimu ayincikile kumafayela emidiya ahlukene.
• Umphumela omile: Inqubo eyisibonelo ihlose ifomethi engu-1080-by-1920 elungele ifoni.
• Imiphumela eminingi: Inqubo idala isidlali se-HTML esizimele kanye nokukhishwa kwe-MP4.
• Ukukhiqizwa okusekelwe kuma-ejenti: Ama-subagent asebenza ngokufana angabhala izigcawu ngazinye, kuyilapho amagagasi abagxeki ebuyekeza izigcawu.
• Ukuqinisekiswa okwakhelwe ngaphakathi: Isibonelo sihlanganisa isango lekhwalithi elinokuhlola okuyisithupha ngaphambi kokunikezela.

Qonda ukwakheka kwendawo yokugcina ikhodi

Indawo yokugcina ikhodi ihlukaniswe yaba yikhono elingasetshenziswa kabusha kanye nesibonelo esisebenzayo:

• skills/procedural-film/ iqukethe ikhono le-ejenti.
• skills/procedural-film/SKILL.md ichaza yonke inqubo yokukhiqiza.
• skills/procedural-film/foundation/ iqukethe injini namathuluzi akopishelwa kufilimu ngayinye entsha.
• skills/procedural-film/templates/ iqukethe izifanekiso ezine zemibhalo yokuhlela.
• skills/procedural-film/reference/ iqukethe inkomba yezinhlobo zezigcawu, imihlahlandlela yezigcawu nomculo, kanye namafremu ayizethenjwa.
• examples/butterfly-life/ iqukethe imibhalo yokuhlela, ikhodi yomthombo, amathuluzi, isidlali se-HTML, kanye ne-MP4 yefoni yefilimu kavemvane.

Izidingo zangaphambili

Faka le software elandelayo ngaphambi kokusebenzisa ikhono:

• Node.js 20 noma entsha
• ffmpeg, etholakala ohlelweni lwakho ku-PATH
• Chromium ye-Playwright
• I-ejenti esekela amakhono nama-subagent asebenza ngokufana, njenge-Claude Code

Qinisekisa ukuthi i-Node.js ne-ffmpeg kuyatholakala:

node --version
ffmpeg -version

Faka ikhono le-procedural-film

1. Klona indawo yokugcina ikhodi

git clone https://github.com/kuhnhomeuk-cell/procedural-film.git

2. Xhumanisa ikhono ne-ejenti yakho

Kusuka kufolda equkethe indawo yokugcina ikhodi ekloniwe, dala isixhumanisi esingokomfanekiso kufolda yamakhono ye-Claude Code:

ln -s "$PWD/procedural-film/skills/procedural-film" ~/.claude/skills/procedural-film

Isixhumanisi esingokomfanekiso siwusizo ngoba sigcina isibonelo esisebenzayo sitholakala eduze nekhono ku-examples/butterfly-life/. Uma usebenzisa enye i-ejenti ehambisanayo, xhumanisa ifolda efanayo yekhono kufolda yamakhono yaleyo ejenti.

3. Faka ukuncika kwamathuluzi esibonelo

npm install --prefix examples/butterfly-life/tools

4. Faka i-Chromium ye-Playwright

npx --prefix examples/butterfly-life/tools playwright install chromium

Dala ifilimu ngesihloko

Uma ikhono selixhunyiwe, cela i-ejenti yakho ukuthi idale ifilimu ekhiqizwa ngekhodi mayelana nesihloko. Isibonelo:

Yenza ifilimu ekhiqizwa ngekhodi emayelana nokuphila kwenyosi yoju.

I-ejenti ilandela inqubo eku-skills/procedural-film/SKILL.md. Ukukhiqizwa kuklanywe ukuba kube banzi ngamabomu: i-ejenti eyodwa ngesigcawu ngasinye ibhala ifayela lesigcawu elingase lidlule emigqeni engu-1,000, bese amagagasi abagxeki ebuyekeza zonke izigcawu.

Hlela isikhathi seseshini ye-ejenti eside nesebenzisa izinsiza eziningi. I-README iphawula ukuthi ifilimu ephelele ingasebenzisa ingxenye enkulu yohlelo lokusetshenziswa kwe-ejenti.

Yakha kabusha ifilimu eyisibonelo kavemvane

Ukwakha kabusha isibonelo esifakiwe kuyindlela elula kakhulu yokuqinisekisa ukuthi i-Node.js, ffmpeg, Playwright ne-Chromium kulungiselelwe kahle.

1. Sebenzisa isango lokuqinisekisa

node examples/butterfly-life/tools/check.cjs

Umbhalo we-check.cjs usebenzisa isango lephrojekthi elinokuhlola okuyisithupha. Ukuqinisekiswa okuphumelele kuphuma ngekhodi yesimo ethi 0.

2. Nikeza i-MP4

node examples/butterfly-life/tools/render.cjs

Isinikezeli sibhala ividiyo ewumphumela ku:

examples/butterfly-life/exports/butterfly-life.mp4

3. Yakha kabusha isidlali se-HTML esizimele

node examples/butterfly-life/tools/build.cjs

Lo myalo wakha kabusha isidlali se-HTML. Isidlali esisebenzisanayo esikhona sitholakala ku-examples/butterfly-life/dist/butterfly-life.html futhi singalandwa noma sivulwe esipheqululini.

Inqubo yokuthuthukisa esebenzayo

1. Qala ngesihloko esichazwe ngokucacile bese ucela i-agent ukuthi yenze ifilimu echaza izinyathelo ngaso.
2. Vumela i-agent nama-subagent asebenza ngokuhambisana ukuthi akhiqize imibhalo yokuhlela namafayela ezigcawu.
3. Vumela amagagasi abagxeki ukuthi abuyekeze amashothi, kunokuba ume ngemva kokukhiqizwa kokuqala.
4. Qalisa ukuhlolwa kokuqinisekisa kwephrojekthi ngaphambi kokurenda.
5. Lungisa noma yiziphi izinkinga ezibikiwe, bese uphinda uqalise ukuhlola kuze kuphume ngempumelelo.
6. Renda i-MP4 bese wakha kabusha isidlali se-HTML esizimele ngokuphelele.
7. Vula isidlali esipheqululini bese ubuyekeza ifilimu yokugcina eqondile.

Amathiphu athuthukile

Sebenzisa ifilimu eyisethenjwa njengomgomo wokukhiqiza

Funda examples/butterfly-life lapho ufunda ukwakheka kwephrojekthi okulindelekile kanye nekhwalithi yomphumela. Imibhalo yayo yokuhlela, ikhodi yomthombo, amathuluzi, isidlali esirendiwe, kanye nevidiyo yefoni ethunyelwe kukhombisa lokho ikhono eliklanyelwe ukukhiqiza.

Funda izinkomba ezisekelayo ngaphambi kokushintsha isitayela

Uhla lwe-reference/ lufaka inkomba yezinhlobo zamashothi, iziqondiso zezigcawu, iziqondiso zomculo, kanye namafreyimu ayizinkomba ezibonakalayo. Lezi zinto zinikeza umongo wezinqumo ezenziwa yipayipi lama-agent.

Qinisekisa ngaphambi kwerendi yokugcina ngayinye

Qalisa check.cjs ngaphambi kwe-render.cjs. Phatha ikhodi yokuphuma eyimpumelelo yesango lokuhlola okuyisithupha njengemfuneko yokukhiqiza i-MP4 yokugcina.

Hlela isikhathi nokusetshenziswa kwama-agent

Le nqubo ibeka phambili ukukhiqizwa kwezigcawu okunemininingwane nokugxekwa okuphindaphindiwe kunomphumela osheshayo. Njengoba amafayela amashothi ngamanye engaba nemigqa engaphezu kuka-1,000, gwema ukucabanga ukuthi inqubo izophela njengomsebenzi omfushane wokukhiqiza ngomyalo owodwa.

Gcina ikhono lixhunyiwe kunokulikopisha

Isixhumanisi esingokomfanekiso sigcina ikhono lixhumene nendawo yokugcina ekhonjiwe futhi silondoloza ukufinyelela okulula esibonelweni se-butterfly. Lokhu futhi kugwema ukwakha ukufakwa okukopishiwe okuhlukile okunqamukile ekwakhekeni kwendawo yokugcina.

Isiphetho

i-procedural-film inikeza indlela eqhutshwa yi-agent yokukhiqiza amafilimu aqondile ngokuphelele kusetshenziswa umdwebo we-JavaScript nomsindo owenziwe ngokuhlanganiswa. Ngemva kokuxhumanisa ikhono nokufaka amathuluzi adingekayo, ungacela ifilimu ngesihloko, uqinisekise izigcawu ezikhiqiziwe, uthumele i-MP4, futhi wakhe isidlali se-HTML esizimele ngaphandle kokupakisha amafayela emidiya avamile.

Le phrojekthi itholakala ngaphansi kwe-MIT License. Indlela yayo yokubukeka nokuhlela ilingiswe ku-The life of a fruit fly kaKevin Ngo, nemininingwane erekhodwe ku-examples/butterfly-life/docs/reference-analysis.md.