Python Scripting (Blender) – Automatisierung und Add-on-Entwicklung

Python Scripting in Blender bezeichnet die Verwendung der integrierten Python-API (bpy) zur Automatisierung von Workflows, Entwicklung von Add-ons, prozeduralen Erzeugung von Objekten und Szenen sowie zur Erweiterung von Blenders Funktionsumfang durch benutzerdefinierte Operatoren und Panels.

Rubrik: Software & Tools · Unterrubrik: Blender · Niveau: Profi Synonyme / Auch bekannt als: bpy, Blender Python API, Scripting, Add-on Development

Was ist Python Scripting in Blender?

Blender ist vollständig in Python skriptierbar. Jede Funktion, die ein Nutzer über die Benutzeroberfläche ausführen kann, ist auch über die Python-API bpy erreichbar und automatisierbar. Der Scripting-Workspace (im Header-Tab „Scripting" auswählen) bietet einen integrierten Python-Texteditor, die Python-Konsole für interaktive Befehle und das Info-Fenster, das alle Benutzeraktionen als Python-Befehle protokolliert – ein direktes Lernwerkzeug für die API. Python-Scripting ist unverzichtbar für Studio-Pipelines, Batch-Rendering, Asset-Management, prozedurale Generierung und die Entwicklung eigener Tools.

Erklärung

Die bpy-Bibliothek – Kernstruktur:

• bpy.context: Zugriff auf den aktuellen Kontext (aktives Objekt, Szene, Frame)
• bpy.data: Zugriff auf alle Daten-Blöcke (Objects, Meshes, Materials, Actions etc.)
• bpy.ops: Operatoren – alle Blender-Befehle, die auch über die UI aufgerufen werden können
• bpy.types: Basis-Klassen für eigene Operatoren, Panels und Properties
• bpy.props: Property-Definitionen für Add-on-Parameter (FloatProperty, IntProperty, EnumProperty)
• mathutils: Mathematische Hilfsfunktionen (Vector, Matrix, Quaternion, Euler)

Erstes Skript – Objekte erstellen:

```python import bpy

bpy.ops.object.select_all(action='SELECT') bpy.ops.object.delete()

bpy.ops.mesh.primitivecubeadd(location=(0, 0, 0))

cube = bpy.context.active_object cube.name = "MeinWürfel" cube.scale = (2, 1, 0.5) ```

Info-Fenster als Lernwerkzeug:

Das Info-Fenster zeichnet alle Benutzeraktionen als Python-Befehle auf. Wenn man z.B. einen Subdivision Surface Modifier hinzufügt, erscheint im Info-Fenster der entsprechende bpy-Befehl. Diesen Befehl kann man direkt in ein Skript übernehmen – so lernt man die API durch normales Arbeiten.

Operatoren (Eigene Buttons/Befehle) erstellen:

```python import bpy

class OBJECTOThelloworld(bpy.types.Operator): blidname = "object.helloworld" bllabel = "Hello World" bl_description = "Gibt Hello World in der Konsole aus"

def execute(self, context): print("Hello World aus Blender!") return {'FINISHED'}

def register(): bpy.utils.registerclass(OBJECTOThelloworld)

def unregister(): bpy.utils.unregisterclass(OBJECTOThelloworld)

if name == "main": register() ```

Panels (Eigene UI-Bereiche) erstellen:

Eigene Panels können in den Properties-Panel, den N-Panel (View3D) oder in den Header integriert werden. Dies ist die Grundlage für vollständige Add-ons mit eigener Benutzeroberfläche.

Handler – Automatisierungen auf Events:

Blenders Handler-System erlaubt die Ausführung von Python-Code auf Ereignisse:

• bpy.app.handlers.frame_change_post: Ausführung bei jedem Frame-Wechsel
• bpy.app.handlers.render_complete: Ausführung nach dem Render
• bpy.app.handlers.load_post: Ausführung beim Öffnen einer .blend-Datei

Batch-Rendering – praktisches Beispiel:

```python import bpy

output_path = "/Users/admin/renders/"

for frame in range(1, 251): bpy.context.scene.frameset(frame) bpy.context.scene.render.filepath = f"{outputpath}frame{frame:04d}.png" bpy.ops.render.render(writestill=True) ```

Geometry prozedural erstellen (bmesh):

```python import bpy, bmesh

mesh = bpy.data.meshes.new("ProzeduralMesh") bm = bmesh.new()

v1 = bm.verts.new((0, 0, 0)) v2 = bm.verts.new((1, 0, 0)) v3 = bm.verts.new((0.5, 1, 0))

bm.faces.new([v1, v2, v3])

bm.to_mesh(mesh) bm.free()

obj = bpy.data.objects.new("ProzeduralObjekt", mesh) bpy.context.scene.collection.objects.link(obj) ```

Beispiele

1. Asset-Batch-Import: Skript importiert alle FBX-Dateien in einem Ordner automatisch, benennt Objekte korrekt und platziert sie in Collections.
2. Prozedurale Stadt: Python-Skript generiert Hunderte von Gebäuden mit variablen Höhen, Texturen und Positionen nach einem algorithmischen Stadtplan.
3. Render-Farm-Vorbereitung: Batch-Skript teilt eine Animation in Segmente auf, setzt Output-Pfade und startet Renders automatisch.
4. Custom Add-on: Ein Add-on fügt einen neuen Button in den N-Panel ein, der mit einem Klick ein häufig verwendetes Material-Setup auf ausgewählte Objekte anwendet.
5. Animationsdaten-Export: Skript exportiert alle Keyframe-Daten einer Armature als CSV für die Analyse in einem externen Tool.

In der Praxis

Python-Konsole nutzen: Die interaktive Python-Konsole (im Scripting-Workspace) erlaubt direktes Testen von bpy-Befehlen mit Tab-Completion. Ideal zum Erforschen der API ohne vollständige Skripte schreiben zu müssen.

Add-on-Struktur für Blender 4.x:

`` mein_addon/ __init__.py # bl_info Dict, register/unregister operators.py # Operator-Klassen panels.py # Panel-Klassen properties.py # Property-Definitionen ``

Testing und Debugging: Fehlermeldungen erscheinen in der System Console (Window > Toggle System Console auf Windows; Terminal auf macOS/Linux). Print-Statements sind das einfachste Debugging-Werkzeug.

Shortcuts im Scripting-Workspace:

• Alt+P: Skript ausführen
• Ctrl+Enter: Zeile in der Python-Konsole ausführen
• Tab: Auto-Completion in der Python-Konsole

Community-Ressourcen: Die Blender API-Referenz (docs.blender.org/api/current) ist vollständig und wird mit jeder Blender-Version aktualisiert. Blender Stack Exchange ist die beste Q&A-Plattform für Scripting-Probleme.

Vergleich & Abgrenzung

Cinema 4D nutzt Python als Scripting-Sprache mit der c4d-Bibliothek – ähnliches Konzept, aber andere API-Struktur. Ältere C4D-Versionen nutzten CoffeeScript. Maya verwendet MEL (Maya Embedded Language) und Python mit der maya.cmds-API – industrieweit etabliert, aber komplexer in der Einrichtung. Houdini nutzt VEX und Python (hou-Bibliothek) für sein prozedurales System – mächtiger, aber steilere Lernkurve. Blenders bpy ist für Python-Anfänger zugänglich und durch das Info-Fenster didaktisch gut erschlossen.

Häufige Fragen (FAQ)

Muss ich Python-Programmierer sein, um Blender-Skripte zu schreiben? Grundlegende Python-Kenntnisse (Variablen, Schleifen, Funktionen, Klassen) sind notwendig. Viele einfache Automatisierungs-Skripte lassen sich aber auch durch Kopieren und Anpassen von Beispielen aus dem Info-Fenster erstellen. Für vollständige Add-on-Entwicklung sind solidere Programmierkenntnisse erforderlich.

Wie installiere ich ein selbst geschriebenes Add-on? In Edit > Preferences > Add-ons auf „Install" klicken und die .py-Datei (oder einen .zip-Ordner) auswählen. Das Add-on erscheint in der Liste und kann aktiviert werden. Für die Entwicklung empfiehlt es sich, das Add-on direkt im Blender-Add-on-Ordner zu platzieren und regelmäßig neu zu laden (F8 oder Script > Reload Scripts).

Verwandte Einträge

• Geometry Nodes Grundlagen
• Armature & Rigging
• NLA Editor

Weiterführend

• Blender API Reference – docs.blender.org/api/current
• Blender Stack Exchange – blender.stackexchange.com
• Blender Guru: „Getting Started with Blender Python" – blenderguru.com
• Sybren Stüvel: „Blender Add-on Tutorial" (offiziell) – docs.blender.org