Blender 애니메이션은(는) 무엇을 하나요?
개요
Python을 사용하여 Blender에서 애니메이션을 생성하고 제어합니다. 오브젝트 및 본 변환에 키프레임을 설정하고, IK/FK 리그가 포함된 아마추어를 구축하며, 페이셜 모션을 위한 셰이프 키를 애니메이션화하고, 타이밍 제어를 위해 F-커브를 편집하며, NLA 에디터에서 액션을 레이어링하고, 표현식 기반 자동화를 위한 드라이버를 연결합니다 — 모두 터미널에서 스크립팅 가능합니다.
지침
1. 오브젝트 속성에 키프레임 설정
import bpy
obj = bpy.data.objects["Cube"]
# 여러 프레임에서 위치 키프레임 설정
for loc, frame in [((0,0,0), 1), ((5,0,3), 30), ((5,4,0), 60)]:
obj.location = loc
obj.keyframe_insert(data_path="location", frame=frame)
# rotation_euler, scale, 단일 축 (index=2는 Z), 사용자 정의 속성에도 작동
obj.rotation_euler = (0, 0, 3.14159)
obj.keyframe_insert(data_path="rotation_euler", frame=60)
obj.scale = (2, 2, 2)
obj.keyframe_insert(data_path="scale", frame=60)
obj["intensity"] = 1.0 # 사용자 정의 속성
obj.keyframe_insert(data_path='["intensity"]', frame=30)
bpy.context.scene.frame_start, bpy.context.scene.frame_end = 1, 60
2. F-커브 보간 및 수정자 제어
import bpy
action = bpy.data.objects["Cube"].animation_data.action
for fcurve in action.fcurves:
for kp in fcurve.keyframe_points:
kp.interpolation = 'BEZIER' # CONSTANT, LINEAR, BEZIER, SINE, EXPO, BOUNCE, ELASTIC
kp.easing = 'EASE_IN_OUT' # AUTO, EASE_IN, EASE_OUT, EASE_IN_OUT
# 애니메이션을 반복하는 Cycles 수정자
mod = fcurve.modifiers.new(type='CYCLES')
mod.mode_before = 'REPEAT' # NONE, REPEAT, REPEAT_OFFSET, MIRROR
mod.mode_after = 'REPEAT'
# 특정 채널에 노이즈 추가
z_curve = action.fcurves.find("location", index=2) # Z 위치
if z_curve:
noise = z_curve.modifiers.new(type='NOISE')
noise.strength, noise.scale = 0.3, 5.0
3. 아마추어와 본 생성
import bpy
arm_data = bpy.data.armatures.new("Rig")
arm_obj = bpy.data.objects.new("Rig", arm_data)
bpy.context.collection.objects.link(arm_obj)
bpy.context.view_layer.objects.active = arm_obj
bpy.ops.object.mode_set(mode='EDIT')
# (이름, 머리, 꼬리, 부모 이름, 연결 여부)
bone_defs = [
("Spine", (0,0,1.0), (0,0,1.4), None, False),
("Chest", (0,0,1.4), (0,0,1.8), "Spine", False),
("UpperArm.L", (0.2,0,1.7), (0.5,0,1.4), "Chest", False),
("Forearm.L", (0.5,0,1.4), (0.8,0,1.1), "UpperArm.L", True),
("Thigh.L", (0.1,0,1.0), (0.1,0,0.5), "Spine", False),
("Shin.L", (0.1,0,0.5), (0.1,0,0.05),"Thigh.L", True),
]
for name, head, tail, parent, connected in bone_defs:
b = arm_data.edit_bones.new(name)
b.head, b.tail = head, tail
if parent:
b.parent = arm_data.edit_bones[parent]
b.use_connect = connected
bpy.ops.object.mode_set(mode='OBJECT')
4. 본에 제약 조건 설정
import bpy
arm_obj = bpy.data.objects["Rig"]
bpy.context.view_layer.objects.active = arm_obj
bpy.ops.object.mode_set(mode='POSE')
# IK — 대상으로 Empty 사용, chain_count는 영향을 받는 본의 수를 제한
ik = arm_obj.pose.bones["Forearm.L"].constraints.new('IK')
ik.target = bpy.data.objects["IK_Target"]
ik.pole_target = bpy.data.objects["IK_Pole"]
ik.chain_count = 2
# Copy Rotation — 다른 오브젝트의 회전을 미러링
cr = arm_obj.pose.bones["Chest"].constraints.new('COPY_ROTATION')
cr.target = bpy.data.objects["ChestCtrl"]
# 기타 유형: LIMIT_ROTATION, DAMPED_TRACK, STRETCH_TO, COPY_LOCATION, TRACK_TO
bpy.ops.object.mode_set(mode='OBJECT')
5. 본 포즈 키프레임 설정
import bpy, math
arm_obj = bpy.data.objects["Rig"]
bpy.context.view_layer.objects.active = arm_obj
bpy.ops.object.mode_set(mode='POSE')
if not arm_obj.animation_data:
arm_obj.animation_data_create()
action = bpy.data.actions.new("WalkCycle")
arm_obj.animation_data.action = action
# 허벅지 스윙 키프레임: 뒤 → 중립 → 앞
thigh = arm_obj.pose.bones["Thigh.L"]
for angle, frame in [(-30, 1), (0, 13), (30, 25)]:
thigh.rotation_euler = (math.radians(angle), 0, 0)
thigh.keyframe_insert(data_path="rotation_euler", frame=frame)
bpy.ops.object.mode_set(mode='OBJECT')
6. 셰이프 키 생성 및 애니메이션
import bpy
obj = bpy.data.objects["Head"]
mesh = obj.data
if not mesh.shape_keys: # Basis 키가 먼저 필요
obj.shape_key_add(name="Basis", from_mix=False)
smile = obj.shape_key_add(name="Smile", from_mix=False)
for i, vert in enumerate(smile.data):
if i in [42, 43, 56, 57]: # 입꼬리 정점
vert.co.z += 0.02
# 셰이프 키 값 애니메이션 (0.0 → 1.0 → 0.0)
sk = mesh.shape_keys.key_blocks["Smile"]
for val, frame in [(0.0, 1), (1.0, 15), (0.0, 30)]:
sk.value = val
sk.keyframe_insert(data_path="value", frame=frame)
7. NLA 에디터로 액션 레이어링
import bpy
arm_obj = bpy.data.objects["Rig"]
if not arm_obj.animation_data:
arm_obj.animation_data_create()
# 별도 트랙에 NLA 스트립으로 액션 푸시
track1 = arm_obj.animation_data.nla_tracks.new()
track1.name = "Walk"
strip1 = track1.strips.new("Walk", start=1, action=bpy.data.actions["WalkCycle"])
strip1.repeat = 4 # 4번 반복
strip1.blend_type = 'REPLACE' # REPLACE, COMBINE, ADD, SUBTRACT, MULTIPLY
track2 = arm_obj.animation_data.nla_tracks.new()
track2.name = "Wave"
strip2 = track2.strips.new("Wave", start=25, action=bpy.data.actions["WaveHand"])
strip2.blend_type = 'COMBINE' # 걷기 위에 블렌드
strip2.influence = 0.8 # 부분 블렌드
arm_obj.animation_data.action = None # NLA가 작동하도록 활성 액션 해제
8. 표현식 기반 애니메이션을 위한 드라이버 추가
import bpy
driver = bpy.data.objects["Cube"].driver_add("location", 2).driver # Z 위치 드라이브
driver.type = 'SCRIPTED'
driver.expression = "sin(frame * 0.1) * 2"
# 다른 오브젝트의 변환을 읽는 변수 추가
var = driver.variables.new()
var.name = "ctrl"
var.type = 'TRANSFORMS'
var.targets[0].id = bpy.data.objects["Controller"]
var.targets[0].transform_type = 'LOC_X'
var.targets[0].transform_space = 'WORLD_SPACE'
driver.expression = "ctrl * 3" # 셰이프 키에서도 작동: sk.driver_add("value")
예제
예제 1: 스쿼시와 스트레치가 있는 바운싱 볼
사용자 요청: "스쿼시와 스트레치로 바운싱 볼 애니메이션 만들기"
import bpy
bpy.ops.object.select_all(action='SELECT')
bpy.ops.object.delete()
bpy.ops.mesh.primitive_uv_sphere_add(radius=0.5, location=(0, 0, 3))
ball = bpy.context.active_object
ball.name = "BouncingBall"
keyframes = [ # (프레임, z_위치, scale_x, scale_y, scale_z)
(1, 3.0, 1.0, 1.0, 1.0), (12, 0.5, 1.0, 1.0, 1.0), # 낙하
(15, 0.3, 1.3, 1.3, 0.6), (18, 0.5, 0.85, 0.85, 1.2), # 스쿼시 + 스트레치
(30, 2.2, 1.0, 1.0, 1.0), (42, 0.5, 1.0, 1.0, 1.0), # 정점 + 두 번째 낙하
(45, 0.3, 1.2, 1.2, 0.7), (55, 1.5, 1.0, 1.0, 1.0), # 더 작은 바운스
(62, 0.5, 1.0, 1.0, 1.0), # 안정화
]
for frame, z, sx, sy, sz in keyframes:
ball.location = (0, 0, z)
ball.keyframe_insert(data_path="location", frame=frame)
ball.scale = (sx, sy, sz)
ball.keyframe_insert(data_path="scale", frame=frame)
for fc in ball.animation_data.action.fcurves:
for kp in fc.keyframe_points:
kp.interpolation = 'BEZIER'
bpy.context.scene.frame_end = 62
bpy.ops.wm.save_as_mainfile(filepath="/tmp/bouncing_ball.blend")
예제 2: 오브젝트를 잡기 위해 IK를 사용하는 팔 리그
사용자 요청: "IK가 있는 간단한 팔 리그를 만들고 큐브를 잡는 애니메이션 만들기"
import bpy
bpy.ops.object.select_all(action='SELECT')
bpy.ops.object.delete()
arm_data = bpy.data.armatures.new("ArmRig")
arm_obj = bpy.data.objects.new("ArmRig", arm_data)
bpy.context.collection.objects.link(arm_obj)
bpy.context.view_layer.objects.active = arm_obj
bpy.ops.object.mode_set(mode='EDIT')
prev = None
for name, head, tail in [("UpperArm",(0,0,1.5),(0.6,0,1.5)),
("Forearm",(0.6,0,1.5),(1.2,0,1.5)),
("Hand",(1.2,0,1.5),(1.4,0,1.5))]:
b = arm_data.edit_bones.new(name)
b.head, b.tail = head, tail
if prev: b.parent, b.use_connect = prev, True
prev = b
bpy.ops.object.mode_set(mode='OBJECT')
# IK 대상 + 제약 조건
bpy.ops.object.empty_add(type='PLAIN_AXES', location=(1.2, 0, 1.5))
ik_target = bpy.context.active_object
ik_target.name = "IK_Hand"
bpy.context.view_layer.objects.active = arm_obj
bpy.ops.object.mode_set(mode='POSE')
ik = arm_obj.pose.bones["Hand"].constraints.new('IK')
ik.target, ik.chain_count = ik_target, 3
bpy.ops.object.mode_set(mode='OBJECT')
# IK 대상이 큐브를 향해 뻗도록 애니메이션
bpy.ops.mesh.primitive_cube_add(size=0.3, location=(1.5, 0.5, 1.0))
for loc, frame in [((1.2,0,1.5),1), ((1.5,0.5,1.0),30), ((1.5,0.5,1.3),50)]:
ik_target.location = loc
ik_target.keyframe_insert(data_path="location", frame=frame)
for fc in ik_target.animation_data.action.fcurves:
for kp in fc.keyframe_points:
kp.interpolation, kp.easing = 'BEZIER', 'EASE_IN_OUT'
bpy.context.scene.frame_end = 50
bpy.ops.wm.save_as_mainfile(filepath="/tmp/arm_grab.blend")
지침
data_path는 RNA 경로와 정확히 일치해야 합니다:"location","rotation_euler","scale",'["custom_prop"]'.- 아마추어 워크플로우: 본은 편집 모드(
edit_bones), 제약 조건과 키프레임은 포즈 모드(pose.bones). - IK의 경우 Empty 오브젝트를 대상으로 사용합니다.
chain_count=0은 전체 체인을 루트까지 해결합니다. - 셰이프 키는 먼저 "Basis" 키가 필요합니다.
key_blocks["Name"].value(0.0 ~ 1.0)를 통해 애니메이션합니다. - 보간:
CONSTANT는 홀드/스텝,LINEAR는 기계적 동작,BEZIER와 이징은 유기적 동작에 사용합니다. - NLA 스트립이 구동되도록
animation_data.action = None으로 설정하세요 — 활성 액션이 NLA를 덮어씁니다. - 걷기 사이클의 경우, 한 걸음에 키프레임을 설정하고 Cycles F-커브 수정자 또는 NLA 반복을 사용하여 반복합니다.
- 내보내기 전에
bpy.ops.nla.bake()로 제약 조건/드라이버를 베이크하세요 — 다른 소프트웨어는 이를 읽을 수 없습니다.