pyjallib 0.1.5__py3-none-any.whl → 0.1.6__py3-none-any.whl

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/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/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/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/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/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/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.5.dist-info → pyjallib-0.1.6.dist-info}/METADATA

@@ -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.dist-info → pyjallib-0.1.6.dist-info}/RECORD

@@ -1,20 +1,21 @@
-pyjallib/__init__.py,sha256=nuApOEfpw0H0-z0v_SJswZlD1KR3nrBiNrnk1-y8_k8,460
+pyjallib/__init__.py,sha256=Vn47aG6w0P4VzzOm7lnSp7G38YVsI40nTwg5CClgdR4,460
 pyjallib/namePart.py,sha256=D1hnFNnZbrNicAiW2ZUaIT0LU5pro3uFYrFYOEjt7_Y,24001
 pyjallib/nameToPath.py,sha256=61EWrc0Wc1K1Qsc4G6jewIccI0IHbiZWroRcU_lX1Wc,4664
-pyjallib/naming.py,sha256=W1y8a-Xa2qpAR1f-lFcJeg1uEYGJF2QbVXvsaQ1VpnM,36549
+pyjallib/naming.py,sha256=jJ6w0n_nnUE2uZy_I4KFsMx95Ij3_KvSjhVvQQplxpw,36621
 pyjallib/namingConfig.py,sha256=6Wyk3h1dFrzOslSoqjLftSUqt7U00tnR2WcgxYWVx5I,33969
 pyjallib/perforce.py,sha256=YnKAKlbBss4cl66R4nQbr-bsYjTneLzGYaZ187kOSpA,29872
 pyjallib/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 pyjallib/reloadModules.py,sha256=RAEG3IxzJ0TlsjvnZwJt56JOkc2j8voqAnRbfQuZ44g,1151
 pyjallib/ConfigFiles/namingConfig.json,sha256=Ov4bbVJb6qodPaooU63e11YUMGXXPWFAA4AQq1sLBYU,1486
-pyjallib/max/__init__.py,sha256=S0BQMblJxtxVB6fa8eNgp5n3b7IYvWlTMN0DbkMMVLw,827
+pyjallib/max/__init__.py,sha256=JofFmmSDMs8hWSAnS3yKw9y_o0IniQiKfzLtVUI9v8w,888
 pyjallib/max/align.py,sha256=HKjCViQCuicGmtvHB6xxVv4BEGEBGtV2gO3NvR_6R2A,5183
 pyjallib/max/anim.py,sha256=-shQeE0WeAeCefc8FoI63dNDLHhz0uzOJ4shp5AL_Cs,25135
+pyjallib/max/autoClavicle.py,sha256=rJtXVcTEksstaXF4s1i-0FwhVkPWJFRxlVq8Gyw45Rg,5792
 pyjallib/max/bip.py,sha256=m6eA-rg-MghYSxbzj-YXa0KJFPm1wiOsOqyJu76_hlY,16967
 pyjallib/max/bone.py,sha256=GYs3Uohc0AMkLWZAqZTc1DET-WDgZlvlkhSUaBeszvk,33161
-pyjallib/max/constraint.py,sha256=QJHkSAPv7mxq2m58ni0OFc0mfrwrx91CsqupQXPfwr0,39876
+pyjallib/max/constraint.py,sha256=WXB6fJ0er4EIZBZ7voQK_bFeqtgjopCKCpwiBn3QyiI,40055
 pyjallib/max/groinBone.py,sha256=rEZQ7tAXgcZ3NedFacIyvfG07nI8rgF_pVufy-hnKuo,3830
-pyjallib/max/header.py,sha256=VAeTBUEjQiMRxjGm9vM7tHwdmJhxbiYsJhGLPChFSBo,2502
+pyjallib/max/header.py,sha256=06rzzaOGDtxQGD4SwAFX8nlxNn8lP_gQ_qY0FGZYBFk,2736
 pyjallib/max/helper.py,sha256=s_rEhY1wNUrwyEN6osuUuOsnqFAQo8_X0Dcf3R89NY0,18526
 pyjallib/max/layer.py,sha256=e9Mn8h7xf0oBYST3QIpyBpLMl8qpWTExO9Y6yH6rKc0,8795
 pyjallib/max/link.py,sha256=J3z9nkP8ZxAh9yYhR16tjQFCJTCYZMSB0MGbSHfA7uI,2592
@@ -23,13 +24,13 @@ pyjallib/max/name.py,sha256=z_fclfutesFxhk2hVliqZGnRQauKcB8LJpRbKQ5cYAc,16703
 pyjallib/max/select.py,sha256=HMJD2WNX3zVBEeYrj0UX2YXM3fHNItfw6UtQSItNsoU,9487
 pyjallib/max/skin.py,sha256=5mBzG2wSUxoGlkFeb9Ys8uUxOwuZRGeqUMTI9LiWWZU,41937
 pyjallib/max/twistBone.py,sha256=0Z-Z-OiTPM0fXAnzgol0tiY7Kms6-qrEuVCHsCVVbUc,20338
-pyjallib/max/ConfigFiles/3DSMaxNamingConfig.json,sha256=lfD5ltvSBOYdqtVpkdgJxL3srEzQ3jBCMeK-Ae2GLUA,2751
+pyjallib/max/ConfigFiles/3DSMaxNamingConfig.json,sha256=_gIsm80fGazA6jUsoBAVxukGNydj6MDgBgGmzb0WQa4,3717
 pyjallib/max/macro/jal_macro_align.py,sha256=t0gQjybkHYAvPtjT5uWjUQd1vsXIsxOkdYfhFWduxJU,4270
 pyjallib/max/macro/jal_macro_bone.py,sha256=QS492tskLrARGIFDmbKEwJw7122xJga0ZP5z8WVVRn8,12422
 pyjallib/max/macro/jal_macro_constraint.py,sha256=0gpfan7hXES9jhnpZVlxWtCbqUCyGxjtSmVMbp7nUh8,4160
 pyjallib/max/macro/jal_macro_helper.py,sha256=ODwAl4C6WK2UE45dqpfw90TgN5vDjLJvODvYeO8tj4o,12906
 pyjallib/max/macro/jal_macro_link.py,sha256=xkgcCX0fJw4vLfMYybtfUklT3dgcO0tHfpt2X9BfWLw,1193
 pyjallib/max/macro/jal_macro_select.py,sha256=-r24l84XmDEM4W6H0r1jOBErp3q0UxNrr0m9oAHSgkE,2289
-pyjallib-0.1.5.dist-info/METADATA,sha256=yMpDJ1XRQxM-1o2vklLJUM8eDPSQdr22mATxqDNlN90,869
-pyjallib-0.1.5.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-pyjallib-0.1.5.dist-info/RECORD,,
+pyjallib-0.1.6.dist-info/METADATA,sha256=CcIpikrV2_YUnr8eiNH2Aggz2DKCsqWx_d81e5N9ORM,869
+pyjallib-0.1.6.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+pyjallib-0.1.6.dist-info/RECORD,,