pyjallib 0.1.10__py3-none-any.whl → 0.1.12__py3-none-any.whl

pyjallib/max/autoClavicleChain.py

@@ -1,173 +0,0 @@
-#!/usr/bin/env python
-# -*- coding: utf-8 -*-
-
-"""
-자동 쇄골 체인(AutoClavicle Chain) 관련 기능을 제공하는 클래스.
-AutoClavicle 클래스가 생성한 자동 쇄골 뼈대들을 관리하고 접근하는 인터페이스를 제공합니다.
-
-Examples:
-    # 자동 쇄골 체인 생성 예시
-    from pyjallib.max import AutoClavicle, AutoClavicleChain
-    from pymxs import runtime as rt
-    
-    # 선택된 쇄골과 상완 객체
-    clavicle = rt.selection[0]
-    upperArm = rt.selection[1]
-    
-    # AutoClavicle 클래스 인스턴스 생성
-    auto_clavicle = AutoClavicle()
-    
-    # 자동 쇄골 뼈대 생성
-    clavicle_bones = auto_clavicle.create_bones(clavicle, upperArm, liftScale=0.8)
-    
-    # 생성된 뼈대로 AutoClavicleChain 인스턴스 생성
-    chain = AutoClavicleChain.from_auto_clavicle_result(
-        {
-            "Bones": clavicle_bones,
-            "Helpers": auto_clavicle.helpers,
-            "Clavicle": clavicle,
-            "UpperArm": upperArm,
-            "LiftScale": 0.8
-        }
-    )
-    
-    # 체인 관리 기능 사용
-    bone = chain.get_bone()
-    
-    # 체인의 모든 뼈대 이름 변경
-    chain.rename_bones(prefix="character_", suffix="_autoClavicle")
-    
-    # 체인의 LiftScale 수정
-    chain.update_lift_scale(0.9)
-    
-    # 필요 없어지면 체인의 모든 뼈대와 헬퍼 삭제
-    # chain.delete_all()
-"""
-
-from pymxs import runtime as rt
-from pyjallib.max.header import get_pyjallibmaxheader
-jal = get_pyjallibmaxheader()
-
-
-class AutoClavicleChain:
-    def __init__(self, inResult):
-        """
-        클래스 초기화.
-        
-        Args:
-            inResult: AutoClavicle 클래스의 생성 결과 (딕셔너리)
-        """
-        self.bones = inResult.get("Bones", [])
-        self.helpers = inResult.get("Helpers", [])
-        self.clavicle = inResult.get("Clavicle", None)
-        self.upperArm = inResult.get("UpperArm", None)
-        self.liftScale = inResult.get("LiftScale", 0.8)
-    
-    def get_bones(self):
-        """
-        체인의 모든 뼈대 가져오기
-        
-        Returns:
-            모든 뼈대 객체의 배열
-        """
-        if self.is_empty():
-            return []
-        
-        return self.bones
-    
-    def get_helpers(self):
-        """
-        체인의 모든 헬퍼 가져오기
-        
-        Returns:
-            모든 헬퍼 객체의 배열
-        """
-        if self.is_empty():
-            return []
-        
-        return self.helpers
-    
-    def is_empty(self):
-        """
-        체인이 비어있는지 확인
-        
-        Returns:
-            체인이 비어있으면 True, 아니면 False
-        """
-        return len(self.bones) == 0
-    
-    def clear(self):
-        """체인의 모든 뼈대와 헬퍼 참조 제거"""
-        self.bones = []
-        self.helpers = []
-        self.clavicle = None
-        self.upperArm = None
-    
-    def delete_all(self):
-        """
-        체인의 모든 뼈대와 헬퍼를 3ds Max 씬에서 삭제
-        
-        Returns:
-            삭제 성공 여부 (boolean)
-        """
-        if self.is_empty():
-            return False
-            
-        try:
-            for bone in self.bones:
-                if rt.isValidNode(bone):
-                    rt.delete(bone)
-            
-            for helper in self.helpers:
-                if rt.isValidNode(helper):
-                    rt.delete(helper)
-                
-            self.clear()
-            return True
-        except:
-            return False
-    
-    def update_lift_scale(self, newLiftScale=0.8):
-        """
-        자동 쇄골의 들어올림 스케일 업데이트
-        
-        Args:
-            newLiftScale: 새로운 들어올림 스케일 (기본값: 0.8)
-            
-        Returns:
-            업데이트 성공 여부 (boolean)
-        """
-        if self.is_empty() or not rt.isValidNode(self.clavicle) or not rt.isValidNode(self.upperArm):
-            return False
-        
-        clavicle = self.clavicle
-        upperArm = self.upperArm
-        
-        # 기존 본과 헬퍼 삭제
-        self.delete_all()
-        
-        # 새로운 LiftScale 값 설정
-        self.liftScale = newLiftScale
-        self.clavicle = clavicle
-        self.upperArm = upperArm
-        
-        # 재생성
-        result = jal.autoClavicle.create_bones(self.clavicle, self.upperArm, self.liftScale)
-        if result:
-            return True
-        
-        return False
-    
-    @classmethod
-    def from_auto_clavicle_result(cls, inResult):
-        """
-        AutoClavicle 클래스의 결과로부터 AutoClavicleChain 인스턴스 생성
-        
-        Args:
-            inResult: AutoClavicle 클래스의 메서드가 반환한 결과값 딕셔너리
-            
-        Returns:
-            AutoClavicleChain 인스턴스
-        """
-        chain = cls(inResult)
-        return chain

pyjallib/max/groinBoneChain.py

@@ -1,173 +0,0 @@
-#!/usr/bin/env python
-# -*- coding: utf-8 -*-
-
-"""
-고간 부 본 체인(Groin Bone Chain) 관련 기능을 제공하는 클래스.
-GroinBone 클래스가 생성한 고간 부 본들과 헬퍼들을 관리하고 접근하는 인터페이스를 제공합니다.
-
-Examples:
-    # GroinBone 클래스로 고간 본 생성 후 체인으로 관리하기
-    groin_bone = GroinBone()
-    biped_obj = rt.selection[0]  # 선택된 바이패드 객체
-    
-    # 고간 본 생성
-    success = groin_bone.create_bone(biped_obj, 40.0, 60.0)
-    if success:
-        # 생성된 본과 헬퍼로 체인 생성
-        chain = GroinBoneChain.from_groin_bone_result(
-            groin_bone.genBones, 
-            groin_bone.genHelpers,
-            biped_obj,
-            40.0,
-            60.0
-        )
-        
-        # 체인 가중치 업데이트
-        chain.update_weights(35.0, 65.0)
-        
-        # 본과 헬퍼 이름 변경
-        chain.rename_bones(prefix="Character_", suffix="_Groin")
-        chain.rename_helpers(prefix="Character_", suffix="_Helper")
-        
-        # 현재 가중치 값 확인
-        pelvis_w, thigh_w = chain.get_weights()
-        print(f"Current weights: Pelvis={pelvis_w}, Thigh={thigh_w}")
-        
-        # 체인 삭제
-        # chain.delete_all()
-"""
-
-from pymxs import runtime as rt
-from pyjallib.max.header import get_pyjallibmaxheader
-jal = get_pyjallibmaxheader()
-
-class GroinBoneChain:
-    def __init__(self, inResult):
-        """
-        클래스 초기화.
-        
-        Args:
-            bones: 고간 부 본 체인을 구성하는 뼈대 배열 (기본값: None)
-            helpers: 고간 부 본과 연관된 헬퍼 객체 배열 (기본값: None)
-            biped_obj: 연관된 Biped 객체 (기본값: None)
-        """
-        self.pelvis =inResult["Pelvis"]
-        self.lThighTwist = inResult["LThighTwist"]
-        self.rThighTwist = inResult["RThighTwist"]
-        self.bones = inResult["Bones"]
-        self.helpers = inResult["Helpers"]
-        self.pelvisWeight = inResult["PelvisWeight"]
-        self.thighWeight = inResult["ThighWeight"]
-    
-    def is_empty(self):
-        """
-        체인이 비어있는지 확인
-        
-        Returns:
-            본과 헬퍼가 모두 비어있으면 True, 아니면 False
-        """
-        return len(self.bones) == 0 and len(self.helpers) == 0
-    
-    def clear(self):
-        """체인의 모든 본과 헬퍼 참조 제거"""
-        self.bones = []
-        self.helpers = []
-        self.pelvis = None
-        self.lThighTwist = None
-        self.rThighTwist = None
-        self.pelvisWeight = 40.0  # 기본 골반 가중치
-        self.thighWeight = 60.0   # 기본 허벅지 가중치
-        
-    def delete(self):
-        """
-        체인의 모든 본과 헬퍼를 3ds Max 씬에서 삭제
-        
-        Returns:
-            삭제 성공 여부 (boolean)
-        """
-        if self.is_empty():
-            return False
-            
-        try:
-            rt.delete(self.bones)
-            rt.delete(self.helpers)
-            return True
-        except:
-            return False
-    
-    def delete_all(self):
-        """
-        체인의 모든 본과 헬퍼를 3ds Max 씬에서 삭제
-        
-        Returns:
-            삭제 성공 여부 (boolean)
-        """
-        if self.is_empty():
-            return False
-            
-        try:
-            rt.delete(self.bones)
-            rt.delete(self.helpers)
-            self.clear()
-            return True
-        except:
-            return False
-    
-    def update_weights(self, pelvisWeight=None, thighWeight=None):
-        """
-        고간 부 본의 가중치 업데이트
-        
-        Args:
-            pelvisWeight: 골반 가중치 (None인 경우 현재 값 유지)
-            thighWeight: 허벅지 가중치 (None인 경우 현재 값 유지)
-            
-        Returns:
-            업데이트 성공 여부 (boolean)
-        """
-        if self.is_empty():
-            return False
-            
-        # 새 가중치 설정
-        if pelvisWeight is not None:
-            self.pelvisWeight = pelvisWeight
-        if thighWeight is not None:
-            self.thighWeight = thighWeight
-        
-        self.delete()
-        result = jal.groinBone.create_bone(
-            self.pelvis, 
-            self.lThighTwist, 
-            self.rThighTwist, 
-            self.pelvisWeight, 
-            self.thighWeight
-        )
-        self.bones = result["Bones"]
-        self.helpers = result["Helpers"]
-            
-    def get_weights(self):
-        """
-        현재 설정된 가중치 값 가져오기
-        
-        Returns:
-            (pelvis_weight, thigh_weight) 형태의 튜플
-        """
-        return (self.pelvis_weight, self.thigh_weight)
-    
-    @classmethod
-    def from_groin_bone_result(cls, inResult):
-        """
-        GroinBone 클래스의 결과로부터 GroinBoneChain 인스턴스 생성
-        
-        Args:
-            bones: GroinBone 클래스가 생성한 뼈대 배열
-            helpers: GroinBone 클래스가 생성한 헬퍼 배열
-            biped_obj: 연관된 Biped 객체 (기본값: None)
-            pelvisWeight: 골반 가중치 (기본값: 40.0)
-            thighWeight: 허벅지 가중치 (기본값: 60.0)
-            
-        Returns:
-            GroinBoneChain 인스턴스
-        """
-        chain = cls(inResult)
-        
-        return chain

pyjallib/max/twistBoneChain.py

@@ -1,162 +0,0 @@
-#!/usr/bin/env python
-# -*- coding: utf-8 -*-
-
-"""
-트위스트 뼈대 체인(Twist Bone Chain) 모듈 - 트위스트 뼈대 그룹 관리 기능 제공
-
-이 모듈은 TwistBone 클래스가 생성한 트위스트 뼈대들을 하나의 체인으로 관리하고
-간편하게 접근할 수 있는 인터페이스를 제공합니다. 일반적으로 캐릭터 리깅에서
-팔, 다리 등의 관절 부위에 자연스러운 회전 움직임을 구현하기 위해 사용됩니다.
-
-TwistBoneChain 클래스는 다음과 같은 주요 기능을 제공합니다:
-- 트위스트 뼈대 체인의 개별 뼈대 접근
-- 체인의 첫 번째/마지막 뼈대 쉽게 가져오기
-- 체인의 모든 뼈대를 한 번에 삭제하기
-- 체인의 타입 정보 관리 (상체/하체)
-
-Examples:
-    # 트위스트 체인 생성 및 관리 예시
-    from pyjallib.max import TwistBone, TwistBoneChain
-    from pymxs import runtime as rt
-    
-    # 트위스트 뼈대를 생성할 뼈대 객체와 그 자식 객체 가져오기
-    parent_bone = rt.selection[0]  # 예: 상완 뼈대
-    child_bone = parent_bone.children[0]  # 예: 전완 뼈대
-    
-    # TwistBone 클래스 인스턴스 생성
-    twist_bone = TwistBone()
-    
-    # 상완(Upper) 타입의 트위스트 뼈대 체인 생성 (4개의 뼈대)
-    twist_result = twist_bone.create_upper_limb_bones(parent_bone, child_bone, 4)
-    
-    # 생성된 결과로 TwistBoneChain 인스턴스 생성
-    chain = TwistBoneChain.from_twist_bone_result(twist_result)
-    
-    # 체인 관리 기능 사용
-    first_bone = chain.get_first_bone()  # 첫 번째 트위스트 뼈대
-    last_bone = chain.get_last_bone()    # 마지막 트위스트 뼈대
-    middle_bone = chain.get_bone_at_index(2)  # 특정 인덱스의 뼈대
-    
-    # 체인 정보 확인
-    bone_count = chain.get_count()  # 체인의 뼈대 개수
-    chain_type = chain.get_type()   # 체인의 타입 (Upper 또는 Lower)
-    
-    # 필요 없어지면 체인의 모든 뼈대 삭제
-    # chain.delete_all()
-"""
-
-from pymxs import runtime as rt
-from pyjallib.max.header import get_pyjallibmaxheader
-jal = get_pyjallibmaxheader()
-
-class TwistBoneChain:
-    def __init__(self, inResult):
-        """
-        클래스 초기화.
-        
-        Args:
-            bones: 트위스트 뼈대 체인을 구성하는 뼈대 배열 (기본값: None)
-        """
-        self.bones = inResult["Bones"]
-        self.type = inResult["Type"]
-        self.limb = inResult["Limb"]
-        self.child = inResult["Child"]
-        self.twistNum = inResult["TwistNum"]
-    
-    def get_bone_at_index(self, index):
-        """
-        지정된 인덱스의 트위스트 뼈대 가져오기
-        
-        Args:
-            index: 가져올 뼈대의 인덱스
-            
-        Returns:
-            해당 인덱스의 뼈대 객체 또는 None (인덱스가 범위를 벗어난 경우)
-        """
-        if 0 <= index < len(self.bones):
-            return self.bones[index]
-        return None
-    
-    def get_first_bone(self):
-        """
-        체인의 첫 번째 트위스트 뼈대 가져오기
-        
-        Returns:
-            첫 번째 뼈대 객체 또는 None (체인이 비어있는 경우)
-        """
-        return self.bones[0] if self.bones else None
-    
-    def get_last_bone(self):
-        """
-        체인의 마지막 트위스트 뼈대 가져오기
-        
-        Returns:
-            마지막 뼈대 객체 또는 None (체인이 비어있는 경우)
-        """
-        return self.bones[-1] if self.bones else None
-    
-    def get_count(self):
-        """
-        체인의 트위스트 뼈대 개수 가져오기
-        
-        Returns:
-            뼈대 개수
-        """
-        return self.twistNum
-    
-    def is_empty(self):
-        """
-        체인이 비어있는지 확인
-        
-        Returns:
-            체인이 비어있으면 True, 아니면 False
-        """
-        return len(self.bones) == 0
-    
-    def clear(self):
-        """체인의 모든 뼈대 제거"""
-        self.bones = []
-    
-    def delete_all(self):
-        """
-        체인의 모든 뼈대를 3ds Max 씬에서 삭제
-        
-        Returns:
-            삭제 성공 여부 (boolean)
-        """
-        if not self.bones:
-            return False
-            
-        try:
-            for bone in self.bones:
-                rt.delete(bone)
-            self.clear()
-            return True
-        except:
-            return False
-    
-    def get_type(self):
-        """
-        트위스트 뼈대 체인의 타입을 반환합니다.
-        
-        Returns:
-            트위스트 뼈대 체인의 타입 ('upperArm', 'foreArm', 'thigh', 'calf', 'bend' 중 하나) 또는 None
-        """
-        return self.type
-    
-    @classmethod
-    def from_twist_bone_result(cls, inResult):
-        """
-        TwistBone 클래스의 결과로부터 TwistBoneChain 인스턴스 생성
-        
-        Args:
-            twist_bone_result: TwistBone 클래스의 메서드가 반환한 뼈대 배열
-            source_bone: 원본 뼈대 객체 (기본값: None)
-            type_name: 트위스트 뼈대 타입 (기본값: None)
-            
-        Returns:
-            TwistBoneChain 인스턴스
-        """
-        chain = cls(inResult)
-            
-        return chain