pyjallib 0.1.10__tar.gz → 0.1.11__tar.gz

{pyjallib-0.1.10 → pyjallib-0.1.11}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pyjallib
-Version: 0.1.10
+Version: 0.1.11
 Summary: A utility library for 3D game character development pipelines.
 Author-email: Dongseok Kim <jalnagakds@gmail.com>
 Requires-Python: >=3.10

{pyjallib-0.1.10 → pyjallib-0.1.11}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "pyjallib"
-version = "0.1.10"
+version = "0.1.11"
 description = "A utility library for 3D game character development pipelines."
 readme = "README.md"
 authors = [

pyjallib-0.1.11/src/pyjallib/__init__.py

@@ -0,0 +1,17 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+
+"""
+pyjallib Package
+Python library for game character development pipeline.
+"""
+
+__version__ = '0.1.11'
+
+# reload_modules 함수를 패키지 레벨에서 사용 가능하게 함
+from pyjallib.namePart import NamePart, NamePartType
+from pyjallib.naming import Naming
+from pyjallib.namingConfig import NamingConfig
+from pyjallib.nameToPath import NameToPath
+from pyjallib.perforce import Perforce
+from pyjallib.reloadModules import reload_modules

pyjallib-0.1.11/src/pyjallib/max/__init__.py

@@ -0,0 +1,68 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+
+"""
+JalTools 3DS 패키지
+3DS Max 작업을 위한 모듈 모음
+"""
+
+# 모듈 임포트
+from pyjallib.max.header import Header
+
+from pyjallib.max.name import Name
+from pyjallib.max.anim import Anim
+
+from pyjallib.max.helper import Helper
+from pyjallib.max.constraint import Constraint
+from pyjallib.max.bone import Bone
+
+from pyjallib.max.mirror import Mirror
+from pyjallib.max.layer import Layer
+from pyjallib.max.align import Align
+from pyjallib.max.select import Select
+from pyjallib.max.link import Link
+
+from pyjallib.max.bip import Bip
+from pyjallib.max.skin import Skin
+from pyjallib.max.morph import Morph
+
+from pyjallib.max.boneChain import BoneChain
+
+from pyjallib.max.twistBone import TwistBone
+from pyjallib.max.groinBone import GroinBone
+from pyjallib.max.autoClavicle import AutoClavicle
+from pyjallib.max.volumeBone import VolumeBone
+from pyjallib.max.kneeBone import KneeBone
+from pyjallib.max.hip import Hip
+
+from pyjallib.max.ui.Container import Container
+
+# 모듈 내보내기
+__all__ = [
+    'Header',
+    'Name',
+    'Anim',
+    'Helper', 
+    'Constraint',
+    'Bone',
+    'Mirror',
+    'Layer',
+    'Align',
+    'Select',
+    'Link',
+    'Bip',
+    'Skin',
+    'Morph',
+    'BoneChain',
+    'TwistBone',
+    'TwistBoneChain',
+    'GroinBone',
+    'GroinBoneChain',
+    'AutoClavicle',
+    'AutoClavicleChain',
+    'VolumeBone',
+    'VolumeBoneChain',
+    'KneeBone',
+    'Hip',
+    'Container'
+]

{pyjallib-0.1.10 → pyjallib-0.1.11}/src/pyjallib/max/autoClavicle.py

@@ -16,6 +16,8 @@ from .bone import Bone
 from .constraint import Constraint
 from .bip import Bip
 
+from .boneChain import BoneChain
+
 
 class AutoClavicle:
     """
@@ -166,12 +168,45 @@ class AutoClavicle:
         result = {
             "Bones": genBones,
             "Helpers": genHelpers,
-            "Clavicle": inClavicle,
-            "UpperArm": inUpperArm,
-            "LiftScale": liftScale
+            "SourceBones": [inClavicle, inUpperArm],
+            "Parameters": [liftScale]
         }
         
         # 메소드 호출 후 데이터 초기화
         self.reset()
         
-        return result
+        return BoneChain.from_result(result)
+    
+    def create_bones_from_chain(self, inBoneChain: BoneChain):
+        """
+        기존 BoneChain 객체에서 자동 쇄골 뼈를 생성합니다.
+        기존 설정을 복원하거나 저장된 데이터에서 쇄골 셋업을 재생성할 때 사용합니다.
+        
+        Args:
+            inBoneChain (BoneChain): 자동 쇄골 정보를 포함한 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) < 2 or not rt.isValidNode(sourceBones[0]) or not rt.isValidNode(sourceBones[1]):
+            return None
+            
+        # 파라미터 가져오기 (또는 기본값 사용)
+        liftScale = parameters[0] if len(parameters) > 0 else 0.8
+        
+        # 쇄골 생성
+        inClavicle = sourceBones[0]
+        inUpperArm = sourceBones[1]
+        
+        # 새로운 쇄골 생성
+        return self.create_bones(inClavicle, inUpperArm, liftScale)

{pyjallib-0.1.10 → pyjallib-0.1.11}/src/pyjallib/max/bip.py

@@ -608,6 +608,7 @@ class Bip:
         for i, fingers in enumerate(lFingersList):
             for j, item in enumerate(fingers):
                 item.name = self.name.replace_name_part("RealName", item.name, fingerName[i])
+                item.name = self.name.replace_name_part("Side", item.name, self.name.get_name_part_value_by_description("Side", "Left"))
                 item.name = self.name.replace_name_part("Index", item.name, str(j+1))
             
             fingerNub = self.bone.get_every_children(fingers[-1])[0]
@@ -618,6 +619,7 @@ class Bip:
         for i, fingers in enumerate(rFingersList):
             for j, item in enumerate(fingers):
                 item.name = self.name.replace_name_part("RealName", item.name, fingerName[i])
+                item.name = self.name.replace_name_part("Side", item.name, self.name.get_name_part_value_by_description("Side", "Right"))
                 item.name = self.name.replace_name_part("Index", item.name, str(j+1))
             
             fingerNub = self.bone.get_every_children(fingers[-1])[0]

{pyjallib-0.1.10 → pyjallib-0.1.11}/src/pyjallib/max/bone.py

@@ -239,6 +239,7 @@ class Bone:
         nubBone.backfin = False
         nubBone.sidefins = False
         nubBone.name = self.name.remove_name_part("Index", inName)
+        nubBone.name = self.name.remove_name_part("Nub", nubBone.name)
         nubBone.name = self.name.replace_name_part("Nub", nubBone.name, self.name.get_name_part_value_by_description("Nub", "Nub"))
         
         # 화면 갱신 재개
@@ -888,6 +889,7 @@ class Bone:
         returnBones = []
         spine3 = None
         neck = None
+        head = None
         
         handL = None
         handR = None
@@ -905,6 +907,8 @@ class Bone:
                 spine3 = item
             if rt.matchPattern(item.name, pattern="*neck 01"):
                 neck = item
+            if rt.matchPattern(item.name, pattern="*head"):
+                head = item
             if rt.matchPattern(item.name, pattern="*hand*l"):
                 handL = item
             if rt.matchPattern(item.name, pattern="*hand*r"):
@@ -924,6 +928,8 @@ class Bone:
         
         filteringChar = self.name._get_filtering_char(inBoneArray[-1].name)
         isLower = inBoneArray[-1].name[0].islower()
+        
+        # Spine 4,5 생성
         spineName = self.name.get_name_part_value_by_description("Base", "Biped") + filteringChar + "Spine"
         
         spine4 = self.create_nub_bone(spineName, 2)
@@ -946,6 +952,23 @@ class Bone:
         returnBones.append(spine4)
         returnBones.append(spine5)
         
+        # 목 생성
+        neckName = self.name.get_name_part_value_by_description("Base", "Biped") + filteringChar + "Neck"
+        
+        nekc2 = self.create_nub_bone(neckName, 2)
+        
+        nekc2.name = self.name.replace_name_part("Index", nekc2.name, "2")
+        nekc2.name = self.name.remove_name_part("Nub", nekc2.name)
+        if isLower:
+            nekc2.name = nekc2.name.lower()
+        
+        neckDistance = rt.distance(neck, head)/2.0
+        rt.setProperty(nekc2, "transform", neck.transform)
+        self.anim.move_local(nekc2, neckDistance, 0, 0)
+        
+        returnBones.append(nekc2)
+        
+        # 손가락용 메타카팔 생성
         for i, finger in enumerate(lFingers):
             knuckleBoneName = self.name.add_suffix_to_real_name(finger.name, filteringChar+knuckleName)
             knuckleBoneName = self.name.remove_name_part("Index", knuckleBoneName)
@@ -992,6 +1015,7 @@ class Bone:
         returnBones = []
         
         spine3 = None
+        neck = None
         
         handL = None
         handR = None
@@ -1001,6 +1025,8 @@ class Bone:
         for item in inBipArray:
             if rt.matchPattern(item.name, pattern="*spine 03"):
                 spine3 = item
+            if rt.matchPattern(item.name, pattern="*neck 01"):
+                neck = item
             if rt.matchPattern(item.name, pattern="*hand*l"):
                 handL = item
             if rt.matchPattern(item.name, pattern="*hand*r"):
@@ -1009,6 +1035,8 @@ class Bone:
         for item in inMissingBoneArray:
             if rt.matchPattern(item.name, pattern="*spine*"):
                 item.parent = spine3
+            if rt.matchPattern(item.name, pattern="*neck*"):
+                item.parent = neck
             if rt.matchPattern(item.name, pattern=f"*{knuckleName}*l"):
                 item.parent = handL
             if rt.matchPattern(item.name, pattern=f"*{knuckleName}*r"):
@@ -1025,6 +1053,8 @@ class Bone:
         spine5 = None
         
         neck = None
+        neck2 = None
+        head = None
         clavicleL = None
         clavicleR = None
         
@@ -1042,6 +1072,8 @@ class Bone:
                 spine3 = item
             if rt.matchPattern(item.name, pattern="*neck*01"):
                 neck = item
+            if rt.matchPattern(item.name, pattern="*head*"):
+                head = item
             if rt.matchPattern(item.name, pattern="*clavicle*l"):
                 clavicleL = item
             if rt.matchPattern(item.name, pattern="*clavicle*r"):
@@ -1069,6 +1101,11 @@ class Bone:
                 neck.parent = spine5
                 clavicleL.parent = spine5
                 clavicleR.parent = spine5
+                
+            if rt.matchPattern(item.name, pattern="*neck*02"):
+                neck2 = item
+                item.parent = neck
+                head.parent = neck2
             
             if rt.matchPattern(item.name, pattern=f"*{knuckleName}*l"):
                 item.parent = handL

pyjallib-0.1.11/src/pyjallib/max/boneChain.py

@@ -0,0 +1,182 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+
+"""
+뼈대 체인(Bone Chain) 기본 클래스 - 뼈대 체인 관리를 위한 공통 기능 제공
+
+이 모듈은 다양한 뼈대 체인 클래스의 기본 부모 클래스로 사용됩니다.
+AutoClavicleChain, GroinBoneChain, VolumeBoneChain, TwistBoneChain 등의
+특수 목적 뼈대 체인들이 상속받아 사용하며, 공통된 관리 기능을 제공합니다.
+
+기본 클래스는 다음과 같은 공통 기능을 제공합니다:
+- 체인의 뼈대 및 헬퍼 관리
+- 체인 비우기/삭제 기능
+- 체인 상태 확인 기능
+"""
+
+from pymxs import runtime as rt
+
+
+class BoneChain:
+    """
+    뼈대 체인을 관리하는 기본 클래스
+    
+    다양한 뼈대 체인의 공통 기능을 담당하는 부모 클래스입니다.
+    뼈대와 헬퍼를 저장하고 기본적인 조작 기능을 제공합니다.
+    """
+    
+    def __init__(self, inResult=None):
+        """
+        클래스 초기화
+        
+        Args:
+            inResult (dict, optional): 뼈대 생성 결과 데이터를 담은 딕셔너리. 기본값은 None
+        """
+        # 기본 속성 초기화
+        if inResult is None:
+            # inResult가 None이면 속성들을 빈 리스트로 초기화
+            self.bones = []
+            self.helpers = []
+            self.result = {}  # 빈 딕셔너리로 초기화
+            self.sourceBones = []
+            self.parameters = []
+        else:
+            self.bones = inResult.get("Bones", [])
+            self.helpers = inResult.get("Helpers", [])
+            self.result = inResult  # 원본 결과 보존
+            self.sourceBones = inResult.get("SourceBones", [])
+            self.parameters = inResult.get("Parameters", [])
+        
+    def is_empty(self):
+        """
+        체인이 비어있는지 확인
+        
+        Returns:
+            bool: 체인이 비어있으면 True, 아니면 False
+        """
+        return len(self.bones) == 0
+    
+    def clear(self):
+        """체인의 모든 뼈대와 헬퍼 참조 제거"""
+        self.bones = []
+        self.helpers = []
+        self.sourceBones = []
+        self.parameters = []
+        
+    def delete(self):
+        """
+        체인의 모든 뼈대와 헬퍼를 3ds Max 씬에서 삭제
+        
+        Returns:
+            bool: 삭제 성공 여부
+        """
+        if self.is_empty() and not self.helpers:
+            return False
+            
+        try:
+            # 뼈대 삭제
+            if self.bones:
+                for bone in self.bones:
+                    if rt.isValidNode(bone):
+                        rt.delete(bone)
+            
+            # 헬퍼 삭제
+            if self.helpers:
+                for helper in self.helpers:
+                    if rt.isValidNode(helper):
+                        rt.delete(helper)
+            
+            self.bones = []
+            self.helpers = []
+            
+            return True
+        except:
+            return False
+    
+    def delete_all(self):
+        """
+        체인의 모든 뼈대와 헬퍼를 3ds Max 씬에서 삭제
+        
+        Returns:
+            bool: 삭제 성공 여부
+        """
+        if self.is_empty() and not self.helpers:
+            return False
+            
+        try:
+            # 뼈대 삭제
+            if self.bones:
+                for bone in self.bones:
+                    if rt.isValidNode(bone):
+                        rt.delete(bone)
+            
+            # 헬퍼 삭제
+            if self.helpers:
+                for helper in self.helpers:
+                    if rt.isValidNode(helper):
+                        rt.delete(helper)
+                
+            self.clear()
+            return True
+        except:
+            return False
+    
+    def get_bones(self):
+        """
+        체인의 모든 뼈대 가져오기
+        
+        Returns:
+            list: 모든 뼈대 객체의 배열
+        """
+        if self.is_empty():
+            return []
+        
+        return self.bones
+    
+    def get_helpers(self):
+        """
+        체인의 모든 헬퍼 가져오기
+        
+        Returns:
+            list: 모든 헬퍼 객체의 배열
+        """
+        if not self.helpers:
+            return []
+        
+        return self.helpers
+    
+    @classmethod
+    def from_result(cls, inResult):
+        """
+        결과 딕셔너리로부터 체인 인스턴스 생성
+        
+        Args:
+            inResult (dict): 뼈대 생성 결과를 담은 딕셔너리
+            
+        Returns:
+            BoneChain: 생성된 체인 인스턴스
+        """
+        return cls(inResult)
+    
+    def update_from_result(self, inResult):
+        """
+        기존 체인 인스턴스를 결과 딕셔너리로부터 업데이트
+        
+        이미 생성된 체인 객체의 내용을 새로운 결과 데이터로 갱신합니다.
+        
+        Args:
+            inResult (dict): 뼈대 생성 결과를 담은 딕셔너리
+            
+        Returns:
+            self: 메서드 체이닝을 위한 자기 자신 반환
+        """
+        if inResult is None:
+            return self
+            
+        self.bones = inResult.get("Bones", [])
+        self.helpers = inResult.get("Helpers", [])
+        self.result = inResult  # 원본 결과 보존
+        self.sourceBones = inResult.get("SourceBones", [])
+        self.parameters = inResult.get("Parameters", [])
+        
+        return self

{pyjallib-0.1.10 → pyjallib-0.1.11}/src/pyjallib/max/groinBone.py

@@ -14,6 +14,8 @@ from .helper import Helper
 from .bone import Bone
 from .constraint import Constraint
 
+from .boneChain import BoneChain
+
 class GroinBone:
     """
     고간 부 본 관련 기능을 위한 클래스
@@ -75,21 +77,15 @@ class GroinBone:
         
         Args:
             inPelvis: Biped 객체
+            inLThighTwist: 왼쪽 허벅지 트위스트 본
+            inRThighTwist: 오른쪽 허벅지 트위스트 본
             inPelvisWeight: 골반 가중치 (기본값: 40.0)
             inThighWeight: 허벅지 가중치 (기본값: 60.0)
         
         Returns:
-            성공 여부 (Boolean)
+            BoneChain: 생성된 고간 부 본 체인 객체 또는 실패 시 False
         """
-        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
@@ -98,10 +94,11 @@ class GroinBone:
         if inPelvis.name[0].islower():
             groinName = groinName.lower()
         
-        groinBaseName = self.name.replace_name_part("RealName", inPelvis.name, groinBaseName)
+        groinBaseName = self.name.replace_name_part("RealName", inLThighTwist.name, groinName)
         
         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")
+        pelvisHelperName = self.name.replace_name_part("Index", pelvisHelperName, "0")
+        pelvisHelperName = self.name.remove_name_part("Side", pelvisHelperName)
         pelvisHelper = self.helper.create_point(pelvisHelperName)
         pelvisHelper.transform = inPelvis.transform
         self.anim.rotate_local(pelvisHelper, 0.0, 0.0, -180.0)
@@ -110,7 +107,7 @@ class GroinBone:
         
         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")
+        lThighTwistHelperName = self.name.replace_name_part("Index", lThighTwistHelperName, "0")
         lThighTwistHelper = self.helper.create_point(lThighTwistHelperName)
         lThighTwistHelper.transform = pelvisHelper.transform
         lThighTwistHelper.position = inLThighTwist.position
@@ -119,20 +116,22 @@ class GroinBone:
         
         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")
+        rThighTwistHelperName = self.name.replace_name_part("Index", rThighTwistHelperName, "0")
         rThighTwistHelper = self.helper.create_point(rThighTwistHelperName)
         rThighTwistHelper.transform = pelvisHelper.transform
         rThighTwistHelper.position = inRThighTwist.position
         rThighTwistHelper.parent = inRThighTwist
         self.helper.set_shape_to_box(rThighTwistHelper)
         
-        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 = inPelvis
+        groinBoneName = self.name.replace_name_part("Index", groinBaseName, "0")
+        groinBoneName = self.name.remove_name_part("Side", groinBoneName)
+        groinBone = self.bone.create_nub_bone(groinBoneName, 2)
+        groinBone.name = groinBoneName
+        groinBone.transform = pelvisHelper.transform
+        groinBone.parent = inPelvis
         
-        self.const.assign_rot_const_multi(groinBones[0], [pelvisHelper, lThighTwistHelper, rThighTwistHelper])
-        rotConst = self.const.get_rot_list_controller(groinBones[0])[1]
+        self.const.assign_rot_const_multi(groinBone, [pelvisHelper, lThighTwistHelper, rThighTwistHelper])
+        rotConst = self.const.get_rot_list_controller(groinBone)[1]
         rotConst.setWeight(1, inPelvisWeight)
         rotConst.setWeight(2, inThighWeight/2.0)
         rotConst.setWeight(3, inThighWeight/2.0)
@@ -141,20 +140,57 @@ class GroinBone:
         self.pelvis = inPelvis
         self.lThighTwist = inLThighTwist
         self.rThighTwist = inRThighTwist
-        self.bones = groinBones
+        self.bones = [groinBone]
         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
+        # BoneChain 구조에 맞는 결과 딕셔너리 생성
+        result = {
+            "Bones": [groinBone],
+            "Helpers": [pelvisHelper, lThighTwistHelper, rThighTwistHelper],
+            "SourceBones": [inPelvis, inLThighTwist, inRThighTwist],
+            "Parameters": [inPelvisWeight, inThighWeight]
+        }
         
         # 메소드 호출 후 데이터 초기화
         self.reset()
         
-        return returnVal
+        # BoneChain 객체 반환
+        return BoneChain.from_result(result)
+    
+    def create_bones_from_chain(self, inBoneChain: BoneChain):
+        """
+        기존 BoneChain 객체에서 고간 부 본을 생성합니다.
+        기존 설정을 복원하거나 저장된 데이터에서 고간 부 본 셋업을 재생성할 때 사용합니다.
+        
+        Args:
+            inBoneChain (BoneChain): 고간 부 본 정보를 포함한 BoneChain 객체
+        
+        Returns:
+            BoneChain: 업데이트된 BoneChain 객체 또는 실패 시 None
+        """
+        if not inBoneChain or inBoneChain.is_empty():
+            return None
+        
+        # 기존 객체 삭제
+        inBoneChain.delete()
+            
+        # BoneChain에서 필요한 정보 추출
+        sourceBones = inBoneChain.sourceBones
+        parameters = inBoneChain.parameters
+        
+        # 필수 소스 본 확인 (최소 3개: 골반, 좌허벅지트위스트, 우허벅지트위스트)
+        if len(sourceBones) < 3 or not rt.isValidNode(sourceBones[0]) or not rt.isValidNode(sourceBones[1]) or not rt.isValidNode(sourceBones[2]):
+            return None
+            
+        # 파라미터 가져오기 (또는 기본값 사용)
+        pelvisWeight = parameters[0] if len(parameters) > 0 else 40.0
+        thighWeight = parameters[1] if len(parameters) > 1 else 60.0
+        
+        # 새로운 고간 부 본 생성
+        inPelvis = sourceBones[0]
+        inLThighTwist = sourceBones[1]
+        inRThighTwist = sourceBones[2]
+        
+        return self.create_bone(inPelvis, inLThighTwist, inRThighTwist, pelvisWeight, thighWeight)