pyjallib 0.1.8__py3-none-any.whl → 0.1.10__py3-none-any.whl

pyjallib/max/groinBone.py

@@ -10,11 +10,9 @@ from pymxs import runtime as rt
 # Import necessary service classes for default initialization
 from .name import Name
 from .anim import Anim
-from .constraint import Constraint
-from .bip import Bip
-from .bone import Bone
 from .helper import Helper
-from .twistBone import TwistBone
+from .bone import Bone
+from .constraint import Constraint
 
 class GroinBone:
     """
@@ -22,69 +20,141 @@ class GroinBone:
     3DS Max에서 고간 부 본을 생성하고 관리하는 기능을 제공합니다.
     """
     
-    def __init__(self, nameService=None, animService=None, helperService=None, constService=None, bipService=None, boneService=None, twistBoneService=None):
+    def __init__(self, nameService=None, animService=None, constraintService=None, boneService=None, helperService=None):
         """
         클래스 초기화.
         
         Args:
             nameService: 이름 처리 서비스 (제공되지 않으면 새로 생성)
             animService: 애니메이션 서비스 (제공되지 않으면 새로 생성)
-            constService: 제약 서비스 (제공되지 않으면 새로 생성)
-            bipService: 바이페드 서비스 (제공되지 않으면 새로 생성)
+            constraintService: 제약 서비스 (제공되지 않으면 새로 생성)
+            bipService: Biped 서비스 (제공되지 않으면 새로 생성)
+            boneService: 뼈대 서비스 (제공되지 않으면 새로 생성)
+            twistBoneService: 트위스트 본 서비스 (제공되지 않으면 새로 생성)
+            helperService: 헬퍼 객체 서비스 (제공되지 않으면 새로 생성)
         """
+        # 서비스 인스턴스 설정 또는 생성
         self.name = nameService if nameService else Name()
         self.anim = animService if animService else Anim()
-        # Ensure dependent services use the potentially newly created instances
-        self.const = constService if constService else Constraint(nameService=self.name)
-        self.bip = bipService if bipService else Bip(animService=self.anim, nameService=self.name)
+        
+        # 종속성이 있는 서비스들은 이미 생성된 서비스들을 전달
+        self.const = constraintService if constraintService else Constraint(nameService=self.name)
         self.bone = boneService if boneService else Bone(nameService=self.name, animService=self.anim)
-        self.twistBone = twistBoneService if twistBoneService else TwistBone(nameService=self.name, animService=self.anim, constService=self.const, bipService=self.bip, boneService=self.bone)
         self.helper = helperService if helperService else Helper(nameService=self.name)
+        
+        # 초기화된 결과를 저장할 변수들
+        self.pelvis = None
+        self.lThighTwist = None
+        self.rThighTwist = None
+        self.bones = []
+        self.helpers = []
+        self.pelvisWeight = 40.0
+        self.thighWeight = 60.0
     
-    def create_bone(self, inObj):
+    def reset(self):
+        """
+        클래스의 주요 컴포넌트들을 초기화합니다.
+        서비스가 아닌 클래스 자체의 작업 데이터를 초기화하는 함수입니다.
+        
+        Returns:
+            self: 메소드 체이닝을 위한 자기 자신 반환
+        """
+        self.pelvis = None
+        self.lThighTwist = None
+        self.rThighTwist = None
+        self.bones = []
+        self.helpers = []
+        self.pelvisWeight = 40.0
+        self.thighWeight = 60.0
+        
+        return self
+    
+    def create_bone(self, inPelvis, inLThighTwist, inRThighTwist, inPelvisWeight=40.0, inThighWeight=60.0):
         """
         고간 부 본을 생성하는 메소드.
         
         Args:
-            name: 생성할 본의 이름
-            parent: 부모 본 (제공되지 않으면 None)
+            inPelvis: Biped 객체
+            inPelvisWeight: 골반 가중치 (기본값: 40.0)
+            inThighWeight: 허벅지 가중치 (기본값: 60.0)
         
         Returns:
-            생성된 본 객체
+            성공 여부 (Boolean)
         """
-        if self.bip.is_biped_object(inObj) == False:
-            rt.messageBox("This is not a biped object.")
+        returnVal = {
+            "Pelvis": None,
+            "LThighTwist": None,
+            "RThighTwist": None,
+            "Bones": [],
+            "Helpers": [],
+            "PelvisWeight": inPelvisWeight,
+            "ThighWeight": inThighWeight
+        }
+        if rt.isValidNode(inPelvis) == False or rt.isValidNode(inLThighTwist) == False or rt.isValidNode(inRThighTwist) == False:
+            rt.messageBox("There is no valid node.")
             return False
         
-        bipObj = self.bip.get_com(inObj)
+        groinName = "Groin"
+        if inPelvis.name[0].islower():
+            groinName = groinName.lower()
         
-        lThigh = self.bip.get_grouped_nodes(inObj, "lLeg")[0]
-        rThigh = self.bip.get_grouped_nodes(inObj, "rLeg")[0]
-        pelvis = self.bip.get_grouped_nodes(inObj, "pelvis")[0]
+        groinBaseName = self.name.replace_name_part("RealName", inPelvis.name, groinBaseName)
         
-        lThighTwists = self.twistBone.get_thigh_type(lThigh)
-        rThighTwists = self.twistBone.get_thigh_type(rThigh)
+        pelvisHelperName = self.name.replace_name_part("Type", groinBaseName, self.name.get_name_part_value_by_description("Type", "Dummy"))
+        pelvisHelperName = self.name.replace_name_part("Index", pelvisHelperName, "00")
+        pelvisHelper = self.helper.create_point(pelvisHelperName)
+        pelvisHelper.transform = inPelvis.transform
+        self.anim.rotate_local(pelvisHelper, 0.0, 0.0, -180.0)
+        pelvisHelper.parent = inPelvis
+        self.helper.set_shape_to_box(pelvisHelper)
         
-        if len(lThighTwists) == 0 or len(rThighTwists) == 0:
-            rt.messageBox("There is no twist bone.")
-            return False
+        lThighTwistHelperName = self.name.replace_name_part("Type", groinBaseName, self.name.get_name_part_value_by_description("Type", "Dummy"))
+        lThighTwistHelperName = self.name.replace_name_part("Side", lThighTwistHelperName, self.name.get_name_part_value_by_description("Side", "Left"))
+        lThighTwistHelperName = self.name.replace_name_part("Index", lThighTwistHelperName, "00")
+        lThighTwistHelper = self.helper.create_point(lThighTwistHelperName)
+        lThighTwistHelper.transform = pelvisHelper.transform
+        lThighTwistHelper.position = inLThighTwist.position
+        lThighTwistHelper.parent = inLThighTwist
+        self.helper.set_shape_to_box(lThighTwistHelper)
         
-        pelvisHelper = self.helper.create_point(bipObj.name + " Dum Groin 00")
-        pelvisHelper.transform = bipObj.transform
-        self.anim.rotate_local(pelvisHelper, 90, 0, 0)
-        self.anim.rotate_local(pelvisHelper, 0, 0, -90)
-        pelvisHelper.parent = pelvis
-        self.helper.set_shape_to_box(pelvisHelper)
+        rThighTwistHelperName = self.name.replace_name_part("Type", groinBaseName, self.name.get_name_part_value_by_description("Type", "Dummy"))
+        rThighTwistHelperName = self.name.replace_name_part("Side", rThighTwistHelperName, self.name.get_name_part_value_by_description("Side", "Right"))
+        rThighTwistHelperName = self.name.replace_name_part("Index", rThighTwistHelperName, "00")
+        rThighTwistHelper = self.helper.create_point(rThighTwistHelperName)
+        rThighTwistHelper.transform = pelvisHelper.transform
+        rThighTwistHelper.position = inRThighTwist.position
+        rThighTwistHelper.parent = inRThighTwist
+        self.helper.set_shape_to_box(rThighTwistHelper)
         
-        groinBones = self.bone.create_simple_bone(3.0, bipObj.name +" Groin 00", size=2)
+        groinBoneName = self.name.replace_name_part("Index", groinBaseName, "00")
+        groinBones = self.bone.create_simple_bone(3.0, groinBoneName, size=2)
         groinBones[0].transform = pelvisHelper.transform
-        groinBones[0].parent = pelvis
+        groinBones[0].parent = inPelvis
         
-        self.const.assign_rot_const_multi(groinBones[0], [pelvisHelper, lThigh, rThigh])
+        self.const.assign_rot_const_multi(groinBones[0], [pelvisHelper, lThighTwistHelper, rThighTwistHelper])
         rotConst = self.const.get_rot_list_controller(groinBones[0])[1]
-        rotConst.setWeight(1, 40.0)
-        rotConst.setWeight(2, 30.0)
-        rotConst.setWeight(3, 30.0)
+        rotConst.setWeight(1, inPelvisWeight)
+        rotConst.setWeight(2, inThighWeight/2.0)
+        rotConst.setWeight(3, inThighWeight/2.0)
+        
+        # 결과를 멤버 변수에 저장
+        self.pelvis = inPelvis
+        self.lThighTwist = inLThighTwist
+        self.rThighTwist = inRThighTwist
+        self.bones = groinBones
+        self.helpers = [pelvisHelper, lThighTwistHelper, rThighTwistHelper]
+        self.pelvisWeight = inPelvisWeight
+        self.thighWeight = inThighWeight
+        
+        returnVal["Pelvis"] = inPelvis
+        returnVal["LThighTwist"] = inLThighTwist
+        returnVal["RThighTwist"] = inRThighTwist
+        returnVal["Bones"] = groinBones
+        returnVal["Helpers"] = [pelvisHelper, lThighTwistHelper, rThighTwistHelper]
+        returnVal["PelvisWeight"] = inPelvisWeight
+        returnVal["ThighWeight"] = inThighWeight
         
+        # 메소드 호출 후 데이터 초기화
+        self.reset()
         
-        
+        return returnVal

pyjallib/max/groinBoneChain.py

@@ -0,0 +1,173 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+
+"""
+고간 부 본 체인(Groin Bone Chain) 관련 기능을 제공하는 클래스.
+GroinBone 클래스가 생성한 고간 부 본들과 헬퍼들을 관리하고 접근하는 인터페이스를 제공합니다.
+
+Examples:
+    # GroinBone 클래스로 고간 본 생성 후 체인으로 관리하기
+    groin_bone = GroinBone()
+    biped_obj = rt.selection[0]  # 선택된 바이패드 객체
+    
+    # 고간 본 생성
+    success = groin_bone.create_bone(biped_obj, 40.0, 60.0)
+    if success:
+        # 생성된 본과 헬퍼로 체인 생성
+        chain = GroinBoneChain.from_groin_bone_result(
+            groin_bone.genBones, 
+            groin_bone.genHelpers,
+            biped_obj,
+            40.0,
+            60.0
+        )
+        
+        # 체인 가중치 업데이트
+        chain.update_weights(35.0, 65.0)
+        
+        # 본과 헬퍼 이름 변경
+        chain.rename_bones(prefix="Character_", suffix="_Groin")
+        chain.rename_helpers(prefix="Character_", suffix="_Helper")
+        
+        # 현재 가중치 값 확인
+        pelvis_w, thigh_w = chain.get_weights()
+        print(f"Current weights: Pelvis={pelvis_w}, Thigh={thigh_w}")
+        
+        # 체인 삭제
+        # chain.delete_all()
+"""
+
+from pymxs import runtime as rt
+from pyjallib.max.header import get_pyjallibmaxheader
+jal = get_pyjallibmaxheader()
+
+class GroinBoneChain:
+    def __init__(self, inResult):
+        """
+        클래스 초기화.
+        
+        Args:
+            bones: 고간 부 본 체인을 구성하는 뼈대 배열 (기본값: None)
+            helpers: 고간 부 본과 연관된 헬퍼 객체 배열 (기본값: None)
+            biped_obj: 연관된 Biped 객체 (기본값: None)
+        """
+        self.pelvis =inResult["Pelvis"]
+        self.lThighTwist = inResult["LThighTwist"]
+        self.rThighTwist = inResult["RThighTwist"]
+        self.bones = inResult["Bones"]
+        self.helpers = inResult["Helpers"]
+        self.pelvisWeight = inResult["PelvisWeight"]
+        self.thighWeight = inResult["ThighWeight"]
+    
+    def is_empty(self):
+        """
+        체인이 비어있는지 확인
+        
+        Returns:
+            본과 헬퍼가 모두 비어있으면 True, 아니면 False
+        """
+        return len(self.bones) == 0 and len(self.helpers) == 0
+    
+    def clear(self):
+        """체인의 모든 본과 헬퍼 참조 제거"""
+        self.bones = []
+        self.helpers = []
+        self.pelvis = None
+        self.lThighTwist = None
+        self.rThighTwist = None
+        self.pelvisWeight = 40.0  # 기본 골반 가중치
+        self.thighWeight = 60.0   # 기본 허벅지 가중치
+        
+    def delete(self):
+        """
+        체인의 모든 본과 헬퍼를 3ds Max 씬에서 삭제
+        
+        Returns:
+            삭제 성공 여부 (boolean)
+        """
+        if self.is_empty():
+            return False
+            
+        try:
+            rt.delete(self.bones)
+            rt.delete(self.helpers)
+            return True
+        except:
+            return False
+    
+    def delete_all(self):
+        """
+        체인의 모든 본과 헬퍼를 3ds Max 씬에서 삭제
+        
+        Returns:
+            삭제 성공 여부 (boolean)
+        """
+        if self.is_empty():
+            return False
+            
+        try:
+            rt.delete(self.bones)
+            rt.delete(self.helpers)
+            self.clear()
+            return True
+        except:
+            return False
+    
+    def update_weights(self, pelvisWeight=None, thighWeight=None):
+        """
+        고간 부 본의 가중치 업데이트
+        
+        Args:
+            pelvisWeight: 골반 가중치 (None인 경우 현재 값 유지)
+            thighWeight: 허벅지 가중치 (None인 경우 현재 값 유지)
+            
+        Returns:
+            업데이트 성공 여부 (boolean)
+        """
+        if self.is_empty():
+            return False
+            
+        # 새 가중치 설정
+        if pelvisWeight is not None:
+            self.pelvisWeight = pelvisWeight
+        if thighWeight is not None:
+            self.thighWeight = thighWeight
+        
+        self.delete()
+        result = jal.groinBone.create_bone(
+            self.pelvis, 
+            self.lThighTwist, 
+            self.rThighTwist, 
+            self.pelvisWeight, 
+            self.thighWeight
+        )
+        self.bones = result["Bones"]
+        self.helpers = result["Helpers"]
+            
+    def get_weights(self):
+        """
+        현재 설정된 가중치 값 가져오기
+        
+        Returns:
+            (pelvis_weight, thigh_weight) 형태의 튜플
+        """
+        return (self.pelvis_weight, self.thigh_weight)
+    
+    @classmethod
+    def from_groin_bone_result(cls, inResult):
+        """
+        GroinBone 클래스의 결과로부터 GroinBoneChain 인스턴스 생성
+        
+        Args:
+            bones: GroinBone 클래스가 생성한 뼈대 배열
+            helpers: GroinBone 클래스가 생성한 헬퍼 배열
+            biped_obj: 연관된 Biped 객체 (기본값: None)
+            pelvisWeight: 골반 가중치 (기본값: 40.0)
+            thighWeight: 허벅지 가중치 (기본값: 60.0)
+            
+        Returns:
+            GroinBoneChain 인스턴스
+        """
+        chain = cls(inResult)
+        
+        return chain

pyjallib/max/header.py

@@ -25,9 +25,11 @@ from .bip import Bip
 from .skin import Skin
 
 from .twistBone import TwistBone
-from .groinBone import GroinBone
 from .autoClavicle import AutoClavicle
-from .volumePreserveBone import VolumePreserveBone
+from .groinBone import GroinBone
+from .volumeBone import VolumeBone
+from .kneeBone import KneeBone
+from .hip import Hip
 
 from .morph import Morph
 
@@ -68,14 +70,46 @@ class Header:
         self.bip = Bip(animService=self.anim, nameService=self.name, boneService=self.bone)
         self.skin = Skin()
 
-        self.twistBone = TwistBone(nameService=self.name, animService=self.anim, constService=self.constraint, bipService=self.bip, boneService=self.bone)
-        self.groinBone = GroinBone(nameService=self.name, animService=self.anim, helperService=self.helper, constService=self.constraint, bipService=self.bip, boneService=self.bone, twistBoneService=self.twistBone)
+        self.twistBone = TwistBone(nameService=self.name, animService=self.anim, constraintService=self.constraint, bipService=self.bip, boneService=self.bone)
+        self.groinBone = GroinBone(nameService=self.name, animService=self.anim, constraintService=self.constraint, boneService=self.bone, helperService=self.helper)
         self.autoClavicle = AutoClavicle(nameService=self.name, animService=self.anim, helperService=self.helper, boneService=self.bone, constraintService=self.constraint, bipService=self.bip)
-        self.volumePreserveBone = VolumePreserveBone(nameService=self.name, animService=self.anim, constService=self.constraint, boneService=self.bone, helperService=self.helper)
+        self.volumeBone = VolumeBone(nameService=self.name, animService=self.anim, constraintService=self.constraint, boneService=self.bone, helperService=self.helper)
+        self.kneeBone = KneeBone(nameService=self.name, animService=self.anim, constraintService=self.constraint, boneService=self.bone, helperService=self.helper, volumeBoneService=self.volumeBone)
+        self.hip = Hip(nameService=self.name, animService=self.anim, helperService=self.helper, boneService=self.bone, constraintService=self.constraint)
         
         self.morph = Morph()
         
         self.tools = []
+    
+    def update_nameConifg(self, configPath):
+        """
+        이름 설정을 업데이트합니다.
+        
+        Args:
+            configPath: ConfigPath 인스턴스
+        """
+        self.name.load_from_config_file(configPath)
+    
+    def add_tool(self, tool):
+        """
+        도구를 추가합니다.
+        
+        Args:
+            tool: 추가할 도구
+        """
+        if tool in self.tools:
+            self.tools.remove(tool)
+        
+        self.tools.append(tool)
 
 # 모듈 레벨에서 전역 인스턴스 생성
-jal = Header.get_instance()
+_pyjallibmaxheader = Header.get_instance()
+
+def get_pyjallibmaxheader():
+    """
+    jal 인스턴스를 반환합니다.
+    
+    Returns:
+        Header 인스턴스
+    """
+    return _pyjallibmaxheader

pyjallib/max/helper.py

@@ -93,30 +93,12 @@ class Helper:
             찾은 Type namePart 값
         """
         typePart = self.name.get_name_part("Type")
-        predefinedValues = typePart.get_predefined_values()
         firstTypeValue = typePart.get_value_by_min_weight()
         
+        helperTypeName = self.name.get_name_part_value_by_description("Type", helperType)
+        if helperTypeName != "":
+            return helperTypeName
         
-        # 헬퍼 타입 패턴 정의
-        helperNamePatterns = {
-            "Dummy": ["dum", "Dum", "Dummy", "Helper", "Hpr", "Dmy"],
-            "IK": ["ik", "IK", "Ik"],
-            "Target": ["Tgt", "Target", "TG", "Tg", "T"],
-            "Parent": ["Prn", "PRN", "Parent", "P"],
-            "ExposeTm": ["Exp", "Etm", "EXP", "ETM"]
-        }
-        
-        # 타입 패턴 가져오기
-        patterns = helperNamePatterns.get(helperType, [])
-        if not patterns:
-            return firstTypeValue
-        
-        # 패턴과 일치하는 값 찾기
-        for value in predefinedValues:
-            if value in patterns:
-                return value
-        
-        # 일치하는 값이 없으면 기본값 반환
         return firstTypeValue
     
     def gen_helper_name_from_obj(self, inObj, make_two=False, is_exp=False):