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

pyjallib/__init__.py

@@ -6,7 +6,7 @@ pyjallib Package
 Python library for game character development pipeline.
 """
 
-__version__ = '0.1.9'
+__version__ = '0.1.10'
 
 # reload_modules 함수를 패키지 레벨에서 사용 가능하게 함
 from .namePart import NamePart, NamePartType

pyjallib/max/ConfigFiles/Default_3DSMaxNamingConfig.json

@@ -0,0 +1,161 @@
+{
+    "paddingNum": 2,
+    "partOrder": [
+        "Base",
+        "Type",
+        "Side",
+        "FrontBack",
+        "RealName",
+        "Index",
+        "Nub"
+    ],
+    "nameParts": [
+        {
+            "name": "Base",
+            "predefinedValues": [
+                "b",
+                "Bip001"
+            ],
+            "weights": [
+                5,
+                10
+            ],
+            "type": "PREFIX",
+            "descriptions": [
+                "SkinBone",
+                "Biped"
+            ],
+            "koreanDescriptions": [
+                "",
+                ""
+            ],
+            "isDirection": false
+        },
+        {
+            "name": "Type",
+            "predefinedValues": [
+                "Dum",
+                "P",
+                "Exp",
+                "IK",
+                "T",
+                "Rot",
+                "Pos",
+                "Lat",
+                "UpN"
+            ],
+            "weights": [
+                5,
+                10,
+                15,
+                20,
+                25,
+                30,
+                35,
+                40,
+                45
+            ],
+            "type": "PREFIX",
+            "descriptions": [
+                "Dummy",
+                "Parent",
+                "ExposeTM",
+                "IK",
+                "Target",
+                "Rotation",
+                "Position",
+                "LookAt",
+                "UpNode"
+            ],
+            "koreanDescriptions": [
+                "",
+                "",
+                "",
+                "",
+                "",
+                "",
+                "",
+                "",
+                ""
+            ],
+            "isDirection": false
+        },
+        {
+            "name": "Side",
+            "predefinedValues": [
+                "L",
+                "R"
+            ],
+            "weights": [
+                5,
+                10
+            ],
+            "type": "PREFIX",
+            "descriptions": [
+                "Left",
+                "Right"
+            ],
+            "koreanDescriptions": [
+                "",
+                ""
+            ],
+            "isDirection": true
+        },
+        {
+            "name": "FrontBack",
+            "predefinedValues": [
+                "F",
+                "B"
+            ],
+            "weights": [
+                5,
+                10
+            ],
+            "type": "PREFIX",
+            "descriptions": [
+                "Front",
+                "Back"
+            ],
+            "koreanDescriptions": [
+                "",
+                ""
+            ],
+            "isDirection": true
+        },
+        {
+            "name": "RealName",
+            "predefinedValues": [],
+            "weights": [],
+            "type": "REALNAME",
+            "descriptions": [],
+            "koreanDescriptions": [],
+            "isDirection": false
+        },
+        {
+            "name": "Index",
+            "predefinedValues": [],
+            "weights": [],
+            "type": "INDEX",
+            "descriptions": [],
+            "koreanDescriptions": [],
+            "isDirection": false
+        },
+        {
+            "name": "Nub",
+            "predefinedValues": [
+                "Nub"
+            ],
+            "weights": [
+                5
+            ],
+            "type": "SUFFIX",
+            "descriptions": [
+                "Nub"
+            ],
+            "koreanDescriptions": [
+                ""
+            ],
+            "isDirection": false
+        }
+    ]
+}

pyjallib/max/__init__.py

@@ -27,9 +27,15 @@ from .skin import Skin
 from .morph import Morph
 
 from .twistBone import TwistBone
+from .twistBoneChain import TwistBoneChain
 from .groinBone import GroinBone
+from .groinBoneChain import GroinBoneChain
 from .autoClavicle import AutoClavicle
-from .volumePreserveBone import VolumePreserveBone
+from .autoClavicleChain import AutoClavicleChain
+from .volumeBone import VolumeBone
+from .volumeBoneChain import VolumeBoneChain
+from .kneeBone import KneeBone
+from .hip import Hip
 
 from .ui.Container import Container
 
@@ -50,8 +56,14 @@ __all__ = [
     'Skin',
     'Morph',
     'TwistBone',
+    'TwistBoneChain',
     'GroinBone',
+    'GroinBoneChain',
     'AutoClavicle',
-    'VolumePreserveBone',
+    'AutoClavicleChain',
+    'VolumeBone',
+    'VolumeBoneChain',
+    'KneeBone',
+    'Hip',
     'Container'
 ]

pyjallib/max/anim.py

@@ -22,7 +22,7 @@ class Anim:
         """클래스 초기화 (현재 특별한 초기화 동작은 없음)"""
         pass
     
-    def rotate_local(self, inObj, rx, ry, rz):
+    def rotate_local(self, inObj, rx, ry, rz, dontAffectChildren=False):
         """
         객체를 로컬 좌표계에서 회전시킴.
         
@@ -32,6 +32,16 @@ class Anim:
             ry    : Y축 회전 각도 (도 단위)
             rz    : Z축 회전 각도 (도 단위)
         """
+        tempParent = None
+        tempChildren = []
+        if dontAffectChildren:
+            # 자식 객체에 영향을 주지 않도록 설정
+            tempParent = inObj.parent
+            for item in inObj.children:
+                tempChildren.append(item)
+            for item in tempChildren:
+                item.parent = None
+                
         # 현재 객체의 변환 행렬을 가져옴
         currentMatrix = rt.getProperty(inObj, "transform")
         # 오일러 각도를 통해 회전 행렬(쿼터니언) 생성
@@ -41,8 +51,14 @@ class Anim:
         rt.preRotate(currentMatrix, quatRotation)
         # 변경된 행렬을 객체에 설정
         rt.setProperty(inObj, "transform", currentMatrix)
+        
+        if dontAffectChildren:
+            # 자식 객체의 부모를 원래대로 복원
+            for item in tempChildren:
+                item.parent = inObj
+            inObj.parent = tempParent
     
-    def move_local(self, inObj, mx, my, mz):
+    def move_local(self, inObj, mx, my, mz, dontAffectChildren=False):
         """
         객체를 로컬 좌표계에서 이동시킴.
         
@@ -52,14 +68,30 @@ class Anim:
             my    : Y축 이동 거리
             mz    : Z축 이동 거리
         """
+        tempParent = None
+        tempChildren = []
+        if dontAffectChildren:
+            # 자식 객체에 영향을 주지 않도록 설정
+            tempParent = inObj.parent
+            for item in inObj.children:
+                tempChildren.append(item)
+            for item in tempChildren:
+                item.parent = None
+        
         # 현재 변환 행렬 가져오기
-        currentMatrix = rt.getProperty(inObj, "transform")
+        currentMatrix = rt.getProperty(inObj, "transform", dontAffectChildren=False)
         # 이동량을 Point3 형태로 생성
         translation = rt.Point3(mx, my, mz)
         # preTranslate를 이용해 행렬에 이동 적용
         rt.preTranslate(currentMatrix, translation)
         # 적용된 이동 변환 행렬을 객체에 설정
         rt.setProperty(inObj, "transform", currentMatrix)
+        
+        if dontAffectChildren:
+            # 자식 객체의 부모를 원래대로 복원
+            for item in tempChildren:
+                item.parent = inObj
+            inObj.parent = tempParent
     
     def reset_transform_controller(self, inObj):
         """
@@ -549,22 +581,18 @@ class Anim:
         매개변수:
             inObj : 변환 값을 저장할 객체
         """
-        try:
-            # 월드 스페이스 행렬 저장
-            transformString = str(inObj.transform)
-            rt.setUserProp(inObj, rt.Name("WorldSpaceMatrix"), transformString)
-            
-            # 부모가 존재하면 부모 스페이스 행렬도 저장
-            parent = inObj.parent
-            if parent is not None:
-                parentTransform = parent.transform
-                inverseParent = rt.inverse(parentTransform)
-                objTransform = inObj.transform
-                parentSpaceMatrix = objTransform * inverseParent
-                rt.setUserProp(inObj, rt.Name("ParentSpaceMatrix"), str(parentSpaceMatrix))
-        except:
-            # 오류 발생 시 예외 무시
-            pass
+        # 월드 스페이스 행렬 저장
+        transformString = str(inObj.transform)
+        rt.setUserProp(inObj, rt.Name("WorldSpaceMatrix"), transformString)
+        
+        # 부모가 존재하면 부모 스페이스 행렬도 저장
+        parent = inObj.parent
+        if parent is not None:
+            parentTransform = parent.transform
+            inverseParent = rt.inverse(parentTransform)
+            objTransform = inObj.transform
+            parentSpaceMatrix = objTransform * inverseParent
+            rt.setUserProp(inObj, rt.Name("ParentSpaceMatrix"), str(parentSpaceMatrix))
     
     def set_xform(self, inObj, space="World"):
         """
@@ -574,21 +602,17 @@ class Anim:
             inObj : 변환 값을 적용할 객체
             space : "World" 또는 "Parent" (적용할 변환 공간)
         """
-        try:
-            if space == "World":
-                # 월드 스페이스 행렬 적용
-                matrixString = rt.getUserProp(inObj, rt.Name("WorldSpaceMatrix"))
-                transformMatrix = rt.execute(matrixString)
+        if space == "World":
+            # 월드 스페이스 행렬 적용
+            matrixString = rt.getUserProp(inObj, rt.Name("WorldSpaceMatrix"))
+            transformMatrix = rt.execute(matrixString)
+            rt.setProperty(inObj, "transform", transformMatrix)
+        elif space == "Parent":
+            # 부모 스페이스 행렬 적용
+            parent = inObj.parent
+            matrixString = rt.getUserProp(inObj, rt.Name("ParentSpaceMatrix"))
+            parentSpaceMatrix = rt.execute(matrixString)
+            if parent is not None:
+                parentTransform = parent.transform
+                transformMatrix = parentSpaceMatrix * parentTransform
                 rt.setProperty(inObj, "transform", transformMatrix)
-            elif space == "Parent":
-                # 부모 스페이스 행렬 적용
-                parent = inObj.parent
-                matrixString = rt.getUserProp(inObj, rt.Name("ParentSpaceMatrix"))
-                parentSpaceMatrix = rt.execute(matrixString)
-                if parent is not None:
-                    parentTransform = parent.transform
-                    transformMatrix = parentSpaceMatrix * parentTransform
-                    rt.setProperty(inObj, "transform", transformMatrix)
-        except:
-            # 오류 발생 시 예외 무시
-            pass

pyjallib/max/autoClavicle.py

@@ -8,7 +8,13 @@
 
 from pymxs import runtime as rt
 
-from .header import jal
+# 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 .bip import Bip
 
 
 class AutoClavicle:
@@ -18,7 +24,7 @@ class AutoClavicle:
     3ds Max의 기능들을 pymxs API를 통해 제어합니다.
     """
     
-    def __init__(self):
+    def __init__(self, nameService=None, animService=None, helperService=None, boneService=None, constraintService=None, bipService=None):
         """
         클래스 초기화
         
@@ -30,19 +36,39 @@ class AutoClavicle:
             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.name = nameService if nameService else Name()
+        self.anim = animService if animService else Anim()
+        # 종속성이 있는 서비스들은 이미 생성된 서비스들을 전달
+        self.helper = helperService if helperService else Helper(nameService=self.name)
+        self.bone = boneService if boneService else Bone(nameService=self.name, animService=self.anim)
+        self.const = constraintService if constraintService else Constraint(nameService=self.name)
+        self.bip = bipService if bipService else Bip(nameService=self.name, animService=self.anim)
         
         self.boneSize = 2.0
+        
+        # 초기화된 결과를 저장할 변수들
+        self.genBones = []
+        self.genHelpers = []
         self.clavicle = None
         self.upperArm = None
         self.liftScale = 0.8
+        
+    def reset(self):
+        """
+        클래스의 주요 컴포넌트들을 초기화합니다.
+        서비스가 아닌 클래스 자체의 작업 데이터를 초기화하는 함수입니다.
+        
+        Returns:
+            self: 메소드 체이닝을 위한 자기 자신 반환
+        """
         self.genBones = []
         self.genHelpers = []
+        self.clavicle = None
+        self.upperArm = None
+        self.liftScale = 0.8
+        
+        return self
     
     def create_bones(self, inClavicle, inUpperArm, liftScale=0.8):
         """
@@ -54,159 +80,98 @@ class AutoClavicle:
             liftScale: 들어올림 스케일 (기본값: 0.8)
             
         Returns:
-            생성된 자동 쇄골 뼈대 배열
+            생성된 자동 쇄골 뼈대 배열 또는 AutoClavicleChain 클래스에 전달할 수 있는 딕셔너리
         """
         if not rt.isValidNode(inClavicle) or not rt.isValidNode(inUpperArm):
             return False
         
-        self.clavicle = inClavicle
-        self.upperArm = inUpperArm
-        self.liftScale = liftScale
-        self.genBones = []
-        self.genHelpers = []
+        # 리스트 초기화
+        genBones = []
+        genHelpers = []
         
         # 쇄골과 상완 사이의 거리 계산
         clavicleLength = rt.distance(inClavicle, inUpperArm)
-        
-        # 임시 헬퍼 포인트 생성
-        tempHelperA = rt.Point()
-        tempHelperB = rt.Point()
-        tempHelperA.transform = inClavicle.transform
-        tempHelperB.transform = inClavicle.transform
-        self.anim.move_local(tempHelperB, clavicleLength/2.0, 0.0, 0.0)
+        facingDirVec = inUpperArm.transform.position - inClavicle.transform.position
+        inObjXAxisVec = inClavicle.objectTransform.row1
+        distanceDir = 1.0 if rt.dot(inObjXAxisVec, facingDirVec) > 0 else -1.0
+        clavicleLength *= distanceDir
         
         # 자동 쇄골 이름 생성 및 뼈대 생성
-        autoClavicleName = self.name.replace_name_part("RealName", inClavicle.name, "AutoClavicle")
-        autoClavicleBones = self.bone.create_bone(
-            [tempHelperA, tempHelperB], 
-            autoClavicleName, 
-            end=True, 
-            delPoint=True, 
-            parent=False, 
-            size=self.boneSize
-        )
-        autoClavicleBones[0].transform = inClavicle.transform
-        self.anim.move_local(autoClavicleBones[0], clavicleLength/2.0, 0.0, 0.0)
-        autoClavicleBones[0].parent = inClavicle
-        self.genBones.extend(autoClavicleBones)
-        
-        # LookAt 설정
-        ikGoal = self.helper.create_point(autoClavicleName, boxToggle=False, crossToggle=True)
-        ikGoal.transform = autoClavicleBones[1].transform
-        ikGoal.name = self.name.replace_name_part("Type", autoClavicleName, "T")
-        autClavicleLookAtConst = self.const.assign_lookat(autoClavicleBones[0], ikGoal)
-        autClavicleLookAtConst.upnode_world = False
-        autClavicleLookAtConst.pickUpNode = inClavicle
-        autClavicleLookAtConst.lookat_vector_length = 0.0
-        self.genHelpers.append(ikGoal)
+        autoClavicleName = self.name.replace_name_part("RealName", inClavicle.name, "Auto" + self.name._get_filtering_char(inClavicle.name) + "Clavicle")
+        if inClavicle.name[0].islower():
+            autoClavicleName = autoClavicleName.lower()
         
-        # 회전 헬퍼 포인트 생성
-        autoClavicleRotHelper = self.helper.create_point(self.name.replace_name_part("Type", autoClavicleName, "Rot"))
-        autoClavicleRotHelper.transform = autoClavicleBones[0].transform
-        autoClavicleRotHelper.parent = inClavicle
-        self.genHelpers.append(autoClavicleRotHelper)
+        autoClavicleBone = self.bone.create_nub_bone(autoClavicleName, 2)
+        autoClavicleBone.name = self.name.remove_name_part("Nub", autoClavicleBone.name)
+        autoClavicleBone.transform = inClavicle.transform
+        self.anim.move_local(autoClavicleBone, clavicleLength/2.0, 0.0, 0.0)
+        autoClavicleBone.parent = inClavicle
+        genBones.extend(autoClavicleBone)
         
         # 타겟 헬퍼 포인트 생성 (쇄골과 상완용)
-        rotTargetClavicle = self.helper.create_point(self.name.replace_name_part("Type", autoClavicleName, "T"))
+        rotTargetClavicle = self.helper.create_point(self.name.replace_name_part("Type", autoClavicleName, self.name.get_name_part_value_by_description("Type", "Target")))
+        rotTargetClavicle.name = self.name.replace_name_part("Index", rotTargetClavicle.name, "0")
         rotTargetClavicle.transform = inClavicle.transform
         self.anim.move_local(rotTargetClavicle, clavicleLength, 0.0, 0.0)
-        self.genHelpers.append(rotTargetClavicle)
         
-        rotTargetUpperArm = self.helper.create_point(self.name.replace_name_part("Type", autoClavicleName, "T"))
-        rotTargetUpperArm.name = self.name.add_suffix_to_real_name(rotTargetUpperArm.name, "UArm")
+        rotTargetClavicle.parent = inClavicle
+        genHelpers.append(rotTargetClavicle)
+        
+        rotTargetUpperArm = self.helper.create_point(self.name.replace_name_part("Type", autoClavicleName, self.name.get_name_part_value_by_description("Type", "Target")))
+        rotTargetUpperArm.name = self.name.add_suffix_to_real_name(rotTargetUpperArm.name, self.name._get_filtering_char(inClavicle.name) + "arm")
         rotTargetUpperArm.transform = inUpperArm.transform
         self.anim.move_local(rotTargetUpperArm, (clavicleLength/2.0)*liftScale, 0.0, 0.0)
-        self.genHelpers.append(rotTargetUpperArm)
         
-        # 부모 설정
-        rotTargetClavicle.parent = inClavicle
         rotTargetUpperArm.parent = inUpperArm
+        genHelpers.append(rotTargetUpperArm)
         
-        # LookAt 제약 설정
-        # self.const.assign_lookat_multi(autoClavicleRotHelper, [rotTargetClavicle, rotTargetUpperArm])
-        lookAtConst = self.const.assign_scripted_lookat(autoClavicleRotHelper, [rotTargetClavicle, rotTargetUpperArm])["lookAt"]
+        # 회전 헬퍼 포인트 생성
+        autoClavicleRotHelper = self.helper.create_point(self.name.replace_name_part("Type", autoClavicleName, self.name.get_name_part_value_by_description("Type", "Rotation")))
+        autoClavicleRotHelper.transform = autoClavicleBone.transform
+        autoClavicleRotHelper.parent = inClavicle
+        
+        lookAtConst = self.const.assign_lookat_multi(autoClavicleRotHelper, [rotTargetClavicle, rotTargetUpperArm])
         
         lookAtConst.upnode_world = False
         lookAtConst.pickUpNode = inClavicle
         lookAtConst.lookat_vector_length = 0.0
         
-        ikGoal.parent = autoClavicleRotHelper
-        
-        return autoClavicleBones
-    
-    def get_bones(self):
-        """
-        자동 쇄골 뼈를 가져옵니다.
+        genHelpers.append(autoClavicleRotHelper)
         
-        Args:
-            inClavicle: 쇄골 뼈 객체
-            inUpperArm: 상완 뼈 객체
-            
-        Returns:
-            자동 쇄골 뼈대 배열
-        """
-        if len(self.genBones) == 0:
-            return []
-        
-        validResults = []
-        for item in self.genBones:
-            validResults.append(rt.isValidNode(item))
-        if not all(validResults):
-            return []
-        
-        return self.genBones
-    
-    def get_helpers(self):
-        """
-        자동 쇄골 헬퍼를 가져옵니다.
-        
-        Args:
-            inClavicle: 쇄골 뼈 객체
-            inUpperArm: 상완 뼈 객체
-            
-        Returns:
-            자동 쇄골 헬퍼 배열
-        """
-        if len(self.genHelpers) == 0:
-            return []
-        
-        validResults = []
-        for item in self.genHelpers:
-            validResults.append(rt.isValidNode(item))
-        if not all(validResults):
-            return []
+        # ik 헬퍼 포인트 생성
+        ikGoal = self.helper.create_point(autoClavicleName, boxToggle=False, crossToggle=True)
+        ikGoal.transform = inClavicle.transform
+        self.anim.move_local(ikGoal, clavicleLength, 0.0, 0.0)
+        ikGoal.name = self.name.replace_name_part("Type", autoClavicleName, self.name.get_name_part_value_by_description("Type", "Target"))
+        ikGoal.name = self.name.replace_name_part("Index", ikGoal.name, "1")
         
-        return self.genHelpers
-    
-    def delete(self):
-        """
-        자동 쇄골 뼈와 헬퍼를 삭제합니다.
+        ikGoal.parent = autoClavicleRotHelper
         
-        Args:
-            None
-            
-        Returns:
-            None
-        """
-        rt.delete(self.genBones)
-        rt.delete(self.genHelpers)
+        autClavicleLookAtConst = self.const.assign_lookat(autoClavicleBone, ikGoal)
+        if clavicleLength < 0:
+            autClavicleLookAtConst.target_axisFlip = True
+        autClavicleLookAtConst.upnode_world = False
+        autClavicleLookAtConst.pickUpNode = inClavicle
+        autClavicleLookAtConst.lookat_vector_length = 0.0
+        genHelpers.append(ikGoal)
         
-        self.genBones = []
-        self.genHelpers = []
+        # 결과를 멤버 변수에 저장
+        self.genBones = genBones
+        self.genHelpers = genHelpers
+        self.clavicle = inClavicle
+        self.upperArm = inUpperArm
+        self.liftScale = liftScale
         
-    def update_liftScale(self, liftScale=0.8):
-        """
-        자동 쇄골 뼈의 들어올림 스케일을 업데이트합니다.
+        # AutoClavicleChain에 전달할 수 있는 딕셔너리 형태로 결과 반환
+        result = {
+            "Bones": genBones,
+            "Helpers": genHelpers,
+            "Clavicle": inClavicle,
+            "UpperArm": inUpperArm,
+            "LiftScale": liftScale
+        }
         
-        Args:
-            liftScale: 들어올림 스케일 (기본값: 0.8)
-            
-        Returns:
-            None
-        """
-        if len(self.genBones) == 0:
-            return False
+        # 메소드 호출 후 데이터 초기화
+        self.reset()
         
-        self.delete()
-        self.create_bones(self.clavicle, self.upperArm, liftScale=liftScale)
-    
+        return result