pyjallib 0.1.17__py3-none-any.whl → 0.1.20__py3-none-any.whl

pyjallib/max/elbow.py

@@ -0,0 +1,105 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+
+"""
+팔꿈치 모듈
+자동으로 팔꿈치 본을 생성.
+"""
+
+from pymxs import runtime as rt
+
+from .volumeBone import VolumeBone
+from .boneChain import BoneChain
+
+class Elbow(VolumeBone):
+    def __init__(self, nameService=None, animService=None, constraintService=None, boneService=None, helperService=None):
+        super().__init__(nameService=nameService, animService=animService, constraintService=constraintService, boneService=boneService, helperService=helperService)
+    
+    def create_bones(self, inForeArm, inUpperArm, inRotScale=0.5, inVolumeSize=4.0, inRotAxis="Z", inElbowTransAxis="PosY", inInnerElbowTransAxis="NegY", inElbowTransScale=0.25, inInnerElbowTransScale=1.0):
+        """팔꿈치 볼륨 본들을 생성합니다."""
+        if not rt.isValidNode(inForeArm) or not rt.isValidNode(inUpperArm):
+            return False
+        
+        # 이름 생성 (로컬 변수로 처리)
+        filteringChar = self.name._get_filtering_char(inUpperArm.name)
+        elbowName = self.name.replace_name_part("RealName", inUpperArm.name, "Elbow")
+        elbowRootName = self.name.replace_name_part("RealName", elbowName, "Elbow" + filteringChar + "Root")
+        elbowRootDumName = self.name.replace_name_part("Type", elbowRootName, self.name.get_name_part_value_by_description("Type", "Dummy"))
+        elbowFwdName = self.name.replace_name_part("RealName", elbowName, "Elbow" + filteringChar + "Fwd")
+        elbowBckName = self.name.replace_name_part("RealName", elbowName, "Elbow" + filteringChar + "Bck")
+        
+        # 소문자 처리
+        if inUpperArm.name[0].islower():
+            elbowName = elbowName.lower()
+            elbowRootName = elbowRootName.lower()
+            elbowRootDumName = elbowRootDumName.lower()
+            elbowFwdName = elbowFwdName.lower()
+            elbowBckName = elbowBckName.lower()
+        
+        # 방향 결정
+        facingDirVec = inForeArm.transform.position - inUpperArm.transform.position
+        inObjXAxisVec = inForeArm.objectTransform.row1
+        distanceDir = 1.0 if rt.dot(inObjXAxisVec, facingDirVec) > 0 else -1.0
+        
+        # 축과 스케일 설정 - 모든 배열의 길이를 맞춤
+        rotAxises = [inRotAxis, inRotAxis]  # 2개의 볼륨 본이므로 같은 회전축을 2번
+        transAxises = [inElbowTransAxis, inInnerElbowTransAxis]
+        transScales = [inElbowTransScale, inInnerElbowTransScale]
+        transAxisNames = [inElbowTransAxis, inInnerElbowTransAxis]
+        
+        if distanceDir < 0:
+            transScales = [inInnerElbowTransScale, inElbowTransScale]
+            transAxisNames = [inInnerElbowTransAxis, inElbowTransAxis]
+        
+        # 부모 클래스의 create_bones 호출
+        volumeBoneResult = super().create_bones(inForeArm, inUpperArm, inRotScale, inVolumeSize, rotAxises, transAxises, transScales)
+        
+        # volumeBoneResult가 None이면 실패 반환
+        if not volumeBoneResult:
+            return None
+        
+        # 생성된 본들의 이름 변경
+        if hasattr(volumeBoneResult, 'bones') and volumeBoneResult.bones:
+            for item in volumeBoneResult.bones:
+                if rt.matchPattern(item.name.lower(), pattern="*root*"):
+                    item.name = elbowRootName
+                elif rt.matchPattern(item.name.lower(), pattern="*"+transAxisNames[0].lower()+"*"):
+                    item.name = elbowBckName
+                elif rt.matchPattern(item.name.lower(), pattern="*"+transAxisNames[1].lower()+"*"):
+                    item.name = elbowFwdName
+        
+        # 생성된 헬퍼들의 이름 변경
+        if hasattr(volumeBoneResult, 'helpers') and volumeBoneResult.helpers:
+            for item in volumeBoneResult.helpers:
+                if rt.matchPattern(item.name.lower(), pattern="*root*"):
+                    item.name = elbowRootDumName
+        
+        rt.redrawViews()
+        
+        return volumeBoneResult
+    
+    def create_bones_from_chain(self, inBoneChain: BoneChain):
+        """기존 BoneChain에서 팔꿈치 본들을 재생성합니다."""
+        if not inBoneChain or inBoneChain.is_empty():
+            return None
+        
+        inBoneChain.delete()
+        
+        sourceBones = inBoneChain.sourceBones
+        parameters = inBoneChain.parameters
+        
+        if len(sourceBones) < 2 or not rt.isValidNode(sourceBones[0]) or not rt.isValidNode(sourceBones[1]):
+            return None
+        
+        # 매개변수 추출
+        inForeArm = sourceBones[0]
+        inUpperArm = sourceBones[1]
+        inRotScale = parameters[0] if len(parameters) > 0 else 0.5
+        inVolumeSize = parameters[1] if len(parameters) > 1 else 4.0
+        inRotAxis = parameters[2] if len(parameters) > 2 else "Z"
+        inElbowTransAxis = parameters[3] if len(parameters) > 3 else "PosY"
+        inInnerElbowTransAxis = parameters[4] if len(parameters) > 4 else "NegY"
+        inElbowTransScale = parameters[5] if len(parameters) > 5 else 0.25
+        inInnerElbowTransScale = parameters[6] if len(parameters) > 6 else 1.0
+        
+        return self.create_bones(inForeArm, inUpperArm, inRotScale, inVolumeSize, inRotAxis, inElbowTransAxis, inInnerElbowTransAxis, inElbowTransScale, inInnerElbowTransScale)

pyjallib/max/groinBone.py

@@ -156,6 +156,8 @@ class GroinBone:
         # 메소드 호출 후 데이터 초기화
         self.reset()
         
+        rt.redrawViews()
+        
         # BoneChain 객체 반환
         return BoneChain.from_result(result)
     

pyjallib/max/header.py

@@ -1,114 +1,122 @@
-#!/usr/bin/env python
-# -*- coding: utf-8 -*-
-
-"""
-헤더 모듈 - max 패키지의 인스턴스 관리
-3DS Max가 실행될 때 메모리에 한번만 로드되는 패키지 인스턴스들을 관리
-"""
-
-import os
-
-from .name import Name
-from .anim import Anim
-
-from .helper import Helper
-from .constraint import Constraint
-from .bone import Bone
-
-from .mirror import Mirror
-from .layer import Layer
-from .align import Align
-from .select import Select
-from .link import Link
-
-from .bip import Bip
-from .skin import Skin
-from .skeleton import Skeleton
-
-from .twistBone import TwistBone
-from .autoClavicle import AutoClavicle
-from .groinBone import GroinBone
-from .volumeBone import VolumeBone
-from .kneeBone import KneeBone
-from .hip import Hip
-
-from .morph import Morph
-
-from .rootMotion import RootMotion
-
-from .fbxHandler import FBXHandler
-from .toolManager import ToolManager
-
-class Header:
-    """
-    JalLib.max 패키지의 헤더 모듈
-    3DS Max에서 사용하는 다양한 기능을 제공하는 클래스들을 초기화하고 관리합니다.
-    """
-    _instance = None
-    
-    @classmethod
-    def get_instance(cls):
-        """싱글톤 패턴을 구현한 인스턴스 접근 메소드"""
-        if cls._instance is None:
-            cls._instance = Header()
-        return cls._instance
-    
-    def __init__(self):
-        """
-        Header 클래스 초기화
-        """
-        self.configDir = os.path.join(os.path.dirname(__file__), "ConfigFiles")
-        self.nameConfigDir = os.path.join(self.configDir, "3DSMaxNamingConfig.json")
-
-        self.name = Name(configPath=self.nameConfigDir)
-        self.anim = Anim()
-
-        self.helper = Helper(nameService=self.name)
-        self.constraint = Constraint(nameService=self.name, helperService=self.helper)
-        self.bone = Bone(nameService=self.name, animService=self.anim, helperService=self.helper, constraintService=self.constraint)
-
-        self.mirror = Mirror(nameService=self.name, boneService=self.bone)
-        self.layer = Layer()
-        self.align = Align()
-        self.sel = Select(nameService=self.name, boneService=self.bone)
-        self.link = Link()
-
-        self.bip = Bip(animService=self.anim, nameService=self.name, boneService=self.bone)
-        self.skin = Skin()
-        self.skeleton = Skeleton(animService=self.anim, nameService=self.name, boneService=self.bone, bipService=self.bip, layerService=self.layer)
-
-        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.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.rootMotion = RootMotion(nameService=self.name, animService=self.anim, constraintService=self.constraint, helperService=self.helper, bipService=self.bip)
-        
-        self.fbx = FBXHandler()
-        
-        self.toolManager = ToolManager()
-    
-    def update_nameConifg(self, configPath):
-        """
-        이름 설정을 업데이트합니다.
-        
-        Args:
-            configPath: ConfigPath 인스턴스
-        """
-        self.name.load_from_config_file(configPath)
-
-# 모듈 레벨에서 전역 인스턴스 생성
-_pyjallibmaxheader = Header.get_instance()
-
-def get_pyjallibmaxheader():
-    """
-    jal 인스턴스를 반환합니다.
-    
-    Returns:
-        Header 인스턴스
-    """
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+
+"""
+헤더 모듈 - max 패키지의 인스턴스 관리
+3DS Max가 실행될 때 메모리에 한번만 로드되는 패키지 인스턴스들을 관리
+"""
+
+import os
+
+from .name import Name
+from .anim import Anim
+
+from .helper import Helper
+from .constraint import Constraint
+from .bone import Bone
+
+from .mirror import Mirror
+from .layer import Layer
+from .align import Align
+from .select import Select
+from .link import Link
+
+from .bip import Bip
+from .skin import Skin
+from .skeleton import Skeleton
+
+from .twistBone import TwistBone
+from .autoClavicle import AutoClavicle
+from .shoulder import Shoulder
+from .groinBone import GroinBone
+from .volumeBone import VolumeBone
+from .elbow import Elbow
+from .wrist import Wrist
+from .inguinal import Inguinal
+from .kneeBone import KneeBone
+from .hip import Hip
+
+from .morph import Morph
+
+from .rootMotion import RootMotion
+
+from .fbxHandler import FBXHandler
+from .toolManager import ToolManager
+
+class Header:
+    """
+    JalLib.max 패키지의 헤더 모듈
+    3DS Max에서 사용하는 다양한 기능을 제공하는 클래스들을 초기화하고 관리합니다.
+    """
+    _instance = None
+    
+    @classmethod
+    def get_instance(cls):
+        """싱글톤 패턴을 구현한 인스턴스 접근 메소드"""
+        if cls._instance is None:
+            cls._instance = Header()
+        return cls._instance
+    
+    def __init__(self):
+        """
+        Header 클래스 초기화
+        """
+        self.configDir = os.path.join(os.path.dirname(__file__), "ConfigFiles")
+        self.nameConfigDir = os.path.join(self.configDir, "3DSMaxNamingConfig.json")
+
+        self.name = Name(configPath=self.nameConfigDir)
+        self.anim = Anim()
+
+        self.helper = Helper(nameService=self.name)
+        self.constraint = Constraint(nameService=self.name, helperService=self.helper)
+        self.bone = Bone(nameService=self.name, animService=self.anim, helperService=self.helper, constraintService=self.constraint)
+
+        self.mirror = Mirror(nameService=self.name, boneService=self.bone)
+        self.layer = Layer()
+        self.align = Align()
+        self.sel = Select(nameService=self.name, boneService=self.bone)
+        self.link = Link()
+
+        self.bip = Bip(animService=self.anim, nameService=self.name, boneService=self.bone)
+        self.skin = Skin()
+        self.skeleton = Skeleton(animService=self.anim, nameService=self.name, boneService=self.bone, bipService=self.bip, layerService=self.layer)
+
+        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.shoulder = Shoulder(nameService=self.name, animService=self.anim, helperService=self.helper, boneService=self.bone, constraintService=self.constraint, bipService=self.bip)
+        self.volumeBone = VolumeBone(nameService=self.name, animService=self.anim, constraintService=self.constraint, boneService=self.bone, helperService=self.helper)
+        self.elbow = Elbow(nameService=self.name, animService=self.anim, constraintService=self.constraint, boneService=self.bone, helperService=self.helper)
+        self.wrist = Wrist(nameService=self.name, animService=self.anim, constraintService=self.constraint, boneService=self.bone, helperService=self.helper)
+        self.inguinal = Inguinal(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.rootMotion = RootMotion(nameService=self.name, animService=self.anim, constraintService=self.constraint, helperService=self.helper, bipService=self.bip)
+        
+        self.fbx = FBXHandler()
+        
+        self.toolManager = ToolManager()
+    
+    def update_nameConifg(self, configPath):
+        """
+        이름 설정을 업데이트합니다.
+        
+        Args:
+            configPath: ConfigPath 인스턴스
+        """
+        self.name.load_from_config_file(configPath)
+
+# 모듈 레벨에서 전역 인스턴스 생성
+_pyjallibmaxheader = Header.get_instance()
+
+def get_pyjallibmaxheader():
+    """
+    jal 인스턴스를 반환합니다.
+    
+    Returns:
+        Header 인스턴스
+    """
     return _pyjallibmaxheader

pyjallib/max/hip.py

@@ -233,6 +233,8 @@ class Hip:
         # 메소드 호출 후 데이터 초기화
         self.reset()
         
+        rt.redrawViews()
+        
         return BoneChain.from_result(result)
     
     def create_bones_from_chain(self, inBoneChain: BoneChain):

pyjallib/max/inguinal.py

@@ -0,0 +1,117 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+
+"""
+서혜부 모듈
+자동으로 서혜부 본을 생성.
+"""
+
+from pymxs import runtime as rt
+
+from .volumeBone import VolumeBone
+from .boneChain import BoneChain
+
+class Inguinal(VolumeBone):
+    def __init__(self, nameService=None, animService=None, constraintService=None, boneService=None, helperService=None):
+        super().__init__(nameService=nameService, animService=animService, constraintService=constraintService, boneService=boneService, helperService=helperService)
+    
+    def create_bones(self, inThighTwist, inPelvis, inCalf, inRotScale=0.5, inVolumeSize=6.0, inFwdRotAxis="Z", inOutRotAxis="Y", inFwdTransAxis="PosY", inOutTransAxis="PosZ", inFwdTransScale=2.0, inOutTransScale=2.0):
+        """서혜부 볼륨 본들을 생성합니다."""
+        if not rt.isValidNode(inThighTwist) or not rt.isValidNode(inPelvis) or not rt.isValidNode(inCalf):
+            return False
+        
+        # 이름 생성 (로컬 변수로 처리)
+        filteringChar = self.name._get_filtering_char(inThighTwist.name)
+        inguinalName = self.name.replace_name_part("RealName", inThighTwist.name, "Inguinal")
+        inguinalName = self.name.remove_name_part("Nub", inguinalName)
+        inguinalName = self.name.remove_name_part("Index", inguinalName)
+        inguinalRootName = self.name.replace_name_part("RealName", inguinalName, "Inguinal" + filteringChar + "Root")
+        inguinalRootDumName = self.name.replace_name_part("Type", inguinalRootName, self.name.get_name_part_value_by_description("Type", "Dummy"))
+        inguinalFwdName = self.name.replace_name_part("RealName", inguinalName, "Inguinal" + filteringChar + "Fwd")
+        inguinalOutName = self.name.replace_name_part("RealName", inguinalName, "Inguinal" + filteringChar + "Out")
+        
+        # 소문자 처리
+        if inThighTwist.name[0].islower():
+            inguinalName = inguinalName.lower()
+            inguinalRootName = inguinalRootName.lower()
+            inguinalRootDumName = inguinalRootDumName.lower()
+            inguinalFwdName = inguinalFwdName.lower()
+            inguinalOutName = inguinalOutName.lower()
+        
+        # 방향 결정
+        facingDirVec = inCalf.transform.position - inThighTwist.transform.position
+        inObjXAxisVec = inThighTwist.objectTransform.row1
+        distanceDir = 1.0 if rt.dot(inObjXAxisVec, facingDirVec) > 0 else -1.0
+        
+        # 축과 스케일 설정 - 2개의 볼륨 본: Fwd(앞), Out(바깥)
+        rotAxises = [inFwdRotAxis, inOutRotAxis]
+        transAxises = [inFwdTransAxis, inOutTransAxis]
+        transScales = [inFwdTransScale, inOutTransScale]
+        transAxisNames = [inFwdTransAxis, inOutTransAxis]
+        
+        if distanceDir < 0:
+            # Neg 접두사를 Pos로 변환하여 방향 전환
+            transAxises = ["Neg" + inFwdTransAxis[3:], "Neg" + inOutTransAxis[3:]]
+            transAxisNames = [transAxises[0], transAxises[1]]
+        
+        # 부모 클래스의 create_bones 호출
+        volumeBoneResult = super().create_bones(inThighTwist, inPelvis, inRotScale, inVolumeSize, rotAxises, transAxises, transScales)
+        
+        # volumeBoneResult가 None이면 실패 반환
+        if not volumeBoneResult:
+            return None
+        
+        # 생성된 본들의 이름 변경
+        if hasattr(volumeBoneResult, 'bones') and volumeBoneResult.bones:
+            for item in volumeBoneResult.bones:
+                if rt.matchPattern(item.name.lower(), pattern="*root*"):
+                    item.name = inguinalRootName
+                elif rt.matchPattern(item.name.lower(), pattern="*" + transAxisNames[0].lower() + "*"):
+                    item.name = inguinalFwdName
+                elif rt.matchPattern(item.name.lower(), pattern="*" + transAxisNames[1].lower() + "*"):
+                    item.name = inguinalOutName
+        
+        # 생성된 헬퍼들의 이름 변경
+        if hasattr(volumeBoneResult, 'helpers') and volumeBoneResult.helpers:
+            for item in volumeBoneResult.helpers:
+                if rt.matchPattern(item.name.lower(), pattern="*root*"):
+                    item.name = inguinalRootDumName
+        
+        result = {
+            "Bones": volumeBoneResult.bones,
+            "Helpers": volumeBoneResult.helpers,
+            "SourceBones": [inThighTwist, inPelvis, inCalf],
+            "Parameters": [inRotScale, inVolumeSize, inFwdRotAxis, inOutRotAxis, inFwdTransAxis, inOutTransAxis, inFwdTransScale, inOutTransScale]
+        }
+        
+        rt.redrawViews()
+        
+        return BoneChain.from_result(result)
+    
+    def create_bones_from_chain(self, inBoneChain: BoneChain):
+        """기존 BoneChain에서 서혜부 본들을 재생성합니다."""
+        if not inBoneChain or inBoneChain.is_empty():
+            return None
+        
+        inBoneChain.delete()
+        
+        sourceBones = inBoneChain.sourceBones
+        parameters = inBoneChain.parameters
+        
+        if len(sourceBones) < 3 or not rt.isValidNode(sourceBones[0]) or not rt.isValidNode(sourceBones[1]) or not rt.isValidNode(sourceBones[2]):
+            return None
+        
+        # 매개변수 추출
+        inThighTwist = sourceBones[0]
+        inPelvis = sourceBones[1]
+        inCalf = sourceBones[2]
+        inRotScale = parameters[0] if len(parameters) > 0 else 0.5
+        inVolumeSize = parameters[1] if len(parameters) > 1 else 6.0
+        inFwdRotAxis = parameters[2] if len(parameters) > 2 else "Z"
+        inOutRotAxis = parameters[3] if len(parameters) > 3 else "Y"
+        inFwdTransAxis = parameters[4] if len(parameters) > 4 else "PosY"
+        inOutTransAxis = parameters[5] if len(parameters) > 5 else "PosZ"
+        inFwdTransScale = parameters[6] if len(parameters) > 6 else 2.0
+        inOutTransScale = parameters[7] if len(parameters) > 7 else 2.0
+        
+        return self.create_bones(inThighTwist, inPelvis, inCalf, inRotScale, inVolumeSize, inFwdRotAxis, inOutRotAxis, inFwdTransAxis, inOutTransAxis, inFwdTransScale, inOutTransScale) 

pyjallib/max/kneeBone.py

@@ -497,6 +497,8 @@ class KneeBone:
         # 메소드 호출 후 데이터 초기화
         self.reset()
         
+        rt.redrawViews()
+        
         return BoneChain.from_result(result)
     
     def create_bones_from_chain(self, inBoneChain: BoneChain):