Eine Blender-Szene, die mit ihren Ressourcen reist.

Das Projekt Pli: ein Szenenrezept mit genauem Umfang

Pli ist ein fiktiver Flakon, der für diese Übung erdacht wurde: violetter Körper mit weichen Kanten, satinierter oranger Kragen, Etikett mit Chevron-Muster und Sockel aus Ton. Der Generator sieht ein Studiolicht und eine Komposition vor, die links Platz lässt. Er baut die Objekte und Materialien auf; das einzige externe Bild ist ein Original-PNG-Muster mit 512 × 512 Pixeln, begleitet von dem Programm, das es neu erzeugt. Kein Modell, kein HDRI, keine Schrift und keine Kundendatei sind nötig.

Das Ziel ist Blender 4.5.x LTS mit Cycles. Der Ordner betrifft ein Standbild, ohne Simulation und ohne Erweiterung. Der Generator lehnt einen anderen Blender-Zweig ab, damit diese Wahl ausdrücklich bleibt. Ein Python 3.10 oder neuer genügt für die Dateikontrolle; zum Aufbauen der Szene ist das in Blender integrierte Python erforderlich.

Pli liefert einen Generator, der mit Blender 4.5.x LTS ausgeführt wird. Die Dateien und die Fehlerfälle wurden unter Python 3.14.6 kontrolliert; das Erstellen der Szene, ihr Öffnen und ihr Rendern müssen in Blender noch getestet werden. Es wird weder eine .blend-Datei noch ein Rendering mitgeliefert.

Vor dem Kopieren entscheiden, was das Projekt wiedergeben soll

Beginnen Sie damit, das Ergebnis zu bestimmen: Standbild, Animation oder eine Reihe von Varianten. Notieren Sie die Software und ihre Version, die Engine, die aktive Kamera, die Szene, die Abmessungen und die Qualitätseinstellungen. Für eine Animation ergänzen Sie die Bildrate und die inklusiven Grenzen. Eine Szene, die sich öffnet, gibt nicht zwangsläufig dieselben Texturen, dieselben Caches oder den richtigen Bildausschnitt wieder.

Arbeiten Sie auf einer eingefrorenen Version und bewahren Sie die Originale auf. Trennen Sie die verwendeten Ressourcen von den verworfenen Versuchen; zwei fast gleichnamige Texturen können einen Unterschied im Material erklären. Prüfen Sie außerdem die Übertragungsrechte von Modellen, Bildern und Bibliotheken. Das Paket Pli bietet eine MIT-Lizenz für seine eigenen Skripte, Dokumente, Muster und die beschriebene Geometrie; Ihre Ergänzungen können anderen Bedingungen unterliegen.

In Pli spielt scene.json die Rolle des Ausgangsblatts: Zielversion, Inventar der zehn Objekte, grafische Abhängigkeit, Engine, Bild 1 und Ziele der Ausgaben. Es gibt außerdem an, was es in diesem Projekt nicht gibt: verknüpfte Bibliotheken, Schriften, Caches und Animation. Eine erklärte Abwesenheit verhindert, dass ein leerer Ordner für eine vergessene Ressource gehalten wird.

Eine Verzeichnisstruktur, in der jede Datei eine Rolle hat

Behalten Sie eine versionierte Wurzel, hier blender-v1, und entpacken Sie das Archiv, bevor Sie arbeiten. Die Trennung unten ermöglicht es, die Quelle eines Bildes, das bearbeitbare Projekt und das zu liefernde Ergebnis wiederzufinden. Sie erzwingt keine allgemeingültige Konvention: Wählen Sie vor allem Namen, die die Person, die den Ordner übernimmt, ohne Ihren Nachrichtenverlauf versteht.

Die verteilten Quellen stehen in manifest.sha256.json mit ihrer Größe und ihrem Fingerabdruck. Das Manifest schließt sich selbst aus, um einen Zirkelbezug zu vermeiden. Die künftigen .blend-, PNG- und Berichtsdateien sind Ausgaben: Sie müssen nach der Validierung in Ihr eigenes Lieferinventar aufgenommen werden.

Überprüfen Sie die extrahierte ZIP-Datei, bevor Sie Blender starten

Führen Sie vom Stammverzeichnis des entpackten Ordners aus den Validator mit einem unabhängigen Python aus. Er vergleicht dreizehn Dateien mit dem Manifest, prüft das Rezept, die Pfade und das PNG und analysiert anschließend die Syntax von vier Skripten. Das erwartete Ergebnis für das unversehrte Paket ist ok: true und ein Exit-Code 0. Diese Prüfung importiert kein bpy und erzeugt kein 3D-Bild.

Unsere Tests gehen von der ZIP-Datei aus, die an einen anderen Ort entpackt wurde. Der Prüfprozess erlaubt Lesezugriffe nur in dieser Kopie und im Verzeichnis des verwendeten Python; ein Zugriffsversuch auf das Originalrezept wird ausdrücklich verweigert. Der Erfolg hängt also nicht von einer Textur ab, die still und leise im Erstellungsordner wiedergefunden wird.

Ein Code 1 erfordert, die Fehlerliste zu lesen. Schreiben Sie die Fingerabdrücke nicht um, um eine Warnung verschwinden zu lassen. Nehmen Sie das unversehrte Archiv, oder erstellen Sie eine separate Arbeitsversion, wenn Sie die Szene ändern möchten. Ein identischer Fingerabdruck belegt die Integrität der Datei gegenüber dem Manifest, nicht ihre visuelle Qualität noch die Identität ihres Urhebers.

python validate_pack.py --root . --json

Die Flasche neu erstellen und ein kleines CPU-Rendering anfordern

Der folgende Befehl ist die Prozedur, die auf einem Rechner mit Blender 4.5.x LTS ausgeführt werden muss; sie wurde bei dieser Vorbereitung nicht ausgeführt. Starten Sie ihn in einem eigenen Prozess: Das Skript geht von einer leeren Szene aus. Unter Windows, falls blender nicht im PATH liegt, verwenden Sie den vollständigen Pfad zur ausführbaren Datei; in PowerShell stellen Sie diesem Pfad in Anführungszeichen ein & voran.

Der Generator prüft zuerst das Pack, erstellt die Objekte, lädt die Textur aus der Kopie, bindet sie ein und speichert 02_projekt/renderparcel_pli_v1.blend. Die gespeicherte Datei sieht Cycles CPU, 1.200 × 750 Pixel, 64 Samples und Bild 1 vor. Die Option --render-preview fordert anschließend ein PNG mit 480 × 300 Pixeln und 16 Samples an, ohne Entrauschen. Diese Zahlen sind Einstellungen, keine Leistungsmesswerte.

Der Bericht reconstruction.json wird nach den erfolgreichen Operationen geschrieben und gibt an, ob das Rendering tatsächlich ausgeführt wurde. Um nur die .blend zu erstellen, entfernen Sie -- --render-preview. Das Skript weigert sich, vorhandene Ausgaben zu überschreiben: Ein zweiter Versuch erfolgt in einer neuen Extraktion. Die Option --python-exit-code 1 ermöglicht es, eine Ausnahme des Skripts am Exit-Code des Prozesses zu erkennen.

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

Relative Pfade: die Position beschreiben, ohne die Kopie zu vergessen

In Blender bezieht sich ein Pfad, der mit // beginnt, auf den Speicherort der .blend-Datei. Da das Projekt Pli in 02_projet liegt, kann seine Textur durch //../03_ressources/pli-chevron.png angegeben werden. Der Ressourcenordner reist mit ihm. Der Generator beginnt dennoch mit einem absoluten Pfad, der in der Kopie aufgelöst wird, bindet das Bild ein und schreibt den relativen Pfad vor dem Speichern.

Speichern Sie bei einem bestehenden Projekt zunächst die .blend-Datei im Übertragungsordner. Unter File → External Data wandelt Make Paths Relative die Verweise um; dieser Vorgang kopiert die Ressourcen nicht. Report Missing Files hilft, defekte Links zu erkennen. Find Missing Files sucht die Dateien im ausgewählten Ordner und kann die Verweise in absolute Pfade umwandeln: Prüfen Sie diese erneut, bevor Sie übertragen.

Verwechseln Sie nicht „auf diesem Rechner gefunden“ mit „im Ordner vorhanden“. Eine Textur, die noch in Downloads zugänglich ist, kann ein Versäumnis verschleiern. Öffnen Sie das Projekt nach dem Kopieren in einer Umgebung, in der dieser alte Speicherort den Link nicht mehr erfüllen kann, und bewahren Sie zugleich eine unabhängige Sicherung auf.

Einbettung geeigneter Ressourcen, Inventarisierung der übrigen

Pack Resources ermöglicht es, die geeigneten Ressourcen in die .blend-Datei aufzunehmen; das Speichern macht diesen Vorgang in der übertragenen Datei wirksam. Dabei werden nicht alle Abhängigkeiten zusammengefasst: Videos sind ein dokumentiertes Gegenbeispiel. Verknüpfte Bibliotheken verfügen über einen eigenen Befehl zum Einbetten. Listen Sie daher auf, was eingebettet wird und was neben dem Projekt liegen bleiben muss.

Bei Pli erleichtert das Beibehalten der externen PNG-Datei ihre Bearbeitung, während ihre Einbettung es ermöglichen soll, das Muster in der gespeicherten Datei wiederzufinden. Nach einer Änderung der Textur müssen Sie die tatsächlich verwendete Ressource aktualisieren und dann die richtige Version speichern. Das bloße Ersetzen einer benachbarten PNG-Datei belegt nicht, dass die .blend-Datei ihre neuen Pixel verwendet.

In einem zweiten Prozess erneut öffnen und eine echte Abnahme ausfüllen

Nach einem erfolgreichen Neuaufbau öffnet inspect_scene.py die .blend-Datei in einem zweiten Blender-Prozess, wobei die Ausführung ihrer internen Skripte deaktiviert ist. Es kontrolliert das Inventar, die Kamera, die Ausgabeeinstellungen, die AgX-Transformation, die eingebettete Textur und ihren relativen Pfad. Sein Bericht beschreibt das Öffnen und die Daten; er belegt nicht die Qualität des Renderings.

Öffnen Sie die erzeugte PNG-Datei in einem Bildbetrachter. Prüfen Sie, dass die Flasche vollständig im Bild bleibt, dass das Etikett das cremefarbene, violette und orange Muster zeigt, dass der Kontakt mit dem Sockel erkennbar ist und dass keine magentafarbene Textur erscheint. Diese Kriterien sind Abnahmeabsichten; wir veröffentlichen kein berechnetes Blender-Referenzbild für dieses Pack.

Kopieren Sie 06_livraison/modele-reception.csv nach 06_livraison/reception-executee.csv und füllen Sie dann dieses neue Blatt aus. Lassen Sie die Vorlage unverändert: Sie gehört zum Manifest. Der Validator akzeptiert die ausgefüllte Kopie, ohne die Prüfsummen der Quellen zu verändern, was unser Abnahmetest bestätigt hat. Erfassen Sie anschließend dieses Blatt und die freigegebenen Ausgaben in Ihrem Lieferarchiv.

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

Eine fehlende Abhängigkeit muss die Kontrolle abbrechen

Die negative Übung des Packs entfernt pli-chevron.png aus einer Testkopie, ohne die Quellen anzutasten. Der Validator gibt dann den Code 1 zurück und benennt sowohl die im Inventar fehlende Datei als auch die fehlende Abhängigkeit des Rezepts. Der Generator beginnt mit derselben Kontrolle: Er muss es ablehnen, mit dieser unvollständigen Kopie fortzufahren.

Ein weiterer Versuch verändert das erste Byte der PNG-Datei; die Kontrolle erkennt eine abweichende Prüfsumme und eine ungültige Bildsignatur. Ein dritter ersetzt ihren Pfad durch eine Referenz außerhalb des Ordners, die ebenfalls abgelehnt wird. Diese Versuche prüfen konkrete Übertragungsfehler. Sie simulieren weder das Öffnen in Blender noch das Verschwinden eines Caches in einer Animation.

Um die Übung zu wiederholen, arbeiten Sie ausschließlich mit einer zusätzlichen Extraktion und bewahren Sie eine unversehrte Kopie auf. Die Korrektur besteht darin, die richtige Ressource und ihren erwarteten Speicherort wiederzufinden. Eine andere Textur mit demselben Namen erfüllt die Integritätsprüfung nicht.

Eine Animation hinzuzufügen verändert den Prüfumfang

Die Szene Pli enthält nur ein Bild und benötigt keinen Cache. Wenn Sie ihr Rauch, Stoff oder eine Simulation hinzufügen, dokumentieren Sie den Cache-Typ, seine Berechnungsversion, seinen Speicherort und den gesamten nutzbaren Bereich. Die Mechanismen der Vorberechnung hängen vom physikalischen System ab; verallgemeinern Sie das Verhalten eines Caches nicht auf alle anderen.

Fixieren Sie das Ergebnis, bevor Sie es kopieren. Kontrollieren Sie bei einer Sequenz den Anfang, das Ende, die Wechsel von Kulisse oder Simulation, aber auch das Vorhandensein jeder einzelnen Zwischendatei. Drei visuell korrekte Bilder beweisen nicht, dass die 96 Dateien einer Animation von 1 bis 96 verfügbar sind. Geben Sie klar an, ob ein Cache mitgeliefert wird oder neu berechnet werden muss, mit welchen Parametern und welchen Eingaben.

Wenden Sie dieselbe Logik auf Sequenzen von Texturen, Volumes, Tönen und Schnittmedien an. Löschen Sie nicht die einzigen Quellen nach der Erstellung des ZIP: Bewahren Sie sie bis zum Öffnen der Kopie, zur Kontrolle der Ausgaben und zu deren Wiederherstellung auf.

Farbe, Speicher und Laufzeit: das echte Projekt messen

Das Pli-Muster dient der Grundfarbe und ist als sRGB deklariert. Eine Map, die Normalen oder eine Verschiebung beschreibt, hat nicht dieselbe Rolle; ihre Interpretation muss zu ihren Daten passen. Behalten Sie beim Vergleich der Ausgaben auch die Anzeigetransformation und die Belichtung bei. Ein Farbunterschied kann aus der Anzeigekette stammen und hat nichts mit der Rechenleistung zu tun.

Das Gewicht der ZIP-Datei sagt nichts über den GPU-Speicherbedarf aus. Die ausgewertete Geometrie, die tatsächlich geladenen Texturen und die Rendering-Schritte zählen mehr als die Anzahl der Dateien in einem Archiv. Eine kleine CPU-Vorschau sagt weder den Speicherspitzenwert noch die Dauer des finalen GPU-Renderings voraus. Messen Sie eine repräsentative vollständige Ausgabe in der finalen Auflösung, bevor Sie eine Konfiguration wählen.

Der 3D-Workshop hilft, diese Kontrolle einzugrenzen. Vergleichen Sie anschließend die GPU-Konfigurationen nach Kompatibilität und beobachtetem Spitzenwert, mit einer dem Projekt angemessenen Marge. Wählen Sie im Konfigurator 3, 7 oder 30 Tage, um Eröffnung, Tests, Iterationen, Berechnungen und Erholung abzudecken; keines dieser Fenster garantiert für sich allein eine Rendering-Frist. Der Export-Leitfaden führt die Arbeit bis zu den lieferbaren Dateien fort.

Was geprüft wurde und was noch ausgeführt werden muss

Die sieben unten aufgeführten Prüfungen wurden unter Windows mit Python 3.14.6 ausgeführt. Das Paket enthält vierzehn Dateien, darunter das Manifest; dreizehn Dateien sind durch dessen Prüfsummen abgedeckt. Die Textur wurde rekonstruiert und in dieser Umgebung Byte für Byte verglichen. Diese Gleichheit der PNG-Datei belegt keine identische 3D-Darstellung zwischen Versionen oder Hardware.

Die Prüfungen betreffen die Dateien, ihre Abhängigkeiten und Übertragungsfehler. Die Erzeugung der .blend-Datei, die Sichtprüfung der Szene sowie CPU- oder GPU-Renderings wurden nicht getestet. Das README beschreibt das Verfahren, um sie in Blender 4.5.x LTS zu überprüfen.