Kurz gesagt
- Das automatische Ausführen von Skripten in .blend-Dateien ist in Blender standardmäßig deaktiviert.
- Mit Trusted Source im Dateibrowser lässt sich die Auto-Run-Freigabe für einzelne Dateien festlegen.
- Die Kommandozeilenoptionen -y oder --enable-autoexec aktivieren die Ausführung; -Y oder --disable-autoexec deaktivieren sie.
- Collection.objects.link() fügt ein Objekt zu einer Collection hinzu; unlink() entfernt es daraus.
Was lernen Sie in diesem Leitfaden?
Python-Skripte in Blender-Dateien einzubetten, kann bei fortgeschrittenen Aufgaben wie Rigging und Automatisierung nützlich sein. Rigging bezeichnet das Einrichten von Bewegungs- und Steuerungssystemen für eine Figur oder ein Objekt. Python-Skripte sind jedoch nicht darauf beschränkt, was sie innerhalb einer Datei tun können. Deshalb kann das Ausführen eines Skripts unbekannter Herkunft ein Sicherheitsrisiko darstellen.
In diesem Tutorial erfahren Sie, wie Sie die Skriptwarnung beim Öffnen einer .blend-Datei beurteilen, Auto-Run auf Datei- und globaler Einstellungsebene verwalten und die Funktion der Kommandozeilenoptionen verstehen. Im letzten Abschnitt geht es um die Beziehungen zwischen Collections und Objekten in der Blender Python API. Diese Schritte beweisen nicht, dass ein Skript sicher ist; prüfen Sie Herkunft und Ausführungsfreigabe der Datei sorgfältig.
Voraussetzungen und Vorbereitung
Der Leitfaden basiert auf der Blender-Dokumentation zur Skriptsicherheit und der Blender Python API-Dokumentation. Eine Seite der API-Dokumentation trägt den Titel Blender 5.2 Python API Documentation. In den Quellen werden weder Hardwareanforderungen noch Voraussetzungen für ein Benutzerkonto genannt. Wenn Sie mit einer anderen Blender-Version arbeiten, vergleichen Sie die API-Nutzung mit der Dokumentation der entsprechenden Version.
Prüfen Sie vor dem Start, woher die Datei stammt und ob die darin enthaltenen Skripte ausgeführt werden müssen. Die Blender-Sicherheitsdokumentation empfiehlt, nur Skripte auszuführen, deren Herkunft bekannt und denen vertraut wird. Auto-Run deaktiviert zu lassen bedeutet nicht, dass die Datei keinen Code enthält oder dass sich kein Code durch eine Benutzeraktion ausführen lässt.
Schritt für Schritt: Ausführungsberechtigungen für Skripte verwalten
Prüfen Sie die Warnung beim Öffnen der Datei. Blender kann einen Dialog anzeigen, wenn eine Datei geöffnet wird, die ein nicht zur Ausführung freigegebenes Skript enthält. Die Warnung bietet die Optionen Allow Execution, um Skripte auszuführen, und Ignore, um sie zu ignorieren. Geben Sie die Ausführung nicht frei, wenn die Datei aus einer nicht vertrauenswürdigen Quelle stammt.
Verwenden Sie Trusted Source für einzelne Dateien. Mit der Option Trusted Source im Blender-Dateibrowser lässt sich die Auto-Run-Entscheidung für eine bestimmte Datei treffen. So können Sie jede Datei einzeln beurteilen. Für Dateien, die ohne den Dateibrowser geöffnet werden, sollten Sie auch die allgemeine Standardeinstellung prüfen.
Kontrollieren Sie die globale Auto-Run-Einstellung. Wenn die Option Auto Run Python Scripts in den Preferences aktiviert ist, wird Trusted Source im Dateibrowser standardmäßig eingeschaltet. Diese Einstellung kann Skripte auch dann ausführen lassen, wenn Dateien ohne den Dateibrowser geladen werden. Es ist möglich, bestimmte Verzeichnisse davon auszunehmen. Als Beispiel nennen die Dokumente eine Konfiguration, bei der Pfade außerhalb des Download-Verzeichnisses als vertrauenswürdig gelten. Betrachten Sie das nicht als allgemeingültige Regel für jede Arbeitsumgebung.
Berücksichtigen Sie, auf welchen Wegen Skripte ausgeführt werden können. Zu den in der Blender-Dokumentation genannten Auto-Run-Möglichkeiten zählen Text-Datenblöcke mit aktivierter Option Register und Animations-Driver, die Werte über Python-Ausdrücke steuern. Daneben gibt es Wege, die auch bei deaktiviertem Auto-Run eine Benutzeraktion erfordern: ein Skript manuell im Text Editor ausführen und mit Freestyle rendern, wenn Linienstile durch Skripte gesteuert werden. Die Auto-Run-Einstellung allein reicht daher nicht aus, um das gesamte Codeverhalten einer Datei zu erfassen.
Unterscheiden Sie die Objektbeziehungen in der Collection-API. In der Blender Python API bezeichnet Collection.objects die Objekte, die direkt in der jeweiligen Collection enthalten sind. Die Methode link fügt der Collection ein Objekt hinzu; unlink entfernt es aus der Collection. Collection.all_objects umfasst zusätzlich die Objekte in untergeordneten Collections und ist als schreibgeschützt definiert. Verwechseln Sie diese beiden Bereiche nicht, wenn Sie prüfen, was ein Skript verändert.
Legen Sie die Option für den Hintergrundbetrieb bewusst fest. Kommandozeilenoptionen können die Blender-Preferences überschreiben. Die offizielle Dokumentation enthält folgendes Beispiel, mit dem sich Driver und andere Skripte beim Rendern einer Animation im Hintergrund ausführen lassen:
blender --background --enable-autoexec my_movie.blend --render-animAnstelle von --enable-autoexec lässt sich -y verwenden. Um Auto-Run zu deaktivieren, stehen --disable-autoexec und -Y zur Verfügung. Diese Optionen machen es nicht überflüssig, die Vertrauenswürdigkeit der auszuführenden Datei zu prüfen. Kontrollieren Sie insbesondere bei automatisierten Abläufen, welche Datei mit welchen Berechtigungen geöffnet wird.
Häufige Fehler
Ein häufiger Fehler ist die Annahme, dass bei deaktiviertem Auto-Run überhaupt kein Code in einer Datei ausgeführt werden kann. Die Blender-Dokumentation beschreibt auch Wege, die eine Benutzeraktion erfordern, etwa das manuelle Ausführen eines Skripts im Text Editor oder das Rendern mit Freestyle. Ein weiterer Fehler ist, jedes Verzeichnis als vertrauenswürdig einzustufen und Auto Run Python Scripts ohne vorherige Prüfung zu aktivieren. Richten Sie die Vertrauensentscheidung nach der Herkunft der Datei aus.
Verwechseln Sie auch nicht die Optionen zum Aktivieren und Deaktivieren in der Kommandozeile: -y und --enable-autoexec erlauben Auto-Run; -Y und --disable-autoexec schalten es aus. Eine Datei zur Ausführung freizugeben, bedeutet nicht, dass der darin enthaltene Code vertrauenswürdig ist.
Unterscheiden Sie bei der Arbeit mit Collections außerdem direkt verknüpfte Objekte von der Liste, die auch Objekte in untergeordneten Collections umfasst. Collection.objects und Collection.all_objects bezeichnen nicht denselben Umfang. Wenn Sie die Auswirkungen eines Skripts prüfen, hilft ein Blick auf diesen Unterschied in der API-Dokumentation dabei, nachzuvollziehen, welche Objekte einbezogen werden.
Auswirkungen auf Architektur-, Innenraum- und Visualisierungs-Workflows
Die Blender-Dokumentation verknüpft das Thema Skriptsicherheit nicht mit einer bestimmten Architektur- oder Innenraumanwendung. Dennoch ist es für Visualisierungs-Workflows relevant, in denen Blender-Dateien zwischen Teams ausgetauscht werden: Die Herkunft einer Datei zu prüfen, Auto-Run bewusst freizugeben und den Umfang von Skripten zu verstehen, die die Szene verändern, sind sinnvolle Vorsichtsmaßnahmen im Umgang mit Dateien.
Die Collection-API bietet eine grundlegende Unterscheidung, wenn Sie Automatisierungscode prüfen, der Objekte nach Gruppen organisiert. Die Quellen machen jedoch keine Angaben zu bestimmten Projektvorlagen, zur Kompatibilität von Add-ons, zur Hardwareleistung oder zu Lizenzbedingungen. Prüfen Sie daher vor der Einbindung von Skripten in einen Workflow die API-Dokumentation der verwendeten Blender-Version und führen Sie Code nur aus vertrauenswürdigen Quellen aus.
Nächste Schritte
Prüfen Sie zunächst die Standardeinstellung von Auto Run Python Scripts und Ihre Trusted-Source-Entscheidung für einzelne Dateien im Hinblick auf Ihren aktuellen Arbeitsablauf. Untersuchen Sie anschließend, ob beim Öffnen der Datei eine Auto-Run-Warnung erscheint und auf welchem Weg Skripte ausgeführt werden können. Machen Sie nicht nur das Umgehen der Warnung, sondern auch das Nachvollziehen der Dateiquelle zum Bestandteil Ihres Vorgehens.
Wenn Sie ein Skript untersuchen, das Collections verwendet, unterscheiden Sie direkt verknüpfte Objekte von Objekten in untergeordneten Collections und überprüfen Sie die erforderliche Operation anhand der API-Referenz. Die Blender Python API-Dokumentation enthält die Abschnitte Quickstart, API Overview und Best Practice. Die Dokumentation kann zur Offline-Nutzung heruntergeladen werden. Legen Sie die Auto-Run-Option in der Kommandozeile erst fest, nachdem Sie die Vertrauenswürdigkeit der Datei beurteilt haben.
Quelle und Lizenz
Dieses Tutorial wurde anhand der offiziellen Blender-Dokumentation Scripting & Security, der API-Referenzen zu CollectionObjects und Collection sowie der Blender Python API-Dokumentation ins Türkische übersetzt und angepasst. Die Quellen stehen unter der Lizenz CC BY-SA 4.0.
Quellen
3 QuellenQuelltexte werden nicht neu veröffentlicht; kurze Zitate sind gekennzeichnet, der Rest ist eigene Zusammenfassung und Einordnung.
Für Architekturbüros und Visualisierungsteams in der Türkei liegt der praktischste Nutzen dieses Tutorials darin, Dateisicherheit gemeinsam mit Automatisierungsentscheidungen zu betrachten. Bei Blender-Dateien, die im Team geteilt werden, sind die Herkunft zu prüfen und die Auto-Run-Freigabe für jede Datei einzeln zu beurteilen sinnvolle Vorsichtsmaßnahmen im Arbeitsablauf.
Die Quellen nennen weder Preise noch Hardwareanforderungen oder Leistungssteigerungen. Daher lassen sich aus dem Tutorial keine Aussagen zu Kosten oder Geschwindigkeitsgewinnen ableiten. Studierende und Teams, die Skripte einsetzen, können den Leitfaden nutzen, um die Collection-API auf grundlegender Ebene zu verstehen. Vor dem Einsatz eines Skripts in einem Projekt sollten sie dessen Vertrauenswürdigkeit und Versionskompatibilität jedoch zusätzlich prüfen.
Häufige Fragen
Werden Python-Skripte in Blender standardmäßig automatisch ausgeführt?
Nein. Laut Blender-Dokumentation ist Auto-Run standardmäßig deaktiviert. Es gibt jedoch Wege, die eine Benutzeraktion erfordern, etwa die manuelle Ausführung oder das Rendern mit Freestyle.
Wie verwaltet man die Skriptberechtigungen in .blend-Dateien in Blender?
Über die Warnung beim Öffnen einer Datei lässt sich die Ausführung erlauben oder das Skript ignorieren. Auch Trusted Source im Dateibrowser und Auto Run Python Scripts in den Preferences steuern die automatische Ausführung.
Wie fügt man der Blender Python API ein Objekt zu einer Collection hinzu?
Collection.objects.link() fügt ein Objekt zu einer Collection hinzu; unlink() entfernt es daraus. Collection.all_objects umfasst auch Objekte in untergeordneten Collections und ist schreibgeschützt.
