pyjallib 0.1.9__py3-none-any.whl → 0.1.11__py3-none-any.whl

pyjallib/max/hip.py

@@ -1,366 +1,276 @@
-#!/usr/bin/env python
-# -*- coding: utf-8 -*-
-
-"""
-Hip 모듈 - 3ds Max용 Hip 관련 기능 제공
-원본 MAXScript의 hip.ms를 Python으로 변환하였으며, pymxs 모듈 기반으로 구현됨
-"""
-
-from pymxs import runtime as rt
-from .header import jal
-
-
-class Hip:
-    """
-    Hip 관련 기능을 제공하는 클래스.
-    MAXScript의 _Hip 구조체 개념을 Python으로 재구현한 클래스이며,
-    3ds Max의 기능들을 pymxs API를 통해 제어합니다.
-    """
-    
-    def __init__(self):
-        """
-        클래스 초기화.
-        
-        Args:
-            nameService: 이름 처리 서비스 (제공되지 않으면 새로 생성)
-            animService: 애니메이션 서비스 (제공되지 않으면 새로 생성)
-            helperService: 헬퍼 객체 관련 서비스 (제공되지 않으면 새로 생성)
-            boneService: 뼈대 관련 서비스 (제공되지 않으면 새로 생성)
-            constraintService: 제약 관련 서비스 (제공되지 않으면 새로 생성)
-            bipService: Biped 관련 서비스 (제공되지 않으면 새로 생성)
-        """
-        # 서비스 초기화
-        self.name = jal.name
-        self.anim = jal.anim
-        self.helper = jal.helper
-        self.bone = jal.bone
-        self.const = jal.constraint
-        self.bip = jal.bip
-        
-        # 기본 속성 초기화
-        self.bone_size = 2.0
-        self.bone_array = []
-        self.pelvis_weight = 60.0
-        self.thigh_weight = 40.0
-        self.x_axis_offset = 0.1
-        
-        # 객체 참조 초기화
-        self.spine_dummy = None
-        self.l_hip_dummy = None
-        self.l_hip_target_dummy = None
-        self.l_hip_exp = None
-        self.r_hip_dummy = None
-        self.r_hip_target_dummy = None
-        self.r_hip_exp = None
-        
-        self.pelvis = None
-        self.spine = None
-        self.l_thigh = None
-        self.l_thigh_twist = None
-        self.r_thigh = None
-        self.r_thigh_twist = None
-        
-        self.helper_array = []
-    
-    def init(self, in_bip, in_l_thigh_twist, in_r_thigh_twist, 
-             in_x_axis_offset=0.1,
-             in_pelvis_weight=60.0, in_thigh_weight=40.0,
-             in_bone_size=2.0):
-        
-        self.bone_size = in_bone_size
-        self.x_axis_offset = in_x_axis_offset
-        
-        self.pelvis_weight = in_pelvis_weight
-        self.thigh_weight = in_thigh_weight
-        
-        self.pelvis = self.bip.get_grouped_nodes(in_bip, "pelvis")[0]
-        self.spine = rt.biped.getNode(in_bip, rt.Name("spine"), link=1)
-        self.l_thigh = rt.biped.getNode(in_bip, rt.Name("lleg"), link=1)
-        self.r_thigh = rt.biped.getNode(in_bip, rt.Name("rleg"), link=1)
-        self.l_thigh_twist = in_l_thigh_twist
-        self.r_thigh_twist = in_r_thigh_twist
-        
-        self.bone_array = []
-        self.helper_array = []
-    
-    def assign_position_script(self, in_obj, in_exp, in_scale="0.1"):
-        """
-        위치 스크립트 컨트롤러 할당
-        
-        Args:
-            in_obj: 대상 객체
-            in_exp: 표현식 객체 (ExposeTm)
-            in_scale: 스케일 값 (문자열)
-        """
-        # 위치 리스트 컨트롤러 할당
-        pos_list = self.const.assign_pos_list(in_obj)
-        
-        # 위치 스크립트 컨트롤러 생성
-        pos_script = rt.position_script()
-        rt.setPropertyController(pos_list, "Available", pos_script)
-        pos_list.setActive(pos_list.count)
-        
-        # 표현식 객체 추가 및 스크립트 설정
-        pos_script.AddNode("exp", in_exp)
-        script_str = ""
-        script_str += "zRotValue = amin 0.0 exp.localEulerZ\n"
-        script_str += f"result = [0, zRotValue * {in_scale}, 0]\n"
-        script_str += "result"
-        
-        pos_script.SetExpression(script_str)
-        pos_script.Update()
-        
-        # 마지막 컨트롤러 활성화
-        self.const.set_active_last(in_obj)
-    
-    def update_position_script_scale_value(self, in_obj, in_val):
-        """
-        위치 스크립트 스케일 값 업데이트
-        
-        Args:
-            in_obj: 대상 객체
-            in_val: 새 스케일 값
-        """
-        # 위치 리스트 컨트롤러 가져오기
-        pos_list = self.const.get_pos_list_controller(in_obj)
-        
-        if pos_list is not None and pos_list.count >= 3:
-            # 위치 스크립트 컨트롤러 가져오기
-            pos_script = rt.getPropertyController(pos_list, "Controller3")
-            
-            # pos_script가 Position_Script 형태인지 확인
-            if rt.classOf(pos_script) == rt.Position_Script:
-                new_scale = str(in_val)
-                script_str = ""
-                script_str += "zRotValue = amin 0.0 exp.localEulerZ\n"
-                script_str += f"result = [0, zRotValue * {new_scale}, 0]\n"
-                script_str += "result"
-                
-                pos_script.SetExpression(script_str)
-                pos_script.Update()
-    
-    def gen_helpers(self):
-        """
-        헬퍼 객체 생성
-        
-        Returns:
-            생성된 헬퍼 객체 배열
-        """
-        self.spine_dummy = self.helper.create_point(
-            self.name.combine(in_base=self.base_name, 
-                             in_type=self.name.get_dummyStr(), 
-                             in_real_name="HipSpine", 
-                             in_index="0", 
-                             in_fil_char=self.filtering_char),
-            box_toggle=True, cross_toggle=False, axis_toggle=False
-        )
-        
-        self.l_hip_dummy = self.helper.create_point(
-            self.name.combine(in_base=self.base_name, 
-                             in_type=self.name.get_dummyStr(), 
-                             in_side=self.name.get_leftStr(), 
-                             in_real_name="Hip", 
-                             in_index="0", 
-                             in_fil_char=self.filtering_char),
-            box_toggle=True, cross_toggle=False, axis_toggle=False
-        )
-        
-        self.l_hip_target_dummy = self.helper.create_point(
-            self.name.combine(in_base=self.base_name, 
-                             in_type=self.name.get_dummyStr(), 
-                             in_side=self.name.get_leftStr(), 
-                             in_real_name="HipTgt", 
-                             in_index="0", 
-                             in_fil_char=self.filtering_char),
-            box_toggle=False, cross_toggle=True, axis_toggle=False
-        )
-        
-        # ExposeTm 객체 생성
-        self.l_hip_exp = rt.ExposeTm(
-            name=self.name.combine(in_base=self.base_name, 
-                                  in_type=self.name.get_exposeTMStr(), 
-                                  in_side=self.name.get_leftStr(), 
-                                  in_real_name="Hip", 
-                                  in_index="0", 
-                                  in_fil_char=self.filtering_char),
-            size=1, 
-            boxToggle=True, 
-            crossToggle=False, 
-            wirecolor=rt.color(14, 255, 2)
-        )
-        
-        self.r_hip_dummy = self.helper.create_point(
-            self.name.combine(in_base=self.base_name, 
-                             in_type=self.name.get_dummyStr(), 
-                             in_side=self.name.get_rightStr(), 
-                             in_real_name="Hip", 
-                             in_index="0", 
-                             in_fil_char=self.filtering_char),
-            box_toggle=True, cross_toggle=False, axis_toggle=False
-        )
-        
-        self.r_hip_target_dummy = self.helper.create_point(
-            self.name.combine(in_base=self.base_name, 
-                             in_type=self.name.get_dummyStr(), 
-                             in_side=self.name.get_rightStr(), 
-                             in_real_name="HipTgt", 
-                             in_index="0", 
-                             in_fil_char=self.filtering_char),
-            box_toggle=False, cross_toggle=True, axis_toggle=False
-        )
-        
-        # ExposeTm 객체 생성
-        self.r_hip_exp = rt.ExposeTm(
-            name=self.name.combine(in_base=self.base_name, 
-                                  in_type=self.name.get_exposeTMStr(), 
-                                  in_side=self.name.get_rightStr(), 
-                                  in_real_name="Hip", 
-                                  in_index="0", 
-                                  in_fil_char=self.filtering_char),
-            size=1, 
-            boxToggle=True, 
-            crossToggle=False, 
-            wirecolor=rt.color(14, 255, 2)
-        )
-        
-        self.helper_array = []
-        self.helper_array.append(self.spine_dummy)
-        self.helper_array.append(self.l_hip_dummy)
-        self.helper_array.append(self.l_hip_target_dummy)
-        self.helper_array.append(self.l_hip_exp)
-        self.helper_array.append(self.r_hip_dummy)
-        self.helper_array.append(self.r_hip_target_dummy)
-        self.helper_array.append(self.r_hip_exp)
-        
-        return self.helper_array
-    
-    def create(self):
-        """
-        Hip 리깅 생성
-        """
-        self.gen_helpers()
-        
-        self.l_hip_dummy.transform = self.l_thigh_twist.transform
-        self.r_hip_dummy.transform = self.r_thigh_twist.transform
-        
-        self.const.assign_pos_const(self.spine_dummy, self.spine)
-        self.const.assign_rot_const_multi(self.spine_dummy, [self.l_thigh_twist, self.r_thigh_twist])
-        self.const.collapse(self.spine_dummy)
-        
-        self.l_hip_dummy.parent = self.pelvis
-        self.l_hip_target_dummy.parent = self.pelvis
-        self.l_hip_exp.parent = self.pelvis
-        self.r_hip_dummy.parent = self.pelvis
-        self.r_hip_target_dummy.parent = self.pelvis
-        self.r_hip_exp.parent = self.pelvis
-        self.spine_dummy.parent = self.pelvis
-        
-        # 왼쪽 hip dummy의 rotation constraint 설정
-        self.const.assign_rot_list(self.l_hip_dummy)
-        rot_const = rt.Orientation_Constraint()
-        rot_list = self.const.get_rot_list_controller(self.l_hip_dummy)
-        rt.setPropertyController(rot_list, "Available", rot_const)
-        rot_list.setActive(rot_list.count)
-        
-        # Constraint 타겟 추가
-        rot_const.appendTarget(self.spine_dummy, self.pelvis_weight)
-        rot_const.appendTarget(self.l_thigh_twist, self.thigh_weight)
-        rot_const.relative = True
-        
-        # 오른쪽 hip dummy의 rotation constraint 설정
-        self.const.assign_rot_list(self.r_hip_dummy)
-        rot_const = rt.Orientation_Constraint()
-        rot_list = self.const.get_rot_list_controller(self.r_hip_dummy)
-        rt.setPropertyController(rot_list, "Available", rot_const)
-        rot_list.setActive(rot_list.count)
-        
-        # Constraint 타겟 추가
-        rot_const.appendTarget(self.spine_dummy, self.pelvis_weight)
-        rot_const.appendTarget(self.r_thigh_twist, self.thigh_weight)
-        rot_const.relative = True
-        
-        self.l_hip_target_dummy.transform = self.l_hip_dummy.transform
-        self.l_hip_exp.transform = self.l_hip_dummy.transform
-        self.r_hip_target_dummy.transform = self.r_hip_dummy.transform
-        self.r_hip_exp.transform = self.r_hip_dummy.transform
-        
-        self.l_hip_exp.exposeNode = self.l_hip_dummy
-        self.l_hip_exp.localReferenceNode = self.l_hip_target_dummy
-        self.l_hip_exp.useParent = False
-        
-        self.r_hip_exp.exposeNode = self.r_hip_dummy
-        self.r_hip_exp.localReferenceNode = self.r_hip_target_dummy
-        self.r_hip_exp.useParent = False
-        
-        self.bone_array = []
-        
-        # 왼쪽 Hip 본 생성
-        l_hip_bone = self.bone.create_simple_bone(
-            (self.bone_size * 2),
-            self.name.combine(
-                in_base=self.base_name,
-                in_side=self.name.get_leftStr(),
-                in_real_name="Hip",
-                in_fil_char=self.filtering_char
-            ),
-            size=self.bone_size
-        )
-        
-        l_hip_bone[0].transform = self.l_thigh.transform
-        self.anim.rotate_local(
-            l_hip_bone[0], 
-            (self.rot_dir[0] * 0), 
-            (self.rot_dir[1] * 0), 
-            (self.rot_dir[2] * 90)
-        )
-        l_hip_bone[0].parent = self.l_hip_dummy
-        self.bone_array.append(l_hip_bone[0])
-        self.bone_array.append(l_hip_bone[1])
-        
-        # 오른쪽 Hip 본 생성
-        r_hip_bone = self.bone.create_simple_bone(
-            (self.bone_size * 2),
-            self.name.combine(
-                in_base=self.base_name,
-                in_side=self.name.get_rightStr(),
-                in_real_name="Hip",
-                in_fil_char=self.filtering_char
-            ),
-            size=self.bone_size
-        )
-        
-        r_hip_bone[0].transform = self.r_thigh.transform
-        self.anim.rotate_local(
-            r_hip_bone[0], 
-            (self.rot_dir[0] * 0), 
-            (self.rot_dir[1] * 0), 
-            (self.rot_dir[2] * 90)
-        )
-        r_hip_bone[0].parent = self.r_hip_dummy
-        self.bone_array.append(r_hip_bone[0])
-        self.bone_array.append(r_hip_bone[1])
-        
-        # 위치 스크립트 설정
-        self.assign_position_script(l_hip_bone[0], self.l_hip_exp, in_scale=str(self.x_axis_offset))
-        self.assign_position_script(r_hip_bone[0], self.r_hip_exp, in_scale=str(self.x_axis_offset))
-    
-    def del_all(self):
-        """
-        모든 생성된 본과 헬퍼 객체 삭제
-        """
-        self.bone.delete_bones_safely(self.bone_array)
-        self.bone.delete_bones_safely(self.helper_array)
-    
-    def set_weight(self, in_pelvis_weight, in_thigh_weight):
-        """
-        골반과 허벅지 가중치 설정
-        
-        Args:
-            in_pelvis_weight: 골반 가중치
-            in_thigh_weight: 허벅지 가중치
-        """
-        self.del_all()
-        self.pelvis_weight = in_pelvis_weight
-        self.thigh_weight = in_thigh_weight
-        
-        self.create()
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+
+"""
+Hip 모듈 - 3ds Max용 Hip 관련 기능 제공
+원본 MAXScript의 hip.ms를 Python으로 변환하였으며, pymxs 모듈 기반으로 구현됨
+"""
+
+from pymxs import runtime as rt
+
+# Import necessary service classes for default initialization
+from .name import Name
+from .anim import Anim
+from .helper import Helper
+from .bone import Bone
+from .constraint import Constraint
+
+from .boneChain import BoneChain
+
+
+class Hip:
+    """
+    Hip 관련 기능을 제공하는 클래스.
+    MAXScript의 _Hip 구조체 개념을 Python으로 재구현한 클래스이며,
+    3ds Max의 기능들을 pymxs API를 통해 제어합니다.
+    """
+    
+    def __init__(self, nameService=None, animService=None, helperService=None, boneService=None, constraintService=None):
+        """
+        클래스 초기화.
+        
+        Args:
+            nameService: 이름 처리 서비스 (제공되지 않으면 새로 생성)
+            animService: 애니메이션 서비스 (제공되지 않으면 새로 생성)
+            helperService: 헬퍼 객체 관련 서비스 (제공되지 않으면 새로 생성)
+            boneService: 뼈대 관련 서비스 (제공되지 않으면 새로 생성)
+            constraintService: 제약 관련 서비스 (제공되지 않으면 새로 생성)
+            bipService: Biped 관련 서비스 (제공되지 않으면 새로 생성)
+        """
+        # 서비스 인스턴스 설정 또는 생성
+        self.name = nameService if nameService else Name()
+        self.anim = animService if animService else Anim()
+        
+        # 종속성이 있는 서비스들은 이미 생성된 서비스들을 전달
+        self.helper = helperService if helperService else Helper(nameService=self.name)
+        self.const = constraintService if constraintService else Constraint(nameService=self.name, helperService=self.helper)
+        self.bone = boneService if boneService else Bone(nameService=self.name, animService=self.anim, helperService=self.helper, constraintService=self.const)
+        
+        # 기본 속성 초기화
+        self.pelvisWeight = 0.4
+        self.thighWeight = 0.6
+        self.pushAmount = 20
+        
+        self.pelvis = None
+        self.thigh = None
+        self.thighTwist = None
+        self.calf = None
+        
+        self.pelvisHelper = None
+        self.thighHelper = None
+        self.thighTwistHelper = None
+        self.thighRotHelper = None
+        self.thighPosHelper = None
+        self.thighRotRootHelper = None
+        
+        self.helpers = []
+        self.bones = []
+        
+        self.posScriptExpression = (
+            "localLimbTm = limb.transform * inverse limbParent.transform\n"
+            "localDeltaTm = localLimbTm * inverse localRotRefTm\n"
+            "\n"
+            "q = localDeltaTm.rotation\n"
+            "\n"
+            "eulerRot = (quatToEuler q order:5)\n"
+            "swizzledRot = (eulerAngles eulerRot.y eulerRot.z eulerRot.x)\n"
+            "\n"
+            "axis = [0,0,1]\n"
+            "\n"
+            "saturatedTwistZ = (swizzledRot.x*axis.x + swizzledRot.y*axis.y + swizzledRot.z*axis.z)/180.0\n"
+            "pushScaleY = (amax 0.0 saturatedTwistZ) * 0.5\n"
+            "\n"
+            "axis = [0,1,0]\n"
+            "saturatedTwistY = (swizzledRot.x*axis.x + swizzledRot.y*axis.y + swizzledRot.z*axis.z)/180.0\n"
+            "pushScaleZ = amax 0.0 saturatedTwistY\n"
+            "\n"
+            "\n"
+            "[0, pushAmount * pushScaleY, -pushAmount * pushScaleZ]\n"
+        )
+        
+    def reset(self):
+        """
+        클래스의 주요 컴포넌트들을 초기화합니다.
+        서비스가 아닌 클래스 자체의 작업 데이터를 초기화하는 함수입니다.
+        
+        Returns:
+            self: 메소드 체이닝을 위한 자기 자신 반환
+        """
+        self.pelvisWeight = 0.4
+        self.thighWeight = 0.6
+        self.pushAmount = 20
+        
+        self.pelvis = None
+        self.thigh = None
+        self.thighTwist = None
+        self.calf = None
+        
+        self.pelvisHelper = None
+        self.thighHelper = None
+        self.thighTwistHelper = None
+        self.thighRotHelper = None
+        self.thighPosHelper = None
+        self.thighRotRootHelper = None
+        
+        self.helpers = []
+        self.bones = []
+        
+        return self
+    
+    def create_helper(self, inPelvis, inThigh, inThighTwist):
+        if not rt.isValidNode(inPelvis) or not rt.isValidNode(inThigh) or not rt.isValidNode(inThighTwist):
+            return False
+        
+        self.pelvis = inPelvis
+        self.thigh = inThigh
+        self.thighTwist = inThighTwist
+        
+        filteringChar = self.name._get_filtering_char(inThigh.name)
+        isLower = inThigh.name[0].islower()
+        
+        pelvisHelperName = self.name.replace_name_part("RealName", inThigh.name, self.name.get_RealName(inPelvis.name)+filteringChar+"Hip")
+        pelvisHelperName = self.name.replace_name_part("Type", pelvisHelperName, self.name.get_name_part_value_by_description("Type", "Dummy"))
+        pelvisHelper = self.helper.create_point(pelvisHelperName)
+        rt.setProperty(pelvisHelper, "transform", inThigh.transform)
+        pelvisHelper.parent = inPelvis
+        
+        tihgTwistHeleprName = self.name.replace_name_part("RealName", inThigh.name, self.name.get_RealName(inThighTwist.name)+filteringChar+"Hip")
+        tihgTwistHeleprName = self.name.replace_name_part("Type", tihgTwistHeleprName, self.name.get_name_part_value_by_description("Type", "Dummy"))
+        thighTwistHelper = self.helper.create_point(tihgTwistHeleprName)
+        rt.setProperty(thighTwistHelper, "transform", inThighTwist.transform)
+        thighTwistHelper.parent = inThighTwist
+        
+        tihghRotHelperName = self.name.replace_name_part("RealName", inThigh.name, self.name.get_RealName(inThigh.name)+filteringChar+"Hip")
+        tihghRotHelperName = self.name.replace_name_part("Type", tihghRotHelperName, self.name.get_name_part_value_by_description("Type", "Rotation"))
+        thighRotHelper = self.helper.create_point(tihghRotHelperName)
+        rt.setProperty(thighRotHelper, "transform", inThighTwist.transform)
+        thighRotHelper.parent = inThigh
+        
+        thighPosHelperName = self.name.replace_name_part("RealName", inThigh.name, self.name.get_RealName(inThigh.name)+filteringChar+"Hip")
+        thighPosHelperName = self.name.replace_name_part("Type", thighPosHelperName, self.name.get_name_part_value_by_description("Type", "Position"))
+        thighPosHelper = self.helper.create_point(thighPosHelperName)
+        rt.setProperty(thighPosHelper, "transform", inThighTwist.transform)
+        thighPosHelper.parent = thighRotHelper
+        
+        thighRotRootHelperName = self.name.replace_name_part("RealName", inThigh.name, self.name.get_RealName(inThigh.name)+filteringChar+"Hip")
+        thighRotRootHelperName = self.name.replace_name_part("Type", thighRotRootHelperName, self.name.get_name_part_value_by_description("Type", "Dummy"))
+        thighRotRootHelper = self.helper.create_point(thighRotRootHelperName)
+        rt.setProperty(thighRotRootHelper, "transform", thighRotHelper.transform)
+        thighRotRootHelper.parent = inThighTwist
+        
+        if isLower:
+            pelvisHelper.name = pelvisHelper.name.lower()
+            thighTwistHelper.name = thighTwistHelper.name.lower()
+            thighRotHelper.name = thighRotHelper.name.lower()
+            thighPosHelper.name = thighPosHelper.name.lower()
+            thighRotRootHelper.name = thighRotRootHelper.name.lower()
+            
+        self.pelvisHelper = pelvisHelper
+        self.thighTwistHelper = thighTwistHelper
+        self.thighRotHelper = thighRotHelper
+        self.thighPosHelper = thighPosHelper
+        self.thighRotRootHelper = thighRotRootHelper
+        
+        self.helpers.append(pelvisHelper)
+        self.helpers.append(thighTwistHelper)
+        self.helpers.append(thighRotHelper)
+        self.helpers.append(thighPosHelper)
+        self.helpers.append(thighRotRootHelper)
+    
+    def assing_constraint(self, inCalf, inPelvisWeight=0.6, inThighWeight=0.4, inPushAmount=5.0):
+        self.calf = inCalf
+        self.pelvisWeight = inPelvisWeight
+        self.thighWeight = inThighWeight
+        self.pushAmount = rt.Float(inPushAmount)
+        
+        facingDirVec = self.calf.transform.position - self.thigh.transform.position
+        inObjXAxisVec = self.thigh.objectTransform.row1
+        distanceDir = -1.0 if rt.dot(inObjXAxisVec, facingDirVec) > 0 else 1.0
+        
+        rotConst = self.const.assign_rot_const_multi(self.thighRotHelper, [self.pelvisHelper, self.thighTwistHelper])
+        rotConst.setWeight(1, self.pelvisWeight * 100.0)
+        rotConst.setWeight(2, self.thighWeight * 100.0)
+        
+        localRotRefTm = self.thighRotHelper.transform * rt.inverse(self.thighRotRootHelper.transform)
+        posConst = self.const.assign_pos_script_controller(self.thighPosHelper)
+        posConst.addNode("limb", self.thighRotHelper)
+        posConst.addNode("limbParent", self.thighRotRootHelper)
+        posConst.addConstant("localRotRefTm", localRotRefTm)
+        posConst.addConstant("pushAmount", self.pushAmount*distanceDir)
+        posConst.setExpression(self.posScriptExpression)
+        posConst.update()
+        
+    def create_bone(self, inPelvis, inThigh, inThighTwist, inCalf, pushAmount=5.0, inPelvisWeight=0.6, inThighWeight=0.4):
+        if not rt.isValidNode(inPelvis) or not rt.isValidNode(inThigh) or not rt.isValidNode(inThighTwist):
+            return False
+        
+        self.create_helper(inPelvis, inThigh, inThighTwist)
+        self.assing_constraint(inCalf, inPelvisWeight, inThighWeight, inPushAmount=pushAmount)
+        
+        isLower = inThigh.name[0].islower()
+        hipBoneName = self.name.replace_name_part("RealName", inThigh.name, "Hip")
+        hipBone = self.bone.create_nub_bone(hipBoneName, 2)
+        hipBone.name = self.name.remove_name_part("Nub", hipBone.name)
+        if isLower:
+            hipBone.name = hipBone.name.lower()
+        
+        rt.setProperty(hipBone, "transform", inThighTwist.transform)
+        hipBone.parent = inThigh
+        
+        self.const.assign_rot_const(hipBone, self.thighRotHelper)
+        self.const.assign_pos_const(hipBone, self.thighPosHelper)
+        
+        self.bones.append(hipBone)
+        
+        # 결과를 딕셔너리 형태로 준비
+        result = {
+            "Bones": self.bones,
+            "Helpers": self.helpers,
+            "SourceBones": [inPelvis, inThigh, inThighTwist, inCalf],
+            "Parameters": [pushAmount, inPelvisWeight, inThighWeight]
+        }
+        
+        # 메소드 호출 후 데이터 초기화
+        self.reset()
+        
+        return BoneChain.from_result(result)
+    
+    def create_bones_from_chain(self, inBoneChain: BoneChain):
+        """
+        기존 BoneChain 객체에서 Hip 본을 생성합니다.
+        기존 설정을 복원하거나 저장된 데이터에서 Hip 셋업을 재생성할 때 사용합니다.
+        
+        Args:
+            inBoneChain (BoneChain): Hip 정보를 포함한 BoneChain 객체
+        
+        Returns:
+            BoneChain: 업데이트된 BoneChain 객체 또는 실패 시 None
+        """
+        if not inBoneChain or inBoneChain.is_empty():
+            return None
+            
+        # 기존 객체 삭제
+        inBoneChain.delete()
+            
+        # BoneChain에서 필요한 정보 추출
+        sourceBones = inBoneChain.sourceBones
+        parameters = inBoneChain.parameters
+        
+        # 필수 소스 본 확인
+        if len(sourceBones) < 4 or not all(rt.isValidNode(bone) for bone in sourceBones[:4]):
+            return None
+            
+        # 파라미터 가져오기 (또는 기본값 사용)
+        pushAmount = parameters[0] if len(parameters) > 0 else 5.0
+        pelvisWeight = parameters[1] if len(parameters) > 1 else 0.6
+        thighWeight = parameters[2] if len(parameters) > 2 else 0.4
+        
+        # Hip 생성
+        inPelvis = sourceBones[0]
+        inThigh = sourceBones[1]
+        inThighTwist = sourceBones[2]
+        inCalf = sourceBones[3]
+        
+        # 새로운 Hip 생성
+        return self.create_bone(inPelvis, inThigh, inThighTwist, inCalf, pushAmount, pelvisWeight, thighWeight)
+