Adegan Blender yang ikut membawa sumber dayanya.

Proyek Pli: resep adegan, dengan cakupan yang tepat

Pli adalah botol fiktif yang dirancang untuk latihan ini: badan ungu dengan sudut lembut, kerah oranye satin, label bermotif chevron, dan alas dari tanah liat. Generator menyiapkan pencahayaan studio dan komposisi yang menyisakan ruang di sebelah kiri. Generator membangun objek dan materialnya; satu-satunya gambar eksternal adalah motif PNG asli berukuran 512 × 512 piksel, disertai program yang membuat ulang motif tersebut. Tidak diperlukan model, HDRI, font, atau file klien.

Targetnya adalah Blender 4.5.x LTS dengan Cycles. Folder ini untuk gambar diam, tanpa simulasi atau ekstensi. Generator menolak cabang Blender lain agar pilihan ini tetap eksplisit. Python 3.10 atau lebih baru cukup untuk memeriksa file; untuk membangun adegan, diperlukan Python yang terintegrasi dengan Blender.

Pli menyediakan generator untuk dijalankan dengan Blender 4.5.x LTS. File dan kasus kesalahan telah diperiksa dengan Python 3.14.6; pembuatan adegan, pembukaannya, dan renderingnya masih perlu diuji di Blender. Tidak ada file .blend maupun hasil render yang disediakan.

Sebelum menyalin, tentukan apa yang harus dihasilkan proyek

Mulailah dengan mengidentifikasi hasil akhirnya: gambar diam, animasi, atau rangkaian varian. Catat perangkat lunak dan versinya, mesin render, kamera aktif, adegan, dimensi, dan parameter kualitas. Untuk animasi, tambahkan laju frame dan batas inklusif. Adegan yang dapat dibuka belum tentu menghasilkan tekstur, cache, atau pembingkaian yang sama.

Bekerjalah pada versi yang sudah dibekukan dan simpan file aslinya. Pisahkan sumber daya yang digunakan dari eksperimen yang ditinggalkan; dua tekstur yang namanya hampir sama dapat menjelaskan perbedaan material. Periksa juga hak transfer model, gambar, dan pustaka. Paket Pli menyediakan lisensi MIT untuk skrip, dokumen, motif, dan geometri yang dijelaskan miliknya sendiri; tambahan Anda mungkin memiliki ketentuan lain.

Dalam Pli, scene.json berperan sebagai lembar awal: versi target, inventaris sepuluh objek, dependensi grafis, mesin render, gambar 1, dan tujuan keluaran. File ini juga menyebutkan apa yang tidak ada dalam proyek ini: pustaka tertaut, font, cache, dan animasi. Ketidakhadiran yang dinyatakan mencegah folder kosong disalahartikan sebagai sumber daya yang terlupakan.

Struktur pohon di mana setiap file memiliki peran

Pertahankan root yang diberi versi, di sini blender-v1, dan ekstrak arsip sebelum bekerja. Pemisahan di bawah ini memungkinkan Anda menemukan sumber gambar, proyek yang dapat diedit, dan hasil yang akan dikirim. Ini tidak memaksakan konvensi universal: terutama gunakan nama yang dipahami oleh orang yang melanjutkan folder tanpa riwayat pesan Anda.

Sumber yang didistribusikan tercantum dalam manifest.sha256.json beserta ukuran dan sidik jarinya. Manifes mengecualikan dirinya sendiri untuk menghindari referensi melingkar. File .blend, PNG, dan laporan di masa depan adalah keluaran: file tersebut harus masuk ke inventaris pengiriman Anda sendiri setelah validasi.

Periksa ZIP yang diekstrak sebelum menjalankan Blender

Dari akar folder hasil ekstraksi, jalankan validator dengan Python yang independen. Validator ini membandingkan tiga belas file dengan manifes, memeriksa resep, jalur, dan PNG, lalu menganalisis sintaksis empat skrip. Hasil yang diharapkan untuk paket utuh adalah ok: true dan kode keluar 0. Pemeriksaan ini tidak mengimpor bpy dan tidak menghasilkan gambar 3D apa pun.

Pengujian kami dimulai dari ZIP yang diekstrak ke lokasi lain. Proses verifikasi hanya mengizinkan pembacaan di salinan tersebut dan di direktori Python yang digunakan; upaya mengakses resep asli secara eksplisit ditolak. Jadi, keberhasilan tidak bergantung pada tekstur yang ditemukan secara diam-diam di folder pembuatan.

Kode 1 mengharuskan Anda membaca daftar kesalahan. Jangan menulis ulang sidik jari untuk menghilangkan peringatan. Ambil kembali arsip yang utuh, atau buat versi kerja terpisah jika Anda ingin mengubah adegan. Sidik jari yang identik membuktikan integritas file terhadap manifes, bukan kualitas visualnya maupun identitas pembuatnya.

python validate_pack.py --root . --json

Membangun ulang flakon dan meminta render CPU kecil

Perintah berikut adalah prosedur yang harus dijalankan pada mesin yang memiliki Blender 4.5.x LTS; perintah ini belum dijalankan selama persiapan ini. Jalankan di proses terpisah: skrip dimulai dari scene kosong. Di Windows, jika blender tidak ada di PATH, gunakan path lengkap executable; di PowerShell, awali path yang diapit tanda kutip itu dengan &.

Generator terlebih dahulu memeriksa paket, membuat objek, memuat tekstur dari salinan, menggabungkannya, dan menyimpan 02_projet/renderparcel_pli_v1.blend. File yang disimpan menyiapkan Cycles CPU, 1.200 × 750 piksel, 64 sampel, dan gambar 1. Opsi --render-preview kemudian meminta PNG berukuran 480 × 300 piksel dan 16 sampel, tanpa denoising. Angka-angka ini adalah pengaturan, bukan pengukuran performa.

Laporan reconstruction.json ditulis setelah operasi berhasil dan menyatakan apakah render benar-benar dijalankan. Untuk hanya membangun .blend, hilangkan -- --render-preview. Skrip menolak menimpa output yang sudah ada: percobaan kedua dilakukan di ekstraksi baru. Opsi --python-exit-code 1 memungkinkan pengenalan exception skrip melalui kode keluar proses.

blender --background --factory-startup --python-exit-code 1 --python generate_scene.py -- --render-preview

Jalur relatif: mendeskripsikan posisi tanpa melupakan salinan

Di Blender, jalur yang dimulai dengan // merujuk pada lokasi file .blend. Karena proyek Pli akan berada di 02_projet, teksturnya dapat ditunjuk oleh //../03_ressources/pli-chevron.png. Folder sumber daya ikut berpindah bersamanya. Meskipun demikian, generator dimulai dengan jalur absolut yang diselesaikan di dalam salinan, menyertakan gambar, lalu menuliskan jalur relatif sebelum penyimpanan.

Untuk proyek yang sudah ada, simpan dulu file .blend ke folder transfer. Di File → External Data, Make Paths Relative mengubah referensi; operasi ini tidak menyalin sumber daya. Report Missing Files membantu menemukan tautan yang rusak. Find Missing Files mencari file di folder yang dipilih dan dapat memperbaiki referensi menjadi jalur absolut: periksa kembali sebelum mentransfer.

Jangan samakan "ditemukan di komputer ini" dengan "ada di dalam folder". Tekstur yang masih dapat diakses di folder Unduhan bisa menyamarkan kelalaian. Setelah penyalinan, buka proyek di lingkungan yang tidak lagi dapat memenuhi tautan dari lokasi lama tersebut, sambil tetap menyimpan cadangan yang terpisah.

Sematkan aset yang memenuhi syarat, inventarisasikan sisanya

Pack Resources memungkinkan penyertaan sumber daya yang memenuhi syarat ke dalam .blend; penyimpanan membuat operasi ini berlaku pada file yang dikirimkan. Ini tidak mengumpulkan semua dependensi: video merupakan pengecualian yang terdokumentasi. Pustaka yang ditautkan memiliki perintah penyertaan tersendiri. Karena itu, daftarkan apa yang disertakan dan apa yang harus tetap berada di samping proyek.

Untuk Pli, mempertahankan PNG eksternal memudahkan modifikasinya, sedangkan penyertaannya harus memungkinkan pola ditemukan kembali di file yang disimpan. Setelah tekstur dimodifikasi, sumber daya yang benar-benar digunakan harus diperbarui lalu versi yang tepat disimpan. Sekadar mengganti PNG di sebelahnya tidak membuktikan bahwa .blend menggunakan piksel barunya.

Buka kembali di proses kedua dan isi penerimaan yang sebenarnya

Setelah rekonstruksi berhasil, inspect_scene.py membuka .blend di proses Blender kedua, dengan eksekusi skrip internalnya dinonaktifkan. Skrip ini memeriksa inventaris, kamera, pengaturan keluaran, transformasi AgX, tekstur yang disertakan, dan jalur relatifnya. Laporannya menjelaskan pembukaan dan data; laporan ini tidak menjamin kualitas render.

Buka PNG yang dihasilkan di penampil gambar. Pastikan labu tetap sepenuhnya di dalam bingkai, label menampilkan pola krem, ungu, dan oranye, kontak dengan alas dapat terbaca, dan tidak ada tekstur magenta yang muncul. Kriteria ini adalah maksud penerimaan; kami tidak menerbitkan gambar acuan Blender yang dihitung untuk paket ini.

Salin 06_livraison/modele-reception.csv ke 06_livraison/reception-executee.csv, lalu isi lembar baru ini. Biarkan templat tetap utuh: templat itu milik manifes. Validator menerima salinan yang telah diisi tanpa mengubah sidik jari sumber, yang telah diverifikasi oleh uji penerimaan kami. Selanjutnya, inventarisasikan lembar ini dan keluaran yang disetujui ke dalam arsip pengiriman Anda.

blender --background --factory-startup --python-exit-code 1 --python inspect_scene.py

Dependensi yang hilang harus menghentikan pemeriksaan

Latihan negatif paket menghapus pli-chevron.png dari salinan uji, tanpa menyentuh sumber. Validator kemudian mengembalikan kode 1 dan mengidentifikasi baik file yang hilang dari inventaris maupun dependensi resep yang hilang. Generator memulai dengan pemeriksaan yang sama: ia harus menolak melanjutkan dengan salinan yang tidak lengkap ini.

Uji lain mengubah byte pertama PNG; pemeriksaan mendeteksi sidik jari yang berbeda dan tanda tangan gambar yang tidak valid. Uji ketiga mengganti jalurnya dengan referensi yang keluar dari folder, yang juga ditolak. Uji-uji ini memverifikasi cacat transfer yang konkret. Uji-uji ini tidak menyimulasikan pembukaan Blender maupun hilangnya cache dalam sebuah animasi.

Untuk mengulang latihan, bekerjalah hanya pada ekstraksi tambahan dan simpan salinan yang utuh. Perbaikannya adalah menemukan kembali sumber daya yang benar dan lokasi yang diharapkan. Tekstur berbeda dengan nama yang sama tidak memenuhi pemeriksaan integritas.

Menambahkan animasi mengubah cakupan pemeriksaan

Scene Pli hanya memiliki satu gambar dan tidak memerlukan cache apa pun. Jika Anda menambahkan asap, kain, atau simulasi, dokumentasikan jenis cache, versi komputasinya, lokasinya, dan seluruh rentang yang berguna. Mekanisme prakomputasi bergantung pada sistem fisik; jangan generalisasikan perilaku satu cache ke semua cache lainnya.

Bekukan hasilnya sebelum menyalinnya. Untuk sebuah sekuens, periksa awal, akhir, perubahan dekor atau simulasi, tetapi juga keberadaan setiap file perantara. Tiga gambar yang tampak benar tidak membuktikan bahwa 96 file dari animasi 1 hingga 96 tersedia. Nyatakan dengan jelas apakah sebuah cache disertakan atau harus dihitung ulang, dengan parameter dan input apa.

Terapkan logika yang sama pada sekuens tekstur, volume, suara, dan media penyuntingan. Jangan hapus satu-satunya sumber setelah pembuatan ZIP: simpanlah hingga salinan dibuka, keluaran diperiksa, dan semuanya dipulihkan.

Warna, memori, dan durasi: mengukur proyek yang sebenarnya

Pola Pli digunakan untuk warna dasar dan dinyatakan sRGB. Peta yang mendeskripsikan normal atau displacement tidak memiliki peran yang sama; interpretasinya harus sesuai dengan datanya. Pertahankan juga transformasi tampilan dan eksposur saat membandingkan keluaran. Perbedaan warna bisa berasal dari rantai tampilan, tanpa kaitan dengan daya komputasi.

Ukuran ZIP tidak menunjukkan kebutuhan memori GPU. Geometri yang dievaluasi, tekstur yang benar-benar dimuat, dan tahapan render lebih penting daripada jumlah file dalam arsip. Pratinjau CPU yang kecil tidak memprediksi puncak memori maupun durasi render akhir di GPU. Ukur satu keluaran lengkap yang representatif pada resolusi akhir sebelum memilih konfigurasi.

Workshop 3D membantu membingkai pemeriksaan ini. Bandingkan kemudian konfigurasi GPU berdasarkan kompatibilitas dan puncak yang teramati, dengan margin yang sesuai untuk proyek. Pilih 3, 7, atau 30 hari di konfigurator untuk mencakup pembukaan, uji coba, revisi, komputasi, dan pemulihan; tak satu pun dari jendela ini dengan sendirinya menjamin tenggat render. Panduan ekspor melanjutkan pekerjaan hingga file yang dapat diserahkan.

Apa yang telah diverifikasi, dan apa yang masih harus dijalankan

Tujuh pemeriksaan di bawah ini dijalankan di Windows dengan Python 3.14.6. Paket ini berisi empat belas file, termasuk manifes; tiga belas file tercakup oleh sidik jarinya. Tekstur dibangun ulang dan dibandingkan byte per byte di lingkungan ini. Kesamaan PNG ini tidak membuktikan identitas render 3D antarversi atau antarmesin.

Pemeriksaan mencakup file, dependensinya, dan kesalahan transfer. Pembuatan .blend, inspeksi scene, dan render CPU atau GPU belum diuji. README memberikan prosedur untuk memverifikasinya di Blender 4.5.x LTS.