pyjallib 0.1.6__tar.gz → 0.1.8__tar.gz

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

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

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

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

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

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

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

@@ -34,8 +34,8 @@
         {
             "name": "Type",
             "predefinedValues": [
-                "P",
                 "Dum",
+                "P",
                 "Exp",
                 "IK",
                 "T",
@@ -57,8 +57,8 @@
             ],
             "type": "PREFIX",
             "descriptions": [
-                "Parent",
                 "Dummy",
+                "Parent",
                 "ExposeTM",
                 "IK",
                 "Target",

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

@@ -24,10 +24,14 @@ from .link import Link
 
 from .bip import Bip
 from .skin import Skin
+from .morph import Morph
 
 from .twistBone import TwistBone
 from .groinBone import GroinBone
 from .autoClavicle import AutoClavicle
+from .volumePreserveBone import VolumePreserveBone
+
+from .ui.Container import Container
 
 # 모듈 내보내기
 __all__ = [
@@ -44,7 +48,10 @@ __all__ = [
     'Link',
     'Bip',
     'Skin',
+    'Morph',
     'TwistBone',
     'GroinBone',
-    'AutoClavicle'
+    'AutoClavicle',
+    'VolumePreserveBone',
+    'Container'
 ]

{pyjallib-0.1.6 → pyjallib-0.1.8}/src/pyjallib/max/autoClavicle.py

@@ -120,3 +120,50 @@ class AutoClavicle:
         ikGoal.parent = autoClavicleRotHelper
         
         return autoClavicleBones
+    
+    def get_bones(self, inClavicle, inUpperArm):
+        """
+        자동 쇄골 뼈를 가져옵니다.
+        
+        Args:
+            inClavicle: 쇄골 뼈 객체
+            inUpperArm: 상완 뼈 객체
+            
+        Returns:
+            자동 쇄골 뼈대 배열
+        """
+        clavicleChildren = [item for item in self.bone.get_every_children(inClavicle) if rt.classOf(item) == rt.BoneGeometry]
+        upperArmChildren = [item for item in self.bone.get_every_children(inUpperArm) if rt.classOf(item) == rt.BoneGeometry]
+        returnVal = []
+        for item in clavicleChildren:
+            if item not in returnVal:
+                returnVal.append(item)
+        for item in upperArmChildren:
+            if item not in returnVal:
+                returnVal.append(item)
+        
+        return returnVal
+    
+    def get_helpers(self, inClavicle, inUpperArm):
+        """
+        자동 쇄골 헬퍼를 가져옵니다.
+        
+        Args:
+            inClavicle: 쇄골 뼈 객체
+            inUpperArm: 상완 뼈 객체
+            
+        Returns:
+            자동 쇄골 헬퍼 배열
+        """
+        clavicleChildren = [item for item in self.bone.get_every_children(inClavicle) if rt.classOf(item) == rt.Point]
+        upperArmChildren = [item for item in self.bone.get_every_children(inUpperArm) if rt.classOf(item) == rt.Point]
+        returnVal = []
+        for item in clavicleChildren:
+            if item not in returnVal:
+                returnVal.append(item)
+        for item in upperArmChildren:
+            if item not in returnVal:
+                returnVal.append(item)
+        
+        return returnVal
+        

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

@@ -212,6 +212,8 @@ class Constraint:
         """
         for item in inTargetArray:
             self.assign_pos_const(inObj, item, keepInit=keepInit)
+        
+        return self.get_pos_const(inObj)
     
     def add_target_to_pos_const(self, inObj, inTarget, inWeight):
         """
@@ -251,8 +253,36 @@ class Constraint:
         posList = self.assign_pos_list(inObj)
         
         # Position_XYZ 컨트롤러 할당
-        rt.setPropertyController(posList, "Available", rt.Position_XYZ())
+        posXYZ = rt.Position_XYZ()
+        rt.setPropertyController(posList, "Available", posXYZ)
+        posList.setActive(posList.count)
+        
+        return posXYZ
+    
+    def assign_pos_script_controller(self, inObj):
+        """
+        객체에 스크립트 기반 위치 컨트롤러를 할당.
+        
+        Args:
+            inObj: 컨트롤러를 할당할 객체
+            
+        Returns:
+            None
+        """
+        # 위치 컨트롤러가 리스트 형태가 아니면 변환
+        pos_controller = rt.getPropertyController(inObj.controller, "Position")
+        if rt.classOf(pos_controller) != rt.Position_list:
+            rt.setPropertyController(inObj.controller, "Position", rt.Position_list())
+            
+        # 위치 리스트 컨트롤러 가져오기
+        posList = self.assign_pos_list(inObj)
+        
+        # 스크립트 기반 위치 컨트롤러 할당
+        scriptPos = rt.Position_Script()
+        rt.setPropertyController(posList, "Available", scriptPos)
         posList.setActive(posList.count)
+        
+        return scriptPos
     
     def get_rot_list_controller(self, inObj):
         """
@@ -392,6 +422,8 @@ class Constraint:
         """
         for item in inTargetArray:
             self.assign_rot_const(inObj, item, keepInit=keepInit)
+        
+        return self.get_rot_const(inObj)
     
     def add_target_to_rot_const(self, inObj, inTarget, inWeight):
         """
@@ -431,8 +463,11 @@ class Constraint:
         rotList = self.assign_rot_list(inObj)
         
         # Euler_XYZ 컨트롤러 할당
-        rt.setPropertyController(rotList, "Available", rt.Euler_XYZ())
+        eulerXYZ = rt.Euler_XYZ()
+        rt.setPropertyController(rotList, "Available", eulerXYZ)
         rotList.setActive(rotList.count)
+        
+        return eulerXYZ
     
     def get_lookat(self, inObj):
         """
@@ -528,6 +563,8 @@ class Constraint:
         """
         for item in inTargetArray:
             self.assign_lookat(inObj, item, keepInit=keepInit)
+        
+        return self.get_lookat(inObj)
     
     def assign_lookat_flipless(self, inObj, inTarget):
         """

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

@@ -27,6 +27,9 @@ from .skin import Skin
 from .twistBone import TwistBone
 from .groinBone import GroinBone
 from .autoClavicle import AutoClavicle
+from .volumePreserveBone import VolumePreserveBone
+
+from .morph import Morph
 
 class Header:
     """
@@ -68,6 +71,11 @@ 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)
+        self.volumePreserveBone = VolumePreserveBone(nameService=self.name, animService=self.anim, constService=self.constraint, boneService=self.bone, helperService=self.helper)
+        
+        self.morph = Morph()
+        
+        self.tools = []
 
 # 모듈 레벨에서 전역 인스턴스 생성
 jal = Header.get_instance()

{pyjallib-0.1.6 → pyjallib-0.1.8}/src/pyjallib/max/helper.py

@@ -264,6 +264,7 @@ class Helper:
         부모 헬퍼 생성
         """
         # 선택된 객체가 있는 경우에만 처리
+        returnHelpers = []
         if rt.selection.count > 0:
             selArray = rt.getCurrentSelection()
             
@@ -297,6 +298,11 @@ class Helper:
                 # 부모 헬퍼로 이름 변경
                 finalName = self.name.replace_name_part("Type", genPoint.name, self.get_name_by_type("Parent"))
                 rt.setProperty(genPoint, "name", finalName)
+                
+                returnHelpers.append(genPoint)
+            
+        return returnHelpers
+        
     
     def create_exp_tm(self):
         """

pyjallib-0.1.8/src/pyjallib/max/morph.py

@@ -0,0 +1,406 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+
+"""
+모프(Morph) 모듈 - 3ds Max용 모프 타겟 관련 기능 제공
+원본 MAXScript의 morph.ms를 Python으로 변환하였으며, pymxs 모듈 기반으로 구현됨
+"""
+
+from dataclasses import dataclass
+from pymxs import runtime as rt
+
+
+@dataclass
+class MorphChannel:
+    """
+    모프 채널 정보를 저장하는 데이터 클래스
+    """
+    index: int = 0
+    name: str = ""
+    hasData: bool = False
+
+
+class Morph:
+    """
+    모프(Morph) 관련 기능을 제공하는 클래스.
+    MAXScript의 _Morph 구조체 개념을 Python으로 재구현한 클래스이며,
+    3ds Max의 기능들을 pymxs API를 통해 제어합니다.
+    """
+    
+    def __init__(self):
+        """클래스 초기화"""
+        self.channelMaxViewNum = 100
+    
+    def get_modifier_index(self, inObj):
+        """
+        객체에서 Morpher 모디파이어의 인덱스를 찾음
+        
+        Args:
+            inObj: 검색할 객체
+            
+        Returns:
+            Morpher 모디파이어의 인덱스 (없으면 0)
+        """
+        returnVal = 0
+        if len(inObj.modifiers) > 0:
+            for i in range(len(inObj.modifiers)):
+                if rt.classOf(inObj.modifiers[i]) == rt.Morpher:
+                    returnVal = i + 1  # MaxScript는 1부터 시작하므로 +1 추가
+        
+        return returnVal
+    
+    def get_modifier(self, inObj):
+        """
+        객체에서 Morpher 모디파이어를 찾음
+        
+        Args:
+            inObj: 검색할 객체
+            
+        Returns:
+            Morpher 모디파이어 (없으면 None)
+        """
+        returnVal = None
+        modIndex = self.get_modifier_index(inObj)
+        if modIndex > 0:
+            returnVal = inObj.modifiers[modIndex - 1]  # Python 인덱스는 0부터 시작하므로 -1 조정
+        
+        return returnVal
+    
+    def get_channel_num(self, inObj):
+        """
+        객체의 Morpher에 있는 채널 수를 반환
+        
+        Args:
+            inObj: 검색할 객체
+            
+        Returns:
+            모프 채널 수
+        """
+        returnVal = 0
+        morphMod = self.get_modifier(inObj)
+        if morphMod is not None:
+            morphChannelExistance = True
+            morphChannelCounter = 0
+            
+            while morphChannelExistance:
+                for i in range(morphChannelCounter + 1, morphChannelCounter + self.channelMaxViewNum + 1):
+                    if not rt.WM3_MC_HasData(morphMod, i):
+                        returnVal = i - 1
+                        morphChannelExistance = False
+                        break
+                
+                morphChannelCounter += self.channelMaxViewNum
+        
+        return returnVal
+    
+    def get_all_channel_info(self, inObj):
+        """
+        객체의 모든 모프 채널 정보를 가져옴
+        
+        Args:
+            inObj: 검색할 객체
+            
+        Returns:
+            MorphChannel 객체의 리스트
+        """
+        returnVal = []
+        morphMod = self.get_modifier(inObj)
+        
+        if morphMod is not None:
+            channelNum = self.get_channel_num(inObj)
+            if channelNum > 0:
+                for i in range(1, channelNum + 1):
+                    tempChannel = MorphChannel()
+                    tempChannel.index = i
+                    tempChannel.hasData = rt.WM3_MC_HasData(morphMod, i)
+                    tempChannel.name = rt.WM3_MC_GetName(morphMod, i)
+                    returnVal.append(tempChannel)
+        
+        return returnVal
+    
+    def add_target(self, inObj, inTarget, inIndex):
+        """
+        특정 인덱스에 모프 타겟 추가
+        
+        Args:
+            inObj: 모프를 적용할 객체
+            inTarget: 타겟 객체
+            inIndex: 채널 인덱스
+            
+        Returns:
+            성공 여부 (True/False)
+        """
+        returnVal = False
+        morphMod = self.get_modifier(inObj)
+        
+        if morphMod is not None:
+            rt.WM3_MC_BuildFromNode(morphMod, inIndex, inTarget)
+            returnVal = rt.WM3_MC_HasData(morphMod, inIndex)
+        
+        return returnVal
+    
+    def add_targets(self, inObj, inTargetArray):
+        """
+        여러 타겟 객체를 순서대로 모프 채널에 추가
+        
+        Args:
+            inObj: 모프를 적용할 객체
+            inTargetArray: 타겟 객체 배열
+        """
+        morphMod = self.get_modifier(inObj)
+        
+        if morphMod is not None:
+            for i in range(len(inTargetArray)):
+                rt.WM3_MC_BuildFromNode(morphMod, i + 1, inTargetArray[i])
+    
+    def get_all_channel_name(self, inObj):
+        """
+        객체의 모든 모프 채널 이름을 가져옴
+        
+        Args:
+            inObj: 검색할 객체
+            
+        Returns:
+            채널 이름 리스트
+        """
+        returnVal = []
+        channelArray = self.get_all_channel_info(inObj)
+        
+        if len(channelArray) > 0:
+            returnVal = [item.name for item in channelArray]
+        
+        return returnVal
+    
+    def get_channel_name(self, inObj, inIndex):
+        """
+        특정 인덱스의 모프 채널 이름을 가져옴
+        
+        Args:
+            inObj: 검색할 객체
+            inIndex: 채널 인덱스
+            
+        Returns:
+            채널 이름 (없으면 빈 문자열)
+        """
+        returnVal = ""
+        channelArray = self.get_all_channel_info(inObj)
+        
+        try:
+            if len(channelArray) > 0:
+                returnVal = channelArray[inIndex - 1].name
+        except:
+            returnVal = ""
+        
+        return returnVal
+    
+    def get_channelIndex(self, inObj, inName):
+        """
+        채널 이름으로 모프 채널 인덱스를 가져옴
+        
+        Args:
+            inObj: 검색할 객체
+            inName: 채널 이름
+            
+        Returns:
+            채널 인덱스 (없으면 0)
+        """
+        returnVal = 0
+        channelArray = self.get_all_channel_info(inObj)
+        
+        if len(channelArray) > 0:
+            for item in channelArray:
+                if item.name == inName:
+                    returnVal = item.index
+                    break
+        
+        return returnVal
+    
+    def get_channel_value_by_name(self, inObj, inName):
+        """
+        채널 이름으로 모프 채널 값을 가져옴
+        
+        Args:
+            inObj: 검색할 객체
+            inName: 채널 이름
+            
+        Returns:
+            채널 값 (0.0 ~ 100.0)
+        """
+        returnVal = 0.0
+        channelIndex = self.get_channelIndex(inObj, inName)
+        morphMod = self.get_modifier(inObj)
+        
+        if channelIndex > 0:
+            try:
+                returnVal = rt.WM3_MC_GetValue(morphMod, channelIndex)
+            except:
+                returnVal = 0.0
+        
+        return returnVal
+    
+    def get_channel_value_by_index(self, inObj, inIndex):
+        """
+        인덱스로 모프 채널 값을 가져옴
+        
+        Args:
+            inObj: 검색할 객체
+            inIndex: 채널 인덱스
+            
+        Returns:
+            채널 값 (0.0 ~ 100.0)
+        """
+        returnVal = 0
+        morphMod = self.get_modifier(inObj)
+        
+        if morphMod is not None:
+            try:
+                returnVal = rt.WM3_MC_GetValue(morphMod, inIndex)
+            except:
+                returnVal = 0
+        
+        return returnVal
+    
+    def set_channel_value_by_name(self, inObj, inName, inVal):
+        """
+        채널 이름으로 모프 채널 값을 설정
+        
+        Args:
+            inObj: 모프를 적용할 객체
+            inName: 채널 이름
+            inVal: 설정할 값 (0.0 ~ 100.0)
+            
+        Returns:
+            성공 여부 (True/False)
+        """
+        returnVal = False
+        morphMod = self.get_modifier(inObj)
+        channelIndex = self.get_channelIndex(inObj, inName)
+        
+        if channelIndex > 0:
+            try:
+                rt.WM3_MC_SetValue(morphMod, channelIndex, inVal)
+                returnVal = True
+            except:
+                returnVal = False
+        
+        return returnVal
+    
+    def set_channel_value_by_index(self, inObj, inIndex, inVal):
+        """
+        인덱스로 모프 채널 값을 설정
+        
+        Args:
+            inObj: 모프를 적용할 객체
+            inIndex: 채널 인덱스
+            inVal: 설정할 값 (0.0 ~ 100.0)
+            
+        Returns:
+            성공 여부 (True/False)
+        """
+        returnVal = False
+        morphMod = self.get_modifier(inObj)
+        
+        if morphMod is not None:
+            try:
+                rt.WM3_MC_SetValue(morphMod, inIndex, inVal)
+                returnVal = True
+            except:
+                returnVal = False
+        
+        return returnVal
+    
+    def set_channel_name_by_name(self, inObj, inTargetName, inNewName):
+        """
+        채널 이름을 이름으로 검색하여 변경
+        
+        Args:
+            inObj: 모프를 적용할 객체
+            inTargetName: 대상 채널의 현재 이름
+            inNewName: 설정할 새 이름
+            
+        Returns:
+            성공 여부 (True/False)
+        """
+        returnVal = False
+        channelIndex = self.get_channelIndex(inObj, inTargetName)
+        morphMod = self.get_modifier(inObj)
+        
+        if channelIndex > 0:
+            rt.WM3_MC_SetName(morphMod, channelIndex, inNewName)
+            returnVal = True
+        
+        return returnVal
+    
+    def set_channel_name_by_index(self, inObj, inIndex, inName):
+        """
+        채널 이름을 인덱스로 검색하여 변경
+        
+        Args:
+            inObj: 모프를 적용할 객체
+            inIndex: 대상 채널 인덱스
+            inName: 설정할 이름
+            
+        Returns:
+            성공 여부 (True/False)
+        """
+        returnVal = False
+        morphMod = self.get_modifier(inObj)
+        
+        if morphMod is not None:
+            try:
+                rt.WM3_MC_SetName(morphMod, inIndex, inName)
+                returnVal = True
+            except:
+                returnVal = False
+        
+        return returnVal
+    
+    def reset_all_channel_value(self, inObj):
+        """
+        모든 모프 채널 값을 0으로 리셋
+        
+        Args:
+            inObj: 리셋할 객체
+        """
+        totalChannelNum = self.get_channel_num(inObj)
+        
+        if totalChannelNum > 0:
+            for i in range(1, totalChannelNum + 1):
+                self.set_channel_value_by_index(inObj, i, 0.0)
+    
+    def extract_morph_channel_geometry(self, obj, _feedback_=False):
+        """
+        모프 채널의 기하학적 형태를 추출하여 개별 객체로 생성
+        
+        Args:
+            obj: 추출 대상 객체
+            _feedback_: 피드백 메시지 출력 여부
+            
+        Returns:
+            추출된 객체 배열
+        """
+        extractedObjs = []
+        morphMod = self.get_modifier(obj)
+        
+        if rt.IsValidMorpherMod(morphMod):
+            # 데이터가 있는 모든 채널 인덱스 수집
+            channels = [i for i in range(1, rt.WM3_NumberOfChannels(morphMod) + 1) 
+                        if rt.WM3_MC_HasData(morphMod, i)]
+            
+            for i in channels:
+                channelName = rt.WM3_MC_GetName(morphMod, i)
+                rt.WM3_MC_SetValue(morphMod, i, 100.0)
+                
+                objSnapshot = rt.snapshot(obj)
+                objSnapshot.name = channelName
+                extractedObjs.append(objSnapshot)
+                
+                rt.WM3_MC_SetValue(morphMod, i, 0.0)
+                
+                if _feedback_:
+                    print(f" - FUNCTION - [ extract_morph_channel_geometry ] - Extracted ---- {objSnapshot.name} ---- successfully!!")
+        else:
+            if _feedback_:
+                print(f" - FUNCTION - [ extract_morph_channel_geometry ] - No valid morpher found on ---- {obj.name} ---- ")
+        
+        return extractedObjs

{pyjallib-0.1.6 → pyjallib-0.1.8}/src/pyjallib/max/name.py

@@ -6,6 +6,8 @@
 3ds Max에 특화된 네이밍 기능 (pymxs 의존)
 """
 
+import os
+
 from pymxs import runtime as rt
 from pyjallib.naming import Naming
 from pyjallib.namePart import NamePart, NamePartType
@@ -35,35 +37,9 @@ class Name(Naming):
             # 사용자가 지정한 설정 파일 사용
             self.load_from_config_file(configPath=configPath)
         else:
-            # 설정 파일이 없는 경우, 기본 설정값으로 초기화
-            # Base 부분 (PREFIX 타입)
-            basePart = NamePart("Base", NamePartType.PREFIX, 
-                             ["b", "Bip001"], 
-                             ["SkinBone", "Biped"])
-            # Type 부분 (PREFIX 타입)
-            typePart = NamePart("Type", NamePartType.PREFIX, 
-                             ["P", "Dum", "Exp", "IK", "T"], 
-                             ["Parent", "Dummy", "ExposeTM", "IK", "Target"])
-            # Side 부분 (PREFIX 타입)
-            sidePart = NamePart("Side", NamePartType.PREFIX,
-                             ["L", "R"], 
-                             ["Left", "Right"],
-                             True)
-            # FrontBack 부분 (PREFIX 타입)
-            frontBackPart = NamePart("FrontBack", NamePartType.PREFIX,
-                                 ["F", "B"], 
-                                 ["Front", "Back"],
-                                 True)
-            # RealName 부분 (REALNAME 타입)
-            realNamePart = NamePart("RealName", NamePartType.REALNAME, [], [])
-            # Index 부분 (INDEX 타입)
-            indexPart = NamePart("Index", NamePartType.INDEX, [], [])
-            # Nub 부분 (SUFFIX 타입)
-            nubPart = NamePart("Nub", NamePartType.SUFFIX,
-                             ["Nub"], 
-                             ["Nub"])
-            # 기본 순서대로 설정
-            self._nameParts = [basePart, typePart, sidePart, frontBackPart, realNamePart, indexPart, nubPart]
+            configDir = os.path.join(os.path.dirname(__file__), "ConfigFiles")
+            nameConfigDir = os.path.join(configDir, "3DSMaxNamingConfig.json")
+            self.load_from_config_file(configPath=nameConfigDir)
     
     # NamePart 직접 액세스 메소드들
     # get_<NamePart 이름>_values 메소드들