Una scena Blender che viaggia con le sue risorse.

Il progetto Pli: una ricetta di scena, con un perimetro preciso

Pli è un flacone fittizio immaginato per questo esercizio: corpo viola dagli spigoli morbidi, colletto arancione satinato, etichetta a chevron e base in argilla. Il generatore prevede una luce da studio e una composizione che lascia spazio a sinistra. Costruisce gli oggetti e i materiali; l'unica immagine esterna è un motivo PNG originale di 512 × 512 pixel, accompagnato dal programma che lo ricrea. Non servono modelli, HDRI, font o file del cliente.

Il target è Blender 4.5.x LTS con Cycles. La cartella riguarda un'immagine fissa, senza simulazione né estensioni. Il generatore rifiuta un altro ramo di Blender affinché questa scelta resti esplicita. Un Python 3.10 o più recente basta per il controllo dei file; per costruire la scena serve il Python integrato in Blender.

Pli fornisce un generatore da eseguire con Blender 4.5.x LTS. I file e i casi di errore sono stati controllati sotto Python 3.14.6; la creazione della scena, la sua apertura e il rendering restano da testare in Blender. Non viene fornito alcun file .blend né alcun rendering.

Prima della copia, decidi cosa deve restituire il progetto

Inizia identificando il deliverable: immagine fissa, animazione o serie di varianti. Annota il software e la sua versione, il motore, la camera attiva, la scena, le dimensioni e i parametri di qualità. Per un'animazione, aggiungi la frequenza e gli estremi inclusivi. Una scena che si apre non restituisce necessariamente le stesse texture, gli stessi cache o l'inquadratura giusta.

Lavora su una versione congelata e conserva gli originali. Separa le risorse utilizzate dalle ricerche abbandonate; due texture quasi omonime possono spiegare una differenza di materiale. Verifica anche i diritti di trasferimento di modelli, immagini e librerie. Il pacchetto Pli fornisce una licenza MIT per i suoi script, documenti, motivo e geometria descritta; le tue aggiunte possono avere altre condizioni.

In Pli, scene.json svolge il ruolo di scheda di partenza: versione target, inventario dei dieci oggetti, dipendenza grafica, motore, immagine 1 e destinazioni degli output. Indica anche ciò che non esiste in questo progetto: librerie collegate, font, cache e animazione. Un'assenza dichiarata evita di scambiare una cartella vuota per una risorsa dimenticata.

Una struttura in cui ogni file ha un ruolo

Mantieni una radice versionata, qui blender-v1, ed estrai l'archivio prima di lavorare. La separazione qui sotto permette di ritrovare la sorgente di un'immagine, il progetto modificabile e il risultato da consegnare. Non impone una convenzione universale: adotta soprattutto nomi che chi riprende la cartella comprenda senza la tua cronologia di messaggi.

Le sorgenti distribuite sono elencate in manifest.sha256.json con la loro dimensione e la loro impronta. Il manifest esclude se stesso per evitare un riferimento circolare. I futuri .blend, PNG e report sono output: dovranno entrare nel tuo inventario di consegna dopo la validazione.

Controllare lo ZIP estratto prima di avviare Blender

Dalla radice della cartella estratta, avvia il validatore con un Python indipendente. Confronta tredici file con il manifest, verifica la ricetta, i percorsi e il PNG, poi analizza la sintassi di quattro script. Il risultato atteso per il pacchetto intatto è ok: true e un codice di uscita 0. Questo controllo non importa bpy e non produce alcuna immagine 3D.

I nostri test partono dallo ZIP estratto in un'altra posizione. Il processo di verifica consente letture solo in quella copia e nella directory del Python utilizzato; un tentativo di accedere alla ricetta originale viene esplicitamente rifiutato. Il successo non dipende quindi da una texture ritrovata silenziosamente nella cartella di creazione.

Un codice 1 impone di leggere la lista degli errori. Non riscrivere le impronte per far sparire un avviso. Riprendi l'archivio intatto, oppure crea una versione di lavoro separata se vuoi modificare la scena. Un'impronta identica prova l'integrità del file rispetto al manifest, non la sua qualità visiva né l'identità del suo autore.

python validate_pack.py --root . --json

Ricostruire il flacone e richiedere un piccolo render CPU

Il comando seguente è la procedura da eseguire su una macchina con Blender 4.5.x LTS; non è stata eseguita durante questa preparazione. Avvialo in un processo dedicato: lo script parte da una scena vuota. Su Windows, se blender non è nel PATH, usa il percorso completo dell'eseguibile; in PowerShell, anteponi & a quel percorso tra virgolette.

Il generatore controlla prima il pacchetto, crea gli oggetti, carica la texture dalla copia, la incorpora e salva 02_projet/renderparcel_pli_v1.blend. Il file salvato prevede Cycles CPU, 1.200 × 750 pixel, 64 campioni e l'immagine 1. L'opzione --render-preview richiede poi un PNG di 480 × 300 pixel e 16 campioni, senza denoising. Questi numeri sono impostazioni, non misure di prestazioni.

Il report reconstruction.json viene scritto dopo le operazioni riuscite e specifica se il render è stato realmente eseguito. Per costruire solo il .blend, rimuovi -- --render-preview. Lo script rifiuta di sovrascrivere output esistenti: un secondo tentativo si fa in una nuova estrazione. L'opzione --python-exit-code 1 permette di individuare un'eccezione dello script tramite il codice di uscita del processo.

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

Percorsi relativi: descrivere la posizione senza dimenticare la copia

In Blender, un percorso che inizia con // si riferisce alla posizione del .blend. Poiché il progetto Pli sarà in 02_projet, la sua texture può essere indicata con //../03_ressources/pli-chevron.png. La cartella delle risorse viaggia con lui. Il generatore parte comunque da un percorso assoluto risolto nella copia, incorpora l'immagine, poi scrive il percorso relativo prima del salvataggio.

Per un progetto esistente, salva prima il .blend nella cartella di trasferimento. In File → External Data, Make Paths Relative trasforma i riferimenti; questa operazione non copia le risorse. Report Missing Files aiuta a individuare i link interrotti. Find Missing Files cerca i file nella cartella selezionata e può riparare i riferimenti in percorsi assoluti: controllali di nuovo prima di trasferire.

Non confondere «trovato su questa macchina» e «presente nella cartella». Una texture ancora accessibile in Download può mascherare la dimenticanza. Dopo la copia, apri il progetto in un ambiente in cui quella vecchia posizione non può più soddisfare il link, mantenendo al contempo un backup indipendente.

Incorporare le risorse idonee, inventariare le altre

Pack Resources permette di includere le risorse idonee nel .blend; il salvataggio rende effettiva questa operazione nel file trasmesso. Non raccoglie tutte le dipendenze: i video ne sono un controesempio documentato. Le librerie collegate dispongono di un comando di incorporazione separato. Fai quindi l'elenco di ciò che è incorporato e di ciò che deve restare accanto al progetto.

Per Pli, conservare il PNG esterno ne facilita la modifica, mentre la sua incorporazione deve permettere di ritrovare il motivo nel file salvato. Dopo una modifica della texture, occorre aggiornare la risorsa effettivamente utilizzata e poi salvare la versione corretta. La semplice sostituzione di un PNG vicino non dimostra che il .blend usi i suoi nuovi pixel.

Riaprire in un secondo processo e compilare una vera ricezione

Dopo una ricostruzione riuscita, inspect_scene.py apre il .blend in un secondo processo Blender, con l'esecuzione dei suoi script interni disattivata. Controlla l'inventario, la camera, le impostazioni di output, la trasformazione AgX, la texture incorporata e il suo percorso relativo. Il suo rapporto descrive l'apertura e i dati; non attesta la qualità del render.

Apri il PNG ottenuto in un visualizzatore di immagini. Verifica che il flacone resti interamente nell'inquadratura, che l'etichetta mostri il motivo crema, viola e arancione, che il contatto con la base sia leggibile e che non compaia alcuna texture magenta. Questi criteri sono intenzioni di ricezione; non pubblichiamo un'immagine di riferimento Blender calcolata per questo pacchetto.

Copia 06_livraison/modele-reception.csv in 06_livraison/reception-executee.csv, poi compila questa nuova scheda. Mantieni intatto il modello: appartiene al manifest. Il validatore accetta la copia compilata senza modificare le impronte delle sorgenti, come ha verificato il nostro test di ricezione. Inventaria poi questa scheda e gli output approvati nel tuo archivio di consegna.

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

Una dipendenza mancante deve fermare il controllo

L'esercizio negativo del pacchetto rimuove pli-chevron.png da una copia di prova, senza toccare le sorgenti. Il validatore restituisce allora un codice 1 e identifica sia il file assente dall'inventario sia la dipendenza mancante dalla ricetta. Il generatore inizia con questo stesso controllo: deve rifiutarsi di proseguire con questa copia incompleta.

Un altro test altera il primo byte del PNG; il controllo rileva un'impronta diversa e una firma di immagine non valida. Un terzo sostituisce il suo percorso con un riferimento esterno alla cartella, anch'esso rifiutato. Questi test verificano difetti concreti di trasferimento. Non simulano né l'apertura Blender né la scomparsa di una cache in un'animazione.

Per rifare l'esercizio, lavora unicamente su un'estrazione aggiuntiva e conserva una copia intatta. La correzione consiste nel ritrovare la risorsa giusta e la sua posizione prevista. Una texture diversa con lo stesso nome non soddisfa il controllo di integrità.

Aggiungere un'animazione cambia il perimetro di controllo

La scena Piegatura possiede una sola immagine e non necessita di alcuna cache. Se vi aggiungi fumo, tessuto o una simulazione, documenta il tipo di cache, la sua versione di calcolo, la sua posizione e tutta l'intervallo utile. I meccanismi di precalcolo dipendono dal sistema fisico; non generalizzare il comportamento di una cache a tutte le altre.

Blocca il risultato prima di copiarlo. Per una sequenza, controlla l'inizio, la fine, i cambi di scenario o di simulazione, ma anche la presenza di ogni file intermedio. Tre immagini visivamente corrette non provano che i 96 file di un'animazione da 1 a 96 siano disponibili. Indica chiaramente se una cache è consegnata o deve essere ricalcolata, con quali parametri e quali input.

Applica la stessa logica alle sequenze di texture, volumi, suoni e media di montaggio. Non eliminare le sole sorgenti dopo la creazione del ZIP: conservale fino all'apertura della copia, al controllo degli output e al loro recupero.

Colore, memoria e durata: misurare il vero progetto

Il pattern Piegatura serve per il colore di base ed è dichiarato sRGB. Una mappa che descrive normali o uno spostamento non ha lo stesso ruolo; la sua interpretazione deve corrispondere ai suoi dati. Conserva anche la trasformazione di visualizzazione e l'esposizione quando confronti gli output. Una differenza di colore può derivare dalla catena di visualizzazione, senza alcun rapporto con la potenza di calcolo.

Il peso dello ZIP non indica il fabbisogno di memoria GPU. La geometria valutata, le texture effettivamente caricate e le fasi del rendering contano più del numero di file in un archivio. Una piccola anteprima CPU non predice né il picco di memoria né la durata del rendering finale su GPU. Misura un output completo rappresentativo alla definizione finale prima di scegliere una configurazione.

L'atelier 3D aiuta a inquadrare questo controllo. Confronta poi le configurazioni GPU in base alla compatibilità e al picco osservato, con un margine adatto al progetto. Scegli 3, 7 o 30 giorni nel configuratore per coprire apertura, prove, ritorni, calcoli e recupero; nessuna di queste finestre garantisce da sola un tempo di rendering. La guida all'esportazione accompagna il lavoro fino ai file finali.

Cosa è stato verificato e cosa resta da eseguire

I sette controlli riportati di seguito sono stati eseguiti su Windows con Python 3.14.6. Il pacchetto contiene quattordici file, incluso il manifest; tredici file sono coperti dalle sue impronte. La texture è stata ricostruita e confrontata byte per byte in questo ambiente. Questa uguaglianza del PNG non dimostra un'identità di rendering 3D tra versioni o hardware.

I controlli riguardano i file, le loro dipendenze e gli errori di trasferimento. La generazione del .blend, l'ispezione della scena e i rendering CPU o GPU non sono stati testati. Il README fornisce la procedura per verificarli in Blender 4.5.x LTS.