实验笔记:Blender Python脚本实战一则
岸田夏海MK2
编辑于 2025年04月19日 23:19
收录于文集
共25篇

之前说过,会以一个专栏为例进行Blender Python的脚本实战。

本次目标是针对烧笋的表情提取:

内容不多,快速记录一下思路,供以后改模处理形态键时参考。

0. 致谢

脚本在写完后经过了原方案的提出者,响子P@索马宝可以及数位同好的验证,不过私下分发那版写的相当随意,也借着这次机会重构一遍;

而为了感谢在之前实战中提供贴图协助的芳乃P@SuperSodaSea,

继数年前手搓表情的烧笋改模专栏后,再次有请芳乃担任本次的范例小偶像。

[縁結日和]依田芳乃

法螺贝就位,

ぶおおおおおおおおおおー

1. 思路

梳理下原先的流程:

-用AS把animator带着animation导出为“带有骨骼动画的fbx”

-将骨骼动画的顶点变形应用至object

-将变形后的object与未变形时的差分固定为形态键

-清除object变形,重复以上两步

换句话说,脚本需要:

读取armature中的骨骼动画信息→固定为形态键→清除object变形→循环

开工,献丑了。

2. 实战

和之前一样,blender读入带骨骼动画的fbx,确认有带出animationclip。

从列出骨骼动画开始:

代码块
text/x-python
自动换行
复制代码
>>> list(bpy.data.actions)
[bpy.data.actions['an_chr0262_3739_face00_eyeL_close'], bpy.data.actions['an_chr0262_3739_face00_eyeL_closeDeep'], bpy.data.actions['an_chr0262_3739_face00_eyeL_closeSmile'], bpy.data.actions['an_chr0262_3739_face00_eyeL_closeWink'], bpy.data.actions['an_chr0262_3739_face00_eyeL_half'], bpy.data.actions['an_chr0262_3739_face00_eyeL_halfDeep'], bpy.data.actions['an_chr0262_3739_face00_eyeL_open'], bpy.data.actions['an_chr0262_3739_face00_eyeL_open.001'], bpy.data.actions['an_chr0262_3739_face00_eyeL_openBig'], bpy.data.actions['an_chr0262_3739_face00_eyeL_openLaugh'], bpy.data.actions['an_chr0262_3739_face00_eyeL_openWink'], bpy.data.actions['an_chr0262_3739_face00_eyeR_close'], bpy.data.actions['an_chr0262_3739_face00_eyeR_closeDeep'], bpy.data.actions['an_chr0262_3739_face00_eyeR_closeSmile'], bpy.data.actions['an_chr0262_3739_face00_eyeR_closeWink'], bpy.data.actions['an_chr0262_3739_face00_eyeR_half'], bpy.data.actions['an_chr0262_3739_face00_eyeR_halfDeep'], bpy.data.actions['an_chr0262_3739_face00_eyeR_open'], bpy.data.actions['an_chr0262_3739_face00_eyeR_openBig'], bpy.data.actions['an_chr0262_3739_face00_eyeR_openLaugh'], bpy.data.actions['an_chr0262_3739_face00_eyeR_openWink'], bpy.data.actions['an_chr0262_3739_face00_mouth_a'], 
 #<此处省略一堆表情>
bpy.data.actions['an_chr0262_3739_face12_eyeR_open'], bpy.data.actions['an_chr0262_3739_face12_mouth_close']]
复制成功

先手动将其中一个actions应用到object上:

读下数据:

代码块
text/x-python
自动换行
复制代码
>>> bpy.context.selected_objects
[bpy.data.objects['md_chr0262_3739_hq']]

>>>bpy.data.objects['md_chr0262_3739_hq'].animation_data.action
bpy.data.actions['an_chr0262_3739_face00_eyeL_closeSmile']
复制成功

于是“应用骨骼动画”的命令就有了:

代码块
text/x-python
自动换行
复制代码
bpy.data.objects['md_chr0262_3739_hq'].animation_data.action = bpy.data.actions['<骨骼动画名称>']
#比如说,换个表情
bpy.data.objects['md_chr0262_3739_hq'].animation_data.action = bpy.data.actions['an_chr0262_3739_face00_eyeL_close']
复制成功

接着固定形态键:

Python工具提示里本身就给出了命令,用到了上个专栏里没提到的“替代GUI操作”的bpy.ops句柄:

看一下文档:

加个report=True以显示结果:

代码块
text/x-python
自动换行
复制代码
#需要先选中面部材质(M_Head)而非Armature(md_chr0262_3739_hq)
bpy.ops.object.modifier_apply_as_shapekey(keep_modifier=True, modifier="md_chr0262_3739_hq", report=True)
复制成功

由于属性缺失导致的前两行not found不影响结果,而第三行只有在成功固定形态键后才会出现

固定完形态键后,清空当前姿态:

(在GUI里)姿态模式→清空变换→全部

对应命令:

代码块
text/x-python
自动换行
复制代码
bpy.ops.object.mode_set(mode = 'POSE') bpy.ops.pose.transforms_clear()
复制成功

清完后,(在GUI里)切回物体模式:

代码块
text/x-python
自动换行
复制代码
bpy.ops.object.mode_set(mode = 'OBJECT')
复制成功

自此,需要的命令都有了,开码:

代码块
text/x-python
自动换行
复制代码
import bpy
import re
print("Start")
#保险起见,运行时只匹配一个armature
#之前说过selected_objects是列表,因此哪怕list里只有一个也要用for遍历赋值
for object in bpy.context.selected_objects:
    print("Selected:",object.name)
    if re.search(r"md_chr.*_.*", object.name):
        object_sel=object.name
    break

#主函数
def convert(input_object):
    action = bpy.data.actions
    for act in action:
        #将表情(动画)应用至object
        bpy.context.object.animation_data.action = bpy.data.actions.get(act.name)
        print("Apply:",act.name)
        #选中面部材质
        bpy.context.view_layer.objects.active = bpy.context.scene.objects["M_Head"]
        #固定修改器为形态键
        bpy.ops.object.modifier_apply_as_shapekey(keep_modifier = True, modifier = input_object, report = True)
        #重新选中object
        bpy.context.view_layer.objects.active = bpy.context.scene.objects[input_object]
        #GUI改成姿态模式
        bpy.ops.object.mode_set(mode = 'POSE')
        #清除object变形
        bpy.ops.pose.select_all(action='SELECT')
        bpy.ops.pose.transforms_clear()
        #GUI改回物体模式
        bpy.ops.object.mode_set(mode = 'OBJECT')
#主函数结束
        
#如果匹配成功就开始处理形态键,否则跳出
if 'object_sel' in locals():
    bpy.context.view_layer.objects.active = bpy.context.scene.objects[object_sel]
    print('Target object:',object_sel)
    convert(object_sel)
else:
    print('Target does not exist')

print("Done")
复制成功

丢blender里跑一遍:

形态键出来了:

繁琐的手动操作变成了脚本,最后导出pmx,可喜可贺——才怪。

能用,但还剩几个小问题。

3. Debug与改良

3.1. 形态键重命名

有58个形态键是没错...

但放PE一看,名字呢?

发现在固定形态键时,修改器名称一直是导入fbx时的“md_chr0257_3317_hq”(在上一节的控制台log里也能看到),于是过一遍“M_Head”材质的信息:

代码块
text/x-python
自动换行
复制代码
>>> list(bpy.context.object.modifiers)
bpy.data.objects['M_Head'].modifiers["md_chr0262_3739_hq"]
复制成功

既然固定形态键时需要指定修改器名称,那就“先改名再固定”,顺便把名字正则一下:

代码块
text/x-python
自动换行
复制代码
#修改器更名
modifier_name = re.search("face[^|]*",act.name).group()
bpy.context.object.modifiers[0].name = modifier_name
#固定修改器为形态键
bpy.ops.object.modifier_apply_as_shapekey(keep_modifier = True, modifier = modifier_name, report = True)
复制成功

重跑,导出:

解决。

3.2. 清理骨骼动画

在某次批量改模时发现,actions并不会随着armature删除消失,而是会保留在bpy.data里:

换句话说,如果载入多个fbx,批量导出的形态键就会重叠出错。

GUI里也没看到直接的删除方式,而且翻了圈找到的办法似乎有点奇怪——

在有任意object的状态下,应用上骨骼动画, 然后关闭该动画的“伪用户(fake_user)”参数;

保存并重新载入工程文件后(直接点左上角的“重新载入”没用),如果该骨骼动画未被使用的话,就会自动从data中被删除。

基于这点,整了段用来清actions的函数(匹配规则为“不包含object名称”):

代码块
text/x-python
自动换行
复制代码
def clean_action(input_object):
    if len(bpy.data.actions) > 0:
       for act_single in bpy.data.actions:
           if not re.search(input_object, act_single.name):
                act_single.use_fake_user = False
                print (act_single.name,":not match, removed")
复制成功

或者更干脆点的全清:

代码块
text/x-python
自动换行
复制代码
for act_single in bpy.data.actions:
	act_single.use_fake_user = False
 	print (act_single.name,"removed")
复制成功

实用性不大(不如重开blender),但值得记录一下。

如果有人知道不需要保留object就能删actions的方法的话,还请务必赐教。

3.3. 后续的MMD表情名称映射

并不麻烦,和上篇专栏改骨骼名称一样,对着字典查找匹配即可:

代码块
text/x-python
自动换行
复制代码
>>> list(bpy.context.selected_objects[0].data.shape_keys.key_blocks)
[bpy.data.shape_keys['Key'].key_blocks["基型"], bpy.data.shape_keys['Key'].key_blocks["face00_eyeL_closeDeep"]
 #此处省略一堆表情
bpy.data.shape_keys['Key'].key_blocks["face12_eyeR_open"], bpy.data.shape_keys['Key'].key_blocks["face12_mouth_close"]
复制成功

代码块
text/x-python
自动换行
复制代码
 #改名
 bpy.data.shape_keys['Key'].key_blocks["face12_mouth_close"].name = "Target Name"
复制成功

最后结果:

代码块
text/x-python
自动换行
复制代码
import bpy
import re
print("Start")

error_flag=0

for object in bpy.context.selected_objects:
    print("Selected:",object.name)
    if re.search(r"md_chr.*_.*", object.name):
        object_sel=object.name
    break

def convert(input_object):
    action = bpy.data.actions
    for act in action:
        bpy.context.object.animation_data.action = bpy.data.actions.get(act.name)
        print("Apply:",act.name)
        bpy.context.view_layer.objects.active = bpy.context.scene.objects["M_Head"]
        modifier_name = re.search("face[^|]*",act.name).group()
        bpy.context.object.modifiers[0].name = modifier_name
        bpy.ops.object.modifier_apply_as_shapekey(keep_modifier = True, modifier = modifier_name, report = True)
        bpy.context.view_layer.objects.active = bpy.context.scene.objects[input_object]
        bpy.ops.object.mode_set(mode = 'POSE')
        bpy.ops.pose.select_all(action='SELECT')
        bpy.ops.pose.transforms_clear()
        bpy.ops.object.mode_set(mode = 'OBJECT')

def clean_action(input_object):
    global error_flag
    if len(bpy.data.actions) > 0:
       for act_single in bpy.data.actions:
           if not re.search(input_object, act_single.name):
                act_single.use_fake_user = False
                print ('Action:',act_single.name,'not match, removed')
                error_flag=1

bpy.context.view_layer.objects.active = bpy.context.scene.objects[object_sel]
clean_action(object_sel)

if ('object_sel' in locals()) and (error_flag == 0):
    print('Target object:',object_sel)
    convert(object_sel)
elif (error_flag == 1):
    print('Error:Action unmatch,save and reload project.')
else:
    print('Error:Target does not exist')

print("Done")
复制成功

后记

  • dA上认识的另一位改模佬也讲了个脚本思路:

    像从unity里提取动作一样,将animationclip合并导出为vmd(一帧一个表情),然后在blender里以单个骨骼动画的状态进行切分固定。

    流程更像是拆星耀季节模型的表情,虽然不用担心受来自其他模型的action影响,但“导出vmd”的部分操作起来就有点复杂了。

  • 值得一提的是,在游戏中,针对曲目的特殊表情(比如《The VILLAIN'S NIGHT》里长出吸血鬼牙的米莉亚和桃华)则很有可能会在更新时统一往同角色的所有头模里加骨骼动画:

鬼故事:今天真实装了万圣限定SSR桃华。

  • 比如上述的尖牙表情就是“face02_mouth_close”。

    *在这点上,隔壁马娘则将骨骼表情和头模分开存放,连更新头模的时间都省了。

  • 另外放份最初用来改模的版本,以警醒自己当时写的有多糟糕:

代码块
text/x-python
自动换行
复制代码
#ShapeKey for CGSS.py
import bpy
import re
print("Start")

for object in bpy.context.selectable_objects:
    print("Selected:",object.name)
    if re.search(r"md_chr.*_.*", object.name):
     object_sel=object.name
     break

bpy.context.view_layer.objects.active = bpy.context.scene.objects[object_sel]

action = bpy.data.actions

for act in action:
   bpy.context.view_layer.objects.active = bpy.context.scene.objects[object_sel]
   bpy.context.object.animation_data.action = bpy.data.actions.get(act.name)
   print("Apply:",act)
   bpy.context.view_layer.objects.active = bpy.context.scene.objects["M_Head"]
   bpy.ops.object.modifier_apply_as_shapekey(keep_modifier = True, modifier = object_sel, report = True)
   
   bpy.context.view_layer.objects.active = bpy.context.scene.objects[object_sel]
   bpy.ops.object.mode_set(mode = 'POSE')
   bpy.ops.pose.select_all(action='SELECT')
   bpy.ops.pose.transforms_clear()
   bpy.ops.object.mode_set(mode = 'OBJECT')

bpy.context.view_layer.objects.active = bpy.context.scene.objects["M_Head"]
length=len(action)
for num in range(0,length):
    
 act_str=str(action[num])
 matched =re.search("(face.*?)\|", act_str)

 if not matched:
    continue
 
 result=matched.group(1)
 bpy.context.object.active_shape_key_index = num + 1
 bpy.context.object.active_shape_key.name = result
 
print("Done")
复制成功
  • 用到的芳乃以后可能会修一下放上dA。

    ↑已经放了。

以上。

本期专栏头图

写完脚本后又拿黑fes芳乃验证了一下,发现模型上带了个法螺贝...

[マジカル☆ストレンジャー]赤城みりあ & [風雅水鏡]依田芳乃

Copyright©

Cygames/BANDAI NAMCO

同好的担当也真可爱。

2023/10/4

岸田夏海