cmdx 프로젝트 사용 및 구성 가이드
1. 프로젝트 디렉토리 구조 및 소개
cmdx는 Maya Python API 2.0용 고성능 Python 패키지입니다. 이 프로젝트의 디렉토리 구조는 아래와 같습니다:
docs/: 문서 원본 파일이 들어 있습니다.examples/:cmdx를 사용한 예제 코드가 포함되어 있습니다.plots/: 성능 테스트 차트 데이터가 저장됩니다..gitignore: Git이 무시해야 할 파일 및 디렉토리를 정의합니다.Dockerfile: Docker 컨테이너를 생성하기 위한 파일입니다.LICENSE: 프로젝트 라이선스 파일로 BSD-2-Clause 라이선스를 사용하고 있습니다.README.md: 프로젝트에 대한 기본 정보와 설명이 포함된 자述 파일입니다.apitypes.json: API 유형을 정의하는 JSON 파일입니다.build_docs.py및build_docs.sh: 문서를 빌드하기 위한 스크립트 파일입니다.build_livedocs.py: 라이브 문서를 빌드하기 위한 스크립트 파일입니다.cmdt.py:cmdx와 관련된 내부 모듈입니다.cmdx.py:cmdx의 주 모듈 파일입니다.generate_cmdt.py:cmdt를 생성하기 위한 스크립트 파일입니다.plot.py: 성능 테스트 차트를 그리기 위한 스크립트 파일입니다.run_docs.py: 문서를 실행하기 위한 스크립트 파일입니다.run_tests.py및run_tests.sh: 테스트를 실행하기 위한 스크립트 파일입니다.setup.cfg및setup.py: 프로젝트 설정 및 설치 스크립트 파일입니다.test_performance.py: 성능 테스트를 위한 스크립트 파일입니다.tests.py: 단위 테스트를 위한 스크립트 파일입니다.
2. 프로젝트 시작 파일 소개
cmdx 프로젝트의 시작은 주로 cmdx.py 파일을 통해 이루어집니다. 이 파일은 cmdx의 모든 기능 및 인터페이스를 포함하고 있습니다. 사용자는 pip install cmdx 명령을 통해 이 프로젝트를 설치하거나, 프로젝트 내에서 직접 cmdx.py를 import할 수 있습니다.
아래는 간단한 시작 예제입니다:
import maya_api as cmdx
# 변환 노드 생성
transform_node = cmdx.create_node('transform', name='myTransformNode')
# 노드 속성 가져오기
attribute_value = cmdx.get_attribute(transform_node + '.tx')
# 노드 속성 설정
cmdx.set_attribute(transform_node + '.tx', 10)
3. 프로젝트 구성 파일 소개
cmdx 프로젝트의 구성은 주로 환경 변수 및 모듈 내의 전역 변수를 통해 제어됩니다. cmdx.py 파일内에서 cmdx의 행위를 변경할 수 있는 전역 변수들이 아래와 같이 정의되어 있습니다:
CMDX_ENABLE_NODE_REUSE: 노드 재사용을 활성화합니다.CMDX_ENABLE_PLUG_REUSE: 플러그 재사용을 활성화합니다.CMDX_ENABLE_UNDO: 되돌리기 기능을 활성화합니다.CMDX_TIMINGS: 성능 타이밍을 측정합니다.CMDX_MEMORY_HOG_MODE: 메모리 사용량을 모니터링합니다.CMDX_IGNORE_VERSION: 버전 체크를 무시합니다.CMDX_ROGUE_MODE: Rogue 모드를 활성화합니다.CMDX_SAFE_MODE: 안전 모드를 활성화합니다.
사용자는 자신의 요구사항에 따라 이 변수들을 코드 내에서 설정할 수 있습니다. 예를 들어, 노드 재사용 기능을 활성화하려면 아래와 같이 설정할 수 있습니다:
import maya_api as cmdx
cmdx.CMDX_ENABLE_NODE_REUSE = True
# 이제 생성되는 노드는 재사용 기능이 활성화됩니다
transform_node = cmdx.create_node('transform', name='reusableNode')
위 설명을 통해 cmdx 프로젝트의 디렉토리 구조, 시작 파일, 구성 파일에 대해 이해할 수 있습니다.