Hypnagogia/Dynamic-Link-Manager
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

refactor operator labels and document operators

Browse Source
This commit is contained in:
Nathan
2026-02-19 11:35:00 -07:00
parent 55afba30a8
commit ae38056b1c
4 changed files with 1302 additions and 39 deletions
Download Patch File Download Diff File Expand all files Collapse all files
.specstory/history/2026-02-18_23-39Z-character-migrator-workflow-integration.md
+1234 -1
View File
File diff suppressed because one or more lines are too long
ops/migrator.py
+14 -14
View File
@@ -37,8 +37,8 @@ def get_pair_automatic(context):
return pairs[0] if pairs else (None, None)
def run_step_1(orig, rep):
"""Copy armature object attributes: location, rotation, scale."""
def run_copy_attr(orig, rep):
"""Copy armature object attributes: location, rotation, scale (CopyAttr)."""
rep.location = orig.location.copy()
if orig.rotation_mode == "QUATERNION":
rep.rotation_quaternion = orig.rotation_quaternion.copy()
@@ -64,8 +64,8 @@ def _mirror_als_turn_on(orig, rep):
pass
def run_step_2(orig, rep):
"""Migrate NLA: copy tracks and strips to replacement; or apply active action only."""
def run_mig_nla(orig, rep):
"""Migrate NLA: copy tracks and strips to replacement; or apply active action only (MigNLA)."""
if not orig.animation_data:
return
ad = orig.animation_data
@@ -127,7 +127,7 @@ def run_step_2(orig, rep):
EXCLUDE_PROPS = {"_RNA_UI", "rigify_type", "rigify_parameters"}
def run_step_3(orig, rep):
def run_mig_cust_props(orig, rep):
"""Custom properties: copy pose-bone custom props, exclude rigify internals."""
for pbone in orig.pose.bones:
if pbone.name not in rep.pose.bones:
@@ -142,7 +142,7 @@ def run_step_3(orig, rep):
pass
def run_step_4(orig, rep, orig_to_rep):
def run_mig_bone_const(orig, rep, orig_to_rep):
"""Bone constraints: remove stale on rep, copy from orig with retarget, trim duplicates."""
other_originals = [o for o in orig_to_rep if o != orig]
for pb in rep.pose.bones:
@@ -181,7 +181,7 @@ def run_step_4(orig, rep, orig_to_rep):
rr.remove(rr[-1])
def run_step_5(orig, rep, rep_descendants, orig_to_rep):
def run_retarg_relatives(orig, rep, rep_descendants, orig_to_rep):
"""Retarget relations: parents, constraint targets, Armature modifiers to rep."""
candidates = set(rep_descendants)
for ob in bpy.data.objects:
@@ -255,7 +255,7 @@ def _find_base_body(armature, descendants_iter, rep_base_name=None):
return candidates[0]
def run_step_6(orig, rep, rep_descendants, context=None):
def run_mig_bbody_shapekeys(orig, rep, rep_descendants, context=None):
"""Replacement base body: library override (fully editable when context given), copy shapekey values, then shape-key action."""
orig_descendants = list(descendants(orig))
for ob in list(rep_descendants):
@@ -366,12 +366,12 @@ def run_full_migration(context):
rep_descendants = descendants(rep)
try:
run_step_1(orig, rep)
run_step_2(orig, rep)
run_step_3(orig, rep)
run_step_4(orig, rep, orig_to_rep)
run_step_5(orig, rep, rep_descendants, orig_to_rep)
run_step_6(orig, rep, rep_descendants, context)
run_copy_attr(orig, rep)
run_mig_nla(orig, rep)
run_mig_cust_props(orig, rep)
run_mig_bone_const(orig, rep, orig_to_rep)
run_retarg_relatives(orig, rep, rep_descendants, orig_to_rep)
run_mig_bbody_shapekeys(orig, rep, rep_descendants, context)
except Exception as e:
return False, str(e)
return True, f"Migrated {orig.name} → {rep.name}"
ui/operators.py
+48 -18
View File
@@ -18,6 +18,7 @@ def _prefs(context):
class DLM_OT_replace_linked_asset(Operator):
bl_idname = "dlm.replace_linked_asset"
bl_label = "Replace Linked Asset"
bl_description = "Open file browser to replace the linked asset with another file"
bl_options = {"REGISTER", "UNDO"}
filepath: StringProperty(name="File Path", description="Path to the new asset file", subtype="FILE_PATH")
@@ -48,6 +49,7 @@ class DLM_OT_replace_linked_asset(Operator):
class DLM_OT_scan_linked_assets(Operator):
bl_idname = "dlm.scan_linked_assets"
bl_label = "Scan Linked Libraries"
bl_description = "Scan the current file for linked libraries and list their status"
bl_options = {"REGISTER"}
def execute(self, context):
@@ -59,6 +61,7 @@ class DLM_OT_scan_linked_assets(Operator):
class DLM_OT_find_libraries_in_folders(Operator):
bl_idname = "dlm.find_libraries_in_folders"
bl_label = "Find Libraries in Folders"
bl_description = "Search addon search paths for missing library blend files"
bl_options = {"REGISTER", "UNDO"}
def execute(self, context):
@@ -70,6 +73,7 @@ class DLM_OT_find_libraries_in_folders(Operator):
class DLM_OT_open_linked_file(Operator):
bl_idname = "dlm.open_linked_file"
bl_label = "Open Linked File"
bl_description = "Open the selected linked blend file in a new Blender instance"
bl_options = {"REGISTER"}
filepath: StringProperty(name="File Path", default="")
@@ -89,6 +93,7 @@ class DLM_OT_open_linked_file(Operator):
class DLM_OT_add_search_path(Operator):
bl_idname = "dlm.add_search_path"
bl_label = "Add Search Path"
bl_description = "Add a new folder to the list of search paths for finding libraries"
bl_options = {"REGISTER"}
def execute(self, context):
@@ -103,6 +108,7 @@ class DLM_OT_add_search_path(Operator):
class DLM_OT_remove_search_path(Operator):
bl_idname = "dlm.remove_search_path"
bl_label = "Remove Search Path"
bl_description = "Remove the selected search path from the list"
bl_options = {"REGISTER"}
index: IntProperty(name="Index", default=0)
@@ -117,6 +123,7 @@ class DLM_OT_remove_search_path(Operator):
class DLM_OT_attempt_relink(Operator):
bl_idname = "dlm.attempt_relink"
bl_label = "Attempt Relink"
bl_description = "Try to relink missing libraries using the configured search paths"
bl_options = {"REGISTER"}
def execute(self, context):
@@ -128,6 +135,7 @@ class DLM_OT_attempt_relink(Operator):
class DLM_OT_browse_search_path(Operator):
bl_idname = "dlm.browse_search_path"
bl_label = "Browse Search Path"
bl_description = "Browse to set the folder for the selected search path"
bl_options = {"REGISTER"}
index: IntProperty(name="Index", default=0)
filepath: StringProperty(name="Search Path", subtype="DIR_PATH")
@@ -150,6 +158,7 @@ class DLM_OT_browse_search_path(Operator):
class DLM_OT_reload_libraries(Operator):
bl_idname = "dlm.reload_libraries"
bl_label = "Reload Libraries"
bl_description = "Reload all linked libraries (or fallback manual reload)"
bl_options = {"REGISTER"}
def execute(self, context):
@@ -171,6 +180,7 @@ class DLM_OT_reload_libraries(Operator):
class DLM_OT_make_paths_relative(Operator):
bl_idname = "dlm.make_paths_relative"
bl_label = "Make Paths Relative"
bl_description = "Convert all internal file paths to relative"
bl_options = {"REGISTER"}
def execute(self, context):
@@ -186,6 +196,7 @@ class DLM_OT_make_paths_relative(Operator):
class DLM_OT_make_paths_absolute(Operator):
bl_idname = "dlm.make_paths_absolute"
bl_label = "Make Paths Absolute"
bl_description = "Convert all internal file paths to absolute"
bl_options = {"REGISTER"}
def execute(self, context):
@@ -201,6 +212,7 @@ class DLM_OT_make_paths_absolute(Operator):
class DLM_OT_relocate_single_library(Operator):
bl_idname = "dlm.relocate_single_library"
bl_label = "Relocate Library"
bl_description = "Point the selected library to a new blend file and reload"
bl_options = {"REGISTER", "UNDO"}
target_filepath: StringProperty(name="Current Library Path", default="")
filepath: StringProperty(name="New Library File", subtype="FILE_PATH", default="")
@@ -256,7 +268,8 @@ def _get_migrator_pair(context):
class DLM_OT_migrator_copy_attributes(Operator):
bl_idname = "dlm.migrator_copy_attributes"
bl_label = "Copy attributes"
bl_label = "CopyAttr"
bl_description = "Copy object and armature attributes from original to replacement character"
bl_icon = "COPY_ID"
bl_options = {"REGISTER", "UNDO"}
@@ -266,8 +279,8 @@ class DLM_OT_migrator_copy_attributes(Operator):
self.report({"ERROR"}, "No valid character pair (set Original/Replacement or enable Automatic).")
return {"CANCELLED"}
try:
from ..ops.migrator import run_step_1
run_step_1(orig, rep)
from ..ops.migrator import run_copy_attr
run_copy_attr(orig, rep)
self.report({"INFO"}, "Copy attributes done.")
return {"FINISHED"}
except Exception as e:
@@ -277,7 +290,8 @@ class DLM_OT_migrator_copy_attributes(Operator):
class DLM_OT_migrator_migrate_nla(Operator):
bl_idname = "dlm.migrator_migrate_nla"
bl_label = "Migrate NLA"
bl_label = "MigNLA"
bl_description = "Migrate NLA tracks and strips from original to replacement character"
bl_icon = "NLA"
bl_options = {"REGISTER", "UNDO"}
@@ -287,8 +301,8 @@ class DLM_OT_migrator_migrate_nla(Operator):
self.report({"ERROR"}, "No valid character pair.")
return {"CANCELLED"}
try:
from ..ops.migrator import run_step_2
run_step_2(orig, rep)
from ..ops.migrator import run_mig_nla
run_mig_nla(orig, rep)
self.report({"INFO"}, "Migrate NLA done.")
return {"FINISHED"}
except Exception as e:
@@ -298,7 +312,8 @@ class DLM_OT_migrator_migrate_nla(Operator):
class DLM_OT_migrator_custom_properties(Operator):
bl_idname = "dlm.migrator_custom_properties"
bl_label = "Custom properties"
bl_label = "MigCustProps"
bl_description = "Copy custom properties from original to replacement character"
bl_icon = "PROPERTIES"
bl_options = {"REGISTER", "UNDO"}
@@ -308,8 +323,8 @@ class DLM_OT_migrator_custom_properties(Operator):
self.report({"ERROR"}, "No valid character pair.")
return {"CANCELLED"}
try:
from ..ops.migrator import run_step_3
run_step_3(orig, rep)
from ..ops.migrator import run_mig_cust_props
run_mig_cust_props(orig, rep)
self.report({"INFO"}, "Custom properties done.")
return {"FINISHED"}
except Exception as e:
@@ -319,7 +334,8 @@ class DLM_OT_migrator_custom_properties(Operator):
class DLM_OT_migrator_bone_constraints(Operator):
bl_idname = "dlm.migrator_bone_constraints"
bl_label = "Bone constraints"
bl_label = "MigBoneConst"
bl_description = "Migrate bone constraints from original to replacement armature"
bl_icon = "CONSTRAINT_BONE"
bl_options = {"REGISTER", "UNDO"}
@@ -329,9 +345,9 @@ class DLM_OT_migrator_bone_constraints(Operator):
self.report({"ERROR"}, "No valid character pair.")
return {"CANCELLED"}
try:
from ..ops.migrator import run_step_4
from ..ops.migrator import run_mig_bone_const
orig_to_rep = {orig: rep}
run_step_4(orig, rep, orig_to_rep)
run_mig_bone_const(orig, rep, orig_to_rep)
self.report({"INFO"}, "Bone constraints done.")
return {"FINISHED"}
except Exception as e:
@@ -341,7 +357,8 @@ class DLM_OT_migrator_bone_constraints(Operator):
class DLM_OT_migrator_retarget_relations(Operator):
bl_idname = "dlm.migrator_retarget_relations"
bl_label = "Retarget relations"
bl_label = "RetargRelatives"
bl_description = "Retarget parent/child and other relations to the replacement character"
bl_icon = "ORIENTATION_PARENT"
bl_options = {"REGISTER", "UNDO"}
@@ -351,11 +368,11 @@ class DLM_OT_migrator_retarget_relations(Operator):
self.report({"ERROR"}, "No valid character pair.")
return {"CANCELLED"}
try:
from ..ops.migrator import run_step_5
from ..ops.migrator import run_retarg_relatives
from ..utils import descendants
rep_descendants = descendants(rep)
orig_to_rep = {orig: rep}
run_step_5(orig, rep, rep_descendants, orig_to_rep)
run_retarg_relatives(orig, rep, rep_descendants, orig_to_rep)
self.report({"INFO"}, "Retarget relations done.")
return {"FINISHED"}
except Exception as e:
@@ -365,7 +382,8 @@ class DLM_OT_migrator_retarget_relations(Operator):
class DLM_OT_migrator_basebody_shapekeys(Operator):
bl_idname = "dlm.migrator_basebody_shapekeys"
bl_label = "Migrate BaseBody shapekeys"
bl_label = "MigBBodyShapeKeys"
bl_description = "Migrate base body mesh shape key values from original to replacement"
bl_icon = "SHAPEKEY_DATA"
bl_options = {"REGISTER", "UNDO"}
@@ -375,10 +393,10 @@ class DLM_OT_migrator_basebody_shapekeys(Operator):
self.report({"ERROR"}, "No valid character pair.")
return {"CANCELLED"}
try:
from ..ops.migrator import run_step_6
from ..ops.migrator import run_mig_bbody_shapekeys
from ..utils import descendants
rep_descendants = descendants(rep)
run_step_6(orig, rep, rep_descendants, context)
run_mig_bbody_shapekeys(orig, rep, rep_descendants, context)
self.report({"INFO"}, "Migrate BaseBody shapekeys done.")
return {"FINISHED"}
except Exception as e:
@@ -399,6 +417,7 @@ MIGRATOR_STEP_OPS = (
class DLM_OT_run_character_migration(Operator):
bl_idname = "dlm.run_character_migration"
bl_label = "Run Character Migration"
bl_description = "Run all six migration steps (CopyAttr, MigNLA, MigCustProps, MigBoneConst, RetargRelatives, MigBBodyShapeKeys) in order"
bl_options = {"REGISTER", "UNDO"}
def execute(self, context):
@@ -422,6 +441,7 @@ class DLM_OT_run_character_migration(Operator):
class DLM_OT_picker_original_character(Operator):
bl_idname = "dlm.picker_original_character"
bl_label = "Pick Original"
bl_description = "Set the original character armature from the active object"
bl_options = {"REGISTER"}
def execute(self, context):
@@ -437,6 +457,7 @@ class DLM_OT_picker_original_character(Operator):
class DLM_OT_picker_replacement_character(Operator):
bl_idname = "dlm.picker_replacement_character"
bl_label = "Pick Replacement"
bl_description = "Set the replacement character armature from the active object"
bl_options = {"REGISTER"}
def execute(self, context):
@@ -457,6 +478,7 @@ def _tweak_poll(context):
class DLM_OT_tweak_add_arm(Operator):
bl_idname = "dlm.tweak_add_arm"
bl_label = "Add Arm Tweaks"
bl_description = "Add tweak bone constraints to arm bones on the replacement character"
bl_options = {"REGISTER", "UNDO"}
@classmethod
@@ -474,6 +496,7 @@ class DLM_OT_tweak_add_arm(Operator):
class DLM_OT_tweak_remove_arm(Operator):
bl_idname = "dlm.tweak_remove_arm"
bl_label = "Remove Arm Tweaks"
bl_description = "Remove arm tweak constraints from the replacement character"
bl_options = {"REGISTER", "UNDO"}
@classmethod
@@ -491,6 +514,7 @@ class DLM_OT_tweak_remove_arm(Operator):
class DLM_OT_tweak_bake_arm(Operator):
bl_idname = "dlm.tweak_bake_arm"
bl_label = "Bake Arm Tweaks"
bl_description = "Bake arm tweak constraints to keyframes and optionally remove constraints"
bl_options = {"REGISTER", "UNDO"}
@classmethod
@@ -516,6 +540,7 @@ class DLM_OT_tweak_bake_arm(Operator):
class DLM_OT_tweak_add_leg(Operator):
bl_idname = "dlm.tweak_add_leg"
bl_label = "Add Leg Tweaks"
bl_description = "Add tweak bone constraints to leg bones on the replacement character"
bl_options = {"REGISTER", "UNDO"}
@classmethod
@@ -533,6 +558,7 @@ class DLM_OT_tweak_add_leg(Operator):
class DLM_OT_tweak_remove_leg(Operator):
bl_idname = "dlm.tweak_remove_leg"
bl_label = "Remove Leg Tweaks"
bl_description = "Remove leg tweak constraints from the replacement character"
bl_options = {"REGISTER", "UNDO"}
@classmethod
@@ -550,6 +576,7 @@ class DLM_OT_tweak_remove_leg(Operator):
class DLM_OT_tweak_bake_leg(Operator):
bl_idname = "dlm.tweak_bake_leg"
bl_label = "Bake Leg Tweaks"
bl_description = "Bake leg tweak constraints to keyframes and optionally remove constraints"
bl_options = {"REGISTER", "UNDO"}
@classmethod
@@ -575,6 +602,7 @@ class DLM_OT_tweak_bake_leg(Operator):
class DLM_OT_tweak_add_both(Operator):
bl_idname = "dlm.tweak_add_both"
bl_label = "Add Arm & Leg Tweaks"
bl_description = "Add tweak bone constraints to both arm and leg bones"
bl_options = {"REGISTER", "UNDO"}
@classmethod
@@ -592,6 +620,7 @@ class DLM_OT_tweak_add_both(Operator):
class DLM_OT_tweak_remove_both(Operator):
bl_idname = "dlm.tweak_remove_both"
bl_label = "Remove Arm & Leg Tweaks"
bl_description = "Remove all arm and leg tweak constraints from the replacement character"
bl_options = {"REGISTER", "UNDO"}
@classmethod
@@ -609,6 +638,7 @@ class DLM_OT_tweak_remove_both(Operator):
class DLM_OT_tweak_bake_both(Operator):
bl_idname = "dlm.tweak_bake_both"
bl_label = "Bake Arm & Leg Tweaks"
bl_description = "Bake all arm and leg tweak constraints to keyframes and optionally remove constraints"
bl_options = {"REGISTER", "UNDO"}
@classmethod
ui/panels.py
+6 -6
View File
@@ -86,13 +86,13 @@ class DLM_PT_main_panel(Panel):
row = box.row()
row.operator("dlm.run_character_migration", text="Run migration", icon="ARMATURE_DATA")
row = box.row(align=True)
row.operator("dlm.migrator_copy_attributes", text="Copy attributes", icon="COPY_ID")
row.operator("dlm.migrator_migrate_nla", text="NLA", icon="NLA")
row.operator("dlm.migrator_custom_properties", text="Custom properties", icon="PROPERTIES")
row.operator("dlm.migrator_copy_attributes", text="CopyAttr", icon="COPY_ID")
row.operator("dlm.migrator_migrate_nla", text="MigNLA", icon="NLA")
row.operator("dlm.migrator_custom_properties", text="MigCustProps", icon="PROPERTIES")
row = box.row(align=True)
row.operator("dlm.migrator_bone_constraints", text="Bone constraints", icon="CONSTRAINT_BONE")
row.operator("dlm.migrator_retarget_relations", text="Retarget relations", icon="ORIENTATION_PARENT")
row.operator("dlm.migrator_basebody_shapekeys", text="BaseBody ShapeKeys", icon="SHAPEKEY_DATA")
row.operator("dlm.migrator_bone_constraints", text="MigBoneConst", icon="CONSTRAINT_BONE")
row.operator("dlm.migrator_retarget_relations", text="RetargRelatives", icon="ORIENTATION_PARENT")
row.operator("dlm.migrator_basebody_shapekeys", text="MigBBodyShapeKeys", icon="SHAPEKEY_DATA")
# Tweak Tools
tweak_box = layout.box()