Tutorial: ARewO - Der Animation Replicator with Offset

Python-Skripte müssen nicht kompliziert sein. Schon mit wenig Verständnis für Python lassen sich Skripte schreiben, die einem viel Arbeit abnehmen können.

Seid ihr jemals da gesessen und habt gedacht: ich mache das Gleiche jetzt zum x-ten Mal, kann das nicht mein Computer für mich machen? Gute Neuigkeiten: er kann! Mit ein wenig Verständnis für Python-Skripte kann man repetitive Aufgaben stark vereinfachen. Schaut euch an, wie:

Die fertige Blendfile inklusive des Skripts kann hier heruntergeladen werden!

Wer nur das Skript nutzen möchte kann zur Addon-Version mit GUI-Elementen greifen... (Rechtsklick -> Speichern unter)

Hier das fertige Skript inklusive Erläuterungen. Beim Kopieren in den Blender Skript-Editor ist zu beachten, dass die Einrückungen korrekt gesetzt sind.

import bpy

loops = 20
distanceX = 1.083
distanceY = 0
distanceZ = 0
offset = 10

for i in range(loops):
bpy.ops.object.duplicate_move(OBJECT_OT_duplicate = {"linked":False})
	obj = bpy.context.active_object
	obj.delta_location[0] += distanceX
	obj.delta_location[1] += distanceY
	obj.delta_location[2] += distanceZ
	animData = obj.animation_data
	action = animData.action
	fcurves = action.fcurves
	for curve in fcurves:
		keyframePoints = curve.keyframe_points
		for keyframe in keyframePoints:
			keyframe.co[0] += offset
			keyframe.handle_left[0] += offset
			keyframe.handle_right[0] += offset

#Erklärung der einzelnen Zeilen:
import bpy #Wir müssen die Blender Python-Bibliothek importieren, damit Python Blender-Objekte versteht. loops = 20 distanceX = 1.083 distanceY = 0 distanceZ = 0 offset = 10 #Ist eine Liste von Variablen, die man ändern kann, wenn man das kcript für andere Zwecke benutzen möchte. #Also habe ich diese Parameter an den Anfang geschrieben, und nicht als Zahl in die Zeile, #in der sie tatsächlich Verwendung finden. #So hat man sie als Liste am Anfang und muss nicht sein Skript durchsuchen, wenn man es anpassen will.
for i in range(loops): #Ruft eine for-Schleife auf. i ist ein austauschbarer Variablenname, der in diesem Fall eine Zahl ist, #was durch das Wort range definiert ist. Im ersten Durchgang der Schleife ist i = 0, im letzten loops 1, #danach hat die Schleife die darunter definierten Aktionen loops mal ausgeführt. bpy.ops.object.duplicate_move(OBJECT_OT_duplicate = {"linked":False}) #Diese Zeile macht dasselbe, wie mit der Maus über dem Viewport SHIFT+D zu drücken. obj = bpy.context.active_object #obj ist der Name einer Variablen, die nun das aktive Objekt ist. #Es ist wichtig, dass es sich dabei um die neueste Kopie handelt und nicht um das Objekt, #das aktiv war als wir "run script" gedrückt haben. obj.delta_location[0] += distanceX obj.delta_location[1] += distanceY obj.delta_location[2] += distanceZ #Diese Zeilen verändern die delta Position des Objekts. #Delta bezieht sich hier auf den Abstand zwischen der im Keyframe gespeicherten Position des Objekts und dem Wert, #den wir eingeben. Hat also unser Objekt location keyframes, wird es dennoch im Raum versetzt, #weil die Werte distance x, y und z dazugezählt werden. #Das Gleiche gilt für delta_rotation. Wichtig ist noch die [0] hinter den Werten. #[i] ist ein gängiges Zeichen dafür, dass es sich um ein Array handelt. #Die Position eines Objekts besteht natürlich aus 3 Werten, x, y und z. Analog werden [0], [1] und [2] verwendet. animData = obj.animation_data action = animData.action fcurves = action.fcurves #Diese 3 Variablen werden die folgenden Zeilen kürzer halten. for curve in fcurves: #Hier wird wieder eine for-Schleife aufgerufen. curve ist der Variablenname, #und die Schleife wird so oft ausgeführt wie es Parameter in fcurves gibt. #curves hält in diesem Fall keine Zahl, sondern tatsächlich alle Informationen der fcurves in der action des Objekts. for keyframe in keyframePoints: #Dementsprechend wird hier die Schleife so oft ausgeführt, wie es keyframes in den actions gibt. keyframe.co[0] += offset #co[0] ist das "Zentrum" des Keyframes. Zu seiner x Position wird also der Wert, den wir oben in offset gespeichert haben dazugezählt. #Bei einem Keyframe ist die X Koordinate dessen Position in der Zeit. keyframe.handle_left[0] += offset keyframe.handle_right[0] += offset #Macht dasselbe für die Bezier Handles der Keyframes. #Also in aller Kürze: Das Skript nimmt das aktive Objekt im View port, verdoppelt es, #versetzt es im Raum und versetzt dessen Animation in der Zeit.

#EDIT: wenn ihr möchtet, dass eure Keyframes zusätzlich einen zufälligen offset bekommen, fügt diese Zeilen in euer Script ein:

import random
#ganz oben
rand = (0.5 -
random.random()) * 10 #gibt eine Zufallszahl zwischen -5 und +5 aus, da random.random() eine Zahl zwischen 0 und 1 erstellt.
newOffset = offset + rand #diese beiden Zeilen vor animData = obj.animation_data
#und ersetzt die übrigen "offsets" durch "newOffset"