Kaynaklarıyla birlikte yolculuk eden bir Blender sahnesi.

Pli projesi: net bir kapsamı olan bir sahne tarifi

Pli, bu alıştırma için tasarlanmış kurgusal bir şişedir: yumuşak kenarlı mor gövde, saten turuncu yaka, şerit desenli etiket ve kilden bir taban. Oluşturucu bir stüdyo ışığı ve solda boşluk bırakan bir kompozisyon öngörür. Nesneleri ve malzemeleri oluşturur; tek harici görsel, kendisini yeniden üreten programla birlikte gelen 512 × 512 piksel boyutunda orijinal bir PNG desenidir. Hiçbir model, HDRI, yazı tipi veya müşteri dosyası gerekmez.

Hedef, Cycles ile Blender 4.5.x LTS'dir. Klasör, simülasyon veya eklenti içermeyen sabit bir görsel içindir. Oluşturucu başka bir Blender dalını reddeder, böylece bu seçim açık kalır. Dosyaların kontrolü için Python 3.10 veya daha yenisi yeterlidir; sahneyi oluşturmak için Blender'a entegre Python gerekir.

Pli, Blender 4.5.x LTS ile çalıştırılacak bir oluşturucu sunar. Dosyalar ve hata durumları Python 3.14.6 altında kontrol edilmiştir; sahnenin oluşturulması, açılması ve render alınması Blender'da test edilmeyi beklemektedir. Hiçbir .blend dosyası veya render sunulmamaktadır.

Kopyalamadan önce projenin neyi yeniden üretmesi gerektiğine karar verin

Önce teslim edilecek ürünü belirleyin: sabit görsel, animasyon veya varyant serisi. Yazılımı ve sürümünü, motoru, etkin kamerayı, sahneyi, boyutları ve kalite parametrelerini not edin. Bir animasyon için kare hızını ve kapsayıcı sınırları ekleyin. Açılan bir sahne, mutlaka aynı dokuları, aynı önbellekleri veya doğru çerçevelemeyi yeniden üretmez.

Sabitlenmiş bir sürüm üzerinde çalışın ve orijinalleri saklayın. Kullanılan kaynakları terk edilmiş denemelerden ayırın; neredeyse aynı adı taşıyan iki doku, bir malzeme farkını açıklayabilir. Modellerin, görsellerin ve kütüphanelerin aktarım haklarını da kontrol edin. Pli paketi, kendi betikleri, belgeleri, deseni ve tarif edilen geometrisi için MIT lisansı sunar; sizin eklemelerinizin başka koşulları olabilir.

Pli'de scene.json başlangıç fişi rolünü oynar: hedef sürüm, on nesnenin envanteri, grafik bağımlılığı, motor, görsel 1 ve çıktı konumları. Ayrıca bu projede var olmayanları da belirtir: bağlı kütüphaneler, yazı tipleri, önbellekler ve animasyon. Beyan edilen bir yokluk, boş bir klasörün unutulmuş bir kaynak sanılmasını önler.

Her dosyanın bir rolü olan bir dizin yapısı

Sürümlenmiş bir kök tutun, burada blender-v1, ve çalışmadan önce arşivi çıkarın. Aşağıdaki ayrım, bir görselin kaynağını, düzenlenebilir projeyi ve teslim edilecek sonucu bulmayı sağlar. Evrensel bir kural dayatmaz: özellikle, klasörü devralan kişinin mesaj geçmişiniz olmadan anlayacağı adları benimseyin.

Dağıtılan kaynaklar, boyutları ve parmak izleriyle manifest.sha256.json içinde yer alır. Bildirim, döngüsel bir referanstan kaçınmak için kendisini hariç tutar. Gelecekteki .blend, PNG ve raporlar çıktıdır: doğrulamadan sonra kendi teslim envanterinize girmeleri gerekecektir.

Blender'ı başlatmadan önce çıkarılan ZIP'i doğrulayın

Çıkarılan klasörün kökünden, bağımsız bir Python ile doğrulayıcıyı çalıştırın. On üç dosyayı manifestoyla karşılaştırır, tarifi, yolları ve PNG'yi denetler, ardından dört betiğin sözdizimini analiz eder. Sağlam paket için beklenen sonuç ok: true ve çıkış kodu 0'dır. Bu denetim bpy'yi içe aktarmaz ve hiçbir 3D görüntü üretmez.

Denemelerimiz, ZIP'in başka bir konuma çıkarılmasıyla başlar. Doğrulama süreci okumalara yalnızca bu kopyada ve kullanılan Python'un dizininde izin verir; özgün tarife erişme girişimi açıkça reddedilir. Dolayısıyla başarı, oluşturma klasöründe sessizce bulunan bir dokuya bağlı değildir.

1 kodu, hata listesinin okunmasını gerektirir. Bir uyarıyı ortadan kaldırmak için parmak izlerini yeniden yazmayın. Arşivi sağlam haliyle tekrar alın veya sahneyi değiştirmek istiyorsanız ayrı bir çalışma sürümü oluşturun. Aynı parmak izi, dosyanın manifestoya göre bütünlüğünü kanıtlar; görsel kalitesini veya yazarının kimliğini değil.

python validate_pack.py --root . --json

Şişeyi yeniden oluşturun ve küçük bir CPU render'ı isteyin

Aşağıdaki komut, Blender 4.5.x LTS yüklü bir makinede çalıştırılacak prosedürdür; bu hazırlık sırasında çalıştırılmamıştır. Bunu ayrı bir süreçte başlatın: betik boş bir sahneden başlar. Windows'ta blender PATH'te değilse, yürütülebilir dosyanın tam yolunu kullanın; PowerShell'de bu yolun başına tırnak içinde & ekleyin.

Üretici önce paketi denetler, nesneleri oluşturur, dokuyu kopyadan yükler, dosyaya gömer ve 02_projet/renderparcel_pli_v1.blend dosyasını kaydeder. Kaydedilen dosya Cycles CPU, 1.200 × 750 piksel, 64 örnek ve görüntü 1 için ayarlanmıştır. --render-preview seçeneği ardından gürültü giderme olmadan 480 × 300 piksel ve 16 örnek içeren bir PNG talep eder. Bu sayılar performans ölçümleri değil, ayarlardır.

reconstruction.json raporu başarılı işlemlerden sonra yazılır ve render'ın gerçekten çalıştırılıp çalıştırılmadığını belirtir. Yalnızca .blend dosyasını oluşturmak için -- --render-preview kısmını çıkarın. Betik mevcut çıktıların üzerine yazmayı reddeder: ikinci bir deneme yeni bir çıkarma işleminde yapılır. --python-exit-code 1 seçeneği, bir betik istisnasının süreç çıkış koduyla tespit edilmesini sağlar.

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

Göreli yollar: kopyayı unutmadan konumu tanımlama

Blender'da // ile başlayan bir yol, .blend dosyasının konumuna göre belirlenir. Pli projesi 02_projet içinde olacağından, dokusu //../03_ressources/pli-chevron.png ile belirtilebilir. Kaynak klasörü onunla birlikte taşınır. Yine de üretici, kopyada çözümlenen mutlak bir yolla başlar, görüntüyü dosyaya gömer, ardından kaydetmeden önce göreli yolu yazar.

Mevcut bir proje için önce .blend dosyasını aktarım klasörüne kaydedin. File → External Data menüsünde Make Paths Relative, başvuruları dönüştürür; bu işlem kaynakları kopyalamaz. Report Missing Files, kopmuş bağlantıları bulmaya yardımcı olur. Find Missing Files, seçilen klasördeki dosyaları arar ve başvuruları mutlak yollara dönüştürerek onarabilir: aktarmadan önce bunları yeniden denetleyin.

« Bu makinede bulundu » ile « klasörde mevcut » ifadelerini karıştırmayın. İndirilenler klasöründe hâlâ erişilebilir olan bir doku, unutkanlığı gizleyebilir. Kopyaladıktan sonra, projeyi bu eski konumun artık bağlantıyı karşılayamayacağı bir ortamda açın; bunu yaparken bağımsız bir yedeği saklı tutun.

Uygun kaynakları dosyaya gömün, diğerlerini listeleyin

Pack Resources, uygun kaynakların .blend dosyasına dahil edilmesini sağlar; kaydetme, bu işlemi iletilen dosyada geçerli kılar. Bu, tüm bağımlılıkları bir araya toplamaz: videolar belgelenmiş bir karşı örnektir. Bağlantılı kütüphanelerin ayrı bir gömme komutu vardır. Bu nedenle neyin gömüldüğünü ve neyin projenin yanında kalması gerektiğini listeleyin.

Pli için harici PNG'yi korumak düzenlemesini kolaylaştırır, gömülmesi ise desenin kaydedilen dosyada bulunabilmesini sağlamalıdır. Doku değiştirildikten sonra gerçekte kullanılan kaynağı güncelleyip doğru sürümü kaydetmek gerekir. Yanındaki bir PNG'yi basitçe değiştirmek, .blend dosyasının yeni piksellerini kullandığını kanıtlamaz.

İkinci bir süreçte yeniden açın ve gerçek bir teslim alma formu doldurun

Başarılı bir yeniden oluşturmadan sonra inspect_scene.py, .blend dosyasını ikinci bir Blender sürecinde, dahili betiklerinin çalıştırılması devre dışı bırakılmış olarak açar. Envanteri, kamerayı, çıktı ayarlarını, AgX dönüşümünü, gömülü dokuyu ve göreli yolunu denetler. Raporu açılışı ve verileri açıklar; render kalitesini doğrulamaz.

Elde edilen PNG'yi bir görüntü görüntüleyicide açın. Şişenin tamamen çerçevenin içinde kaldığını, etiketin krem, mor ve turuncu deseni gösterdiğini, tabanla temasın okunabilir olduğunu ve hiçbir macenta dokunun görünmediğini doğrulayın. Bu ölçütler teslim alma niyetleridir; bu paket için hesaplanmış bir Blender referans görseli yayımlamıyoruz.

06_livraison/modele-reception.csv dosyasını 06_livraison/reception-executee.csv konumuna kopyalayın, ardından bu yeni formu doldurun. Şablonu bozulmadan bırakın: manifestoya aittir. Doğrulayıcı, doldurulmuş kopyayı kaynakların parmak izlerini değiştirmeden kabul eder; teslim alma testimiz bunu doğrulamıştır. Ardından bu formu ve onaylanan çıktıları teslim arşivinizde envanterleyin.

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

Eksik bir bağımlılık denetimi durdurmalıdır

Paketin olumsuz alıştırması, kaynaklara dokunmadan bir deneme kopyasından pli-chevron.png dosyasını kaldırır. Doğrulayıcı bu durumda 1 kodu döndürür ve hem envanterde eksik olan dosyayı hem de tarifteki eksik bağımlılığı belirler. Üretici aynı denetimle başlar: bu eksik kopyayla devam etmeyi reddetmelidir.

Başka bir deneme, PNG'nin ilk baytını değiştirir; denetim farklı bir parmak izi ve geçersiz bir görüntü imzası saptar. Üçüncüsü, yolunu klasörün dışına çıkan bir referansla değiştirir; bu da reddedilir. Bu denemeler somut aktarım hatalarını doğrular. Ne Blender'ın açılışını ne de bir animasyondaki önbelleğin kaybolmasını simüle ederler.

Alıştırmayı yeniden yapmak için yalnızca ek bir çıkarma kopyası üzerinde çalışın ve bozulmamış bir kopya saklayın. Düzeltme, doğru kaynağı ve beklenen konumunu bulmaktan geçer. Aynı ada sahip farklı bir doku, bütünlük denetimini karşılamaz.

Animasyon eklemek denetim kapsamını değiştirir

Pli sahnesinde yalnızca bir görüntü vardır ve hiçbir önbelleğe ihtiyaç duymaz. Ona bir duman, kumaş veya simülasyon eklerseniz, önbelleğin türünü, hesaplama sürümünü, konumunu ve tüm kullanılabilir aralığını belgeleyin. Ön hesaplama mekanizmaları fiziksel sisteme bağlıdır; bir önbelleğin davranışını diğerlerine genellemeyin.

Sonucu kopyalamadan önce sabitleyin. Bir dizi için başlangıcı, sonu, sahne veya simülasyon değişikliklerini, ayrıca her ara dosyanın mevcut olup olmadığını kontrol edin. Görsel olarak doğru üç görüntü, 1'den 96'ya kadar bir animasyonun 96 dosyasının da mevcut olduğunu kanıtlamaz. Bir önbelleğin teslim edilip edilmediğini veya hangi parametreler ve hangi girdilerle yeniden hesaplanması gerektiğini açıkça belirtin.

Aynı mantığı doku, hacim, ses ve kurgu medyası dizilerine de uygulayın. ZIP oluşturulduktan sonra tek kaynakları silmeyin: kopyayı açana, çıktıları kontrol edene ve bunları geri alana kadar saklayın.

Renk, bellek ve süre: gerçek projeyi ölçmek

Pli deseni temel renk için kullanılır ve sRGB olarak tanımlanmıştır. Normalleri veya yer değiştirmeyi tanımlayan bir harita aynı role sahip değildir; yorumu verileriyle örtüşmelidir. Çıktıları karşılaştırırken görüntüleme dönüşümünü ve pozlamayı da koruyun. Bir renk farkı, hesaplama gücünden bağımsız olarak görüntüleme zincirinden kaynaklanabilir.

ZIP dosyasının boyutu, GPU bellek ihtiyacını göstermez. Değerlendirilen geometri, gerçekten yüklenen dokular ve işleme adımları, bir arşivdeki dosya sayısından daha önemlidir. Küçük bir CPU önizlemesi, ne bellek zirvesini ne de GPU'daki nihai işleme süresini öngörür. Bir yapılandırma seçmeden önce, nihai çözünürlükte temsili bir tam çıktı ölçün.

3D atölyesi bu kontrolü çerçevelemeye yardımcı olur. Ardından GPU yapılandırmalarını uyumluluk ve gözlemlenen zirveye göre, projeye uygun bir marjla karşılaştırın. Açılış, denemeler, geri dönüşler, hesaplamalar ve kurtarma için yapılandırıcıda 3, 7 veya 30 gün seçin; bu pencerelerin hiçbiri tek başına bir işleme süresi garanti etmez. Dışa aktarma kılavuzu çalışmayı teslim edilebilir dosyalara kadar sürdürür.

Neyin doğrulandığı ve neyin hâlâ çalıştırılacağı

Aşağıdaki yedi kontrol Windows'ta Python 3.14.6 ile yürütülmüştür. Paket, manifest dahil on dört dosya içerir; on üç dosya manifestin özet değerleriyle kapsanmaktadır. Doku bu ortamda yeniden oluşturulmuş ve bayt bayt karşılaştırılmıştır. PNG'lerin bu eşitliği, sürümler veya donanımlar arasında 3D render kimliğini kanıtlamaz.

Kontroller dosyaları, bağımlılıklarını ve aktarım hatalarını kapsar. .blend oluşturma, sahne incelemesi ve CPU veya GPU render'ları test edilmemiştir. README, bunların Blender 4.5.x LTS'de nasıl doğrulanacağına ilişkin yordamı verir.