pyjallib 0.1.5__tar.gz → 0.1.6__tar.gz

{pyjallib-0.1.5 → pyjallib-0.1.6}/PKG-INFO

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

{pyjallib-0.1.5 → pyjallib-0.1.6}/pyproject.toml

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

{pyjallib-0.1.5 → pyjallib-0.1.6}/src/pyjallib/__init__.py

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

{pyjallib-0.1.5 → pyjallib-0.1.6}/src/pyjallib/max/ConfigFiles/3DSMaxNamingConfig.json

@@ -25,6 +25,10 @@
                 "SkinBone",
                 "Biped"
             ],
+            "koreanDescriptions": [
+                "",
+                ""
+            ],
             "isDirection": false
         },
         {
@@ -34,14 +38,22 @@
                 "Dum",
                 "Exp",
                 "IK",
-                "T"
+                "T",
+                "Rot",
+                "Pos",
+                "Lat",
+                "UpN"
             ],
             "weights": [
                 5,
                 10,
                 15,
                 20,
-                25
+                25,
+                30,
+                35,
+                40,
+                45
             ],
             "type": "PREFIX",
             "descriptions": [
@@ -49,7 +61,22 @@
                 "Dummy",
                 "ExposeTM",
                 "IK",
-                "Target"
+                "Target",
+                "Rotation",
+                "Position",
+                "LookAt",
+                "UpNode"
+            ],
+            "koreanDescriptions": [
+                "",
+                "",
+                "",
+                "",
+                "",
+                "",
+                "",
+                "",
+                ""
             ],
             "isDirection": false
         },
@@ -68,6 +95,10 @@
                 "Left",
                 "Right"
             ],
+            "koreanDescriptions": [
+                "",
+                ""
+            ],
             "isDirection": true
         },
         {
@@ -85,6 +116,10 @@
                 "Front",
                 "Back"
             ],
+            "koreanDescriptions": [
+                "",
+                ""
+            ],
             "isDirection": true
         },
         {
@@ -93,6 +128,7 @@
             "weights": [],
             "type": "REALNAME",
             "descriptions": [],
+            "koreanDescriptions": [],
             "isDirection": false
         },
         {
@@ -101,6 +137,7 @@
             "weights": [],
             "type": "INDEX",
             "descriptions": [],
+            "koreanDescriptions": [],
             "isDirection": false
         },
         {
@@ -115,6 +152,9 @@
             "descriptions": [
                 "Nub"
             ],
+            "koreanDescriptions": [
+                ""
+            ],
             "isDirection": false
         }
     ]

{pyjallib-0.1.5 → pyjallib-0.1.6}/src/pyjallib/max/__init__.py

@@ -27,6 +27,7 @@ from .skin import Skin
 
 from .twistBone import TwistBone
 from .groinBone import GroinBone
+from .autoClavicle import AutoClavicle
 
 # 모듈 내보내기
 __all__ = [
@@ -44,5 +45,6 @@ __all__ = [
     'Bip',
     'Skin',
     'TwistBone',
-    'GroinBone'
+    'GroinBone',
+    'AutoClavicle'
 ]

pyjallib-0.1.6/src/pyjallib/max/autoClavicle.py

@@ -0,0 +1,122 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+
+"""
+자동 쇄골(AutoClavicle) 모듈 - 3ds Max용 자동화된 쇄골 기능 제공
+원본 MAXScript의 autoclavicle.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 .bip import Bip
+
+
+class AutoClavicle:
+    """
+    자동 쇄골(AutoClavicle) 관련 기능을 제공하는 클래스.
+    MAXScript의 _AutoClavicleBone 구조체 개념을 Python으로 재구현한 클래스이며,
+    3ds Max의 기능들을 pymxs API를 통해 제어합니다.
+    """
+    
+    def __init__(self, nameService=None, animService=None, helperService=None, boneService=None, constraintService=None, bipService=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.bone = boneService if boneService else Bone(nameService=self.name, animService=self.anim, helperService=self.helper)
+        self.const = constraintService if constraintService else Constraint(nameService=self.name, helperService=self.helper)
+        self.bip = bipService if bipService else Bip(animService=self.anim, nameService=self.name, boneService=self.bone)
+        
+        self.bone_size = 2.0
+    
+    def create_bones(self, inClavicle, inUpperArm, liftScale=0.8):
+        """
+        자동 쇄골 뼈를 생성하고 설정합니다.
+        
+        Args:
+            inClavicle: 쇄골 뼈 객체
+            inUpperArm: 상완 뼈 객체
+            liftScale: 들어올림 스케일 (기본값: 0.8)
+            
+        Returns:
+            생성된 자동 쇄골 뼈대 배열
+        """
+        # 쇄골과 상완 사이의 거리 계산
+        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)
+        
+        # 자동 쇄골 이름 생성 및 뼈대 생성
+        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.bone_size
+        )
+        autoClavicleBones[0].transform = inClavicle.transform
+        self.anim.move_local(autoClavicleBones[0], clavicleLength/2.0, 0.0, 0.0)
+        autoClavicleBones[0].parent = inClavicle
+        
+        # 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
+        
+        # 회전 헬퍼 포인트 생성
+        autoClavicleRotHelper = self.helper.create_point(self.name.replace_name_part("Type", autoClavicleName, "Rot"))
+        autoClavicleRotHelper.transform = autoClavicleBones[0].transform
+        autoClavicleRotHelper.parent = inClavicle
+        
+        # 타겟 헬퍼 포인트 생성 (쇄골과 상완용)
+        rotTargetClavicle = self.helper.create_point(self.name.replace_name_part("Type", autoClavicleName, "T"))
+        rotTargetClavicle.transform = inClavicle.transform
+        self.anim.move_local(rotTargetClavicle, clavicleLength, 0.0, 0.0)
+        
+        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")
+        rotTargetUpperArm.transform = inUpperArm.transform
+        self.anim.move_local(rotTargetUpperArm, (clavicleLength/2.0)*liftScale, 0.0, 0.0)
+        
+        # 부모 설정
+        rotTargetClavicle.parent = inClavicle
+        rotTargetUpperArm.parent = inUpperArm
+        
+        # LookAt 제약 설정
+        # self.const.assign_lookat_multi(autoClavicleRotHelper, [rotTargetClavicle, rotTargetUpperArm])
+        lookAtConst = self.const.assign_scripted_lookat(autoClavicleRotHelper, [rotTargetClavicle, rotTargetUpperArm])["lookAt"]
+        
+        lookAtConst.upnode_world = False
+        lookAtConst.pickUpNode = inClavicle
+        lookAtConst.lookat_vector_length = 0.0
+        
+        ikGoal.parent = autoClavicleRotHelper
+        
+        return autoClavicleBones

{pyjallib-0.1.5 → pyjallib-0.1.6}/src/pyjallib/max/constraint.py

@@ -675,7 +675,8 @@ class Constraint:
         # 객체 이름 생성
         if self.name:
             objName = self.name.get_string(oriObj.name)
-            indexNum = self.name.get_index_as_digit(oriObj.name)
+            indexVal = self.name.get_index_as_digit(oriObj.name)
+            indexNum = 0 if indexVal is False else indexVal
             dummyName = self.name.add_prefix_to_real_name(objName, self.name.get_dummy_value())
             
             lookAtPointName = self.name.replace_Index(dummyName, str(indexNum))
@@ -752,6 +753,8 @@ class Constraint:
         x_controller.Update()
         y_controller.Update()
         z_controller.Update()
+        
+        return {"lookAt":lookAtPoint_rot_controller, "x":x_controller, "y":y_controller, "z":z_controller}
     
     def assign_attachment(self, inPlacedObj, inSurfObj, bAlign=False, shiftAxis=(0, 0, 1), shiftAmount=3.0):
         """

{pyjallib-0.1.5 → pyjallib-0.1.6}/src/pyjallib/max/header.py

@@ -26,6 +26,7 @@ from .skin import Skin
 
 from .twistBone import TwistBone
 from .groinBone import GroinBone
+from .autoClavicle import AutoClavicle
 
 class Header:
     """
@@ -66,6 +67,7 @@ class Header:
 
         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.autoClavicle = AutoClavicle(nameService=self.name, animService=self.anim, helperService=self.helper, boneService=self.bone, constraintService=self.constraint, bipService=self.bip)
 
 # 모듈 레벨에서 전역 인스턴스 생성
 jal = Header.get_instance()

{pyjallib-0.1.5 → pyjallib-0.1.6}/src/pyjallib/naming.py

@@ -352,11 +352,12 @@ class Naming:
         partValues = partObj.get_predefined_values()
         
         if partType == NamePartType.PREFIX or partType == NamePartType.SUFFIX:
-            foundIndex = partObj._descriptions.index(inDescription)
-            if foundIndex >= 0:
+            try:
+                foundIndex = partObj._descriptions.index(inDescription)
                 return partValues[foundIndex]
-        
-        return ""
+            except ValueError:
+                # Description not found in the list
+                return ""
 
     def pick_name(self, inNamePartName, inStr):
         nameArray = self._split_to_array(inStr)

pyjallib-0.1.6/tests/autoclavicle.ms

@@ -0,0 +1,47 @@
+struct _AutoClavicleBone (
+    name, anim, helper, bone, const, bip,
+
+    boneSize = 2.0,
+
+    fn create_bones inClavicle inUpperArm liftScale:0.8 = (
+        local clavicleLength = distance inClavicle inUpperArm
+        local tempHelperA = point()
+        local tempHelperB = point()
+        tempHelperA.transform = inClavicle.transform
+        tempHelperB.transform = inClavicle.transform
+        anim.move_local tempHelperB (clavicleLength/2.0) 0.0 0.0
+
+        local autoClavicleName = name.replace_realName inClavicle.name "AutoClavicle"
+        local autoClavicleBones = bone.create_bone #(tempHelperA, tempHelperB) autoClavicleName end:true delPoint:true parent:false size:boneSize
+        autoClavicleBones[1].transform = inClavicle.transform
+        anim.move_local autoClavicleBones[1] (clavicleLength/2.0) 0.0 0.0
+        autoClavicleBones[1].parent = inClavicle
+
+        local ikGoal = IKSys.ikChain autoClavicleBones[1] autoClavicleBones[2] "IKHISolver"
+        ikGoal.name = name.replace_type autoClavicleName "IK"
+        ikGoal.transform = autoClavicleBones[2].transform
+
+        local autoClavicleRotHelper = helper.create_point (name.replace_type autoClavicleName "Rot")
+        autoClavicleRotHelper.transform = autoClavicleBones[1].transform
+        autoClavicleRotHelper.parent = inClavicle
+
+        local rotTargetClavicle = helper.create_point (name.replace_type autoClavicleName "T")
+        rotTargetClavicle.transform = inClavicle.transform
+        anim.move_local rotTargetClavicle clavicleLength 0.0 0.0
+        local rotTargetUpperArm = helper.create_point (name.replace_type autoClavicleName "T")
+        rotTargetUpperArm.name = name.add_sufix_to_realName rotTargetUpperArm.name "UArm"
+        rotTargetUpperArm.transform = inUpperArm.transform
+        anim.move_local rotTargetUpperArm ((clavicleLength/2.0)*liftScale) 0.0 0.0
+
+        rotTargetClavicle.parent = inClavicle
+        rotTargetUpperArm.parent = inUpperArm
+
+        const.assign_lookAt_multi autoClavicleRotHelper #(rotTargetClavicle, rotTargetUpperArm)
+        autoClavicleRotHelper.rotation.controller[2].upnode_world = false
+        autoClavicleRotHelper.rotation.controller[2].pickUpNode = inClavicle
+        autoClavicleRotHelper.rotation.controller[2].lookat_vector_length = 0.0
+        ikGoal.parent = autoClavicleRotHelper
+
+        autoClavicleBones
+    )
+)

pyjallib-0.1.6/tests/autoclavicleTest.py

@@ -0,0 +1,24 @@
+import sys
+import os
+
+# 현재 스크립트의 디렉토리 path 가져오기
+current_dir = os.path.dirname(os.path.abspath(__file__))
+# 프로젝트 루트 디렉토리 추가 (PyJalLib 디렉토리)
+project_root = os.path.abspath(os.path.join(current_dir, "..", "src"))
+
+if project_root not in sys.path:
+    sys.path.insert(0, project_root)
+
+import pyjallib
+pyjallib.reload_modules()
+
+tempJal = pyjallib.max.header.Header()
+
+selObjs = rt.getCurrentSelection()
+
+clavicle = tempJal.bip.get_grouped_nodes(selObjs[0], "lArm")[0]
+upperArm = tempJal.bip.get_grouped_nodes(selObjs[0], "lArm")[1]
+
+print(clavicle, upperArm)
+
+tempJal.autoClavicle.create_bones(clavicle, upperArm, liftScale=0.8)