Aspose.3D FOSS
Python
개발자 가이드
Rendering

Aspose.3D 로 3D 모델 렌더링

개요

Aspose.3D는 Python 애플리케이션에서 3D 모델의 렌더링 및 조작을 가능하게 합니다. 핵심 클래스들을 제공하며, 예를 들어 Scene, Node, Mesh, Geometry, Camera, 및 Light python 3d 시각화, python 3d 게임, 및 3d python을 위한 3D 콘텐츠를 구축하고 수정하기 위해 library 사용 사례.

API는 지원합니다 scene 다음 방식을 통한 그래프 구성 Node 및 Entity 계층 구조, 기하학 정의를 통해 Mesh 및 Geometry, 및 렌더링을 위한 카메라/조명 설정. AnimationClip, AnimationNode, AnimationChannel,애니메이션 기능에는 KeyframeSequence , 및 AssetInfo,키프레임 기반 모션을 위한 (읽기 전용 접근; 애니메이션 내보내기는 아직 구현되지 않음). 자산 메타데이터는 다음을 통해 접근할 수 있습니다 scene , 반면 A3DObject 객체는 다음으로부터 상속받습니다 INamedObject 명명 및 property 관리.

주요 기능

Aspose.3D는 3D 모델 작업을 위한 Python API를 제공하며, 클래스와 같은 Scene, Mesh, Node, Geometry, 및 AnimationClip. 개발자는 3D 콘텐츠를 로드, 조작 및 내보낼 수 있어 python 3d visualization, python 3d game, 그리고 3d python engine 워크플로우에 활용할 수 있습니다.

  • GLTF2 및 WAVEFRONT_OBJ을 포함한 다양한 3D 파일 형식에 대한 지원은 FileFormat 클래스를 통해 3d python 게임 및 3d python 시각화 프로젝트에서 원활한 가져오기와 내보내기를 가능하게 합니다. FBX 지원은 실험 단계이며 (토크나이저만 제공; 전체 파서는 진행 중입니다).
  • 메시 기하학을 직접 조작하는 것은 Mesh 및 Geometry 클래스는 정점, 폴리곤 및 그림자와 가시성 같은 렌더링 속성을 정밀하게 제어할 수 있게 합니다.
  • 애니메이션 구조는 AnimationClip, AnimationNode, 및 KeyframeSequence 클래스는 검사 및 구축할 수 있습니다; 이 버전에서는 애니메이션 내보내기가 아직 구현되지 않았음을 참고하십시오.
  • Scene 계층 구조 관리는 Node, Entity, A3DObject 은 복잡한 python 3d 시각화 씬을 위한 3D 객체, 카메라 및 조명의 구조화된 조직을 제공합니다.
  • 속성 및 메타데이터 처리는 PropertyCollection, AssetInfo, INamedObject 은 제목, 저자 및 키워드와 같은 문서 수준 메타데이터와 사용자 정의 속성을 지원합니다.

전제 조건

Aspose.3D를 3D python 시각화에 사용하려면, Python 3.7 이상이 설치되어 있는지 확인하십시오. 다음을 설치합니다: library pip을 사용하여 다음 명령으로 설치합니다. pip install aspose-3d-foss. 패키지는 다음과 같은 핵심 클래스를 제공합니다 Scene, Mesh, Node, Entity, Geometry, Camera, Light, 및 FileFormat 3d python 게임 및 3d python 엔진 워크플로우 작업을 위해.

pip install aspose-3d-foss
import aspose.threed
print('Installation successful')

코드 예시

Aspose.3D for Python에서 “rendering” 3D 씬을 내보내는 것은 OBJ, GLTF2, STL과 같은 지원되는 출력 형식으로 내보내는 것을 의미합니다. 픽셀 기반 래스터화는 지원되지 않으며, 사용하십시오 scene.save() 3D 출력 파일을 생성하기 위해.

from aspose.threed import Scene, FileFormat, Mesh, Node

# Load a scene from file
scene = Scene.from_file("model.obj")

# Inspect the root node
root = scene.root_node
for child in root.child_nodes:
    if isinstance(child.entity, Mesh):
        print(f"Mesh: {child.name}, control points: {len(child.entity.control_points)}")

# Export to GLTF 2.0 binary — use extension-based detection or FileFormat.GLTF2() factory
# Note: FileFormat.GLTF2_BINARY is None (stub constant, not implemented).
# Use the .glb extension for auto-detection, or FileFormat.GLTF2() for explicit format.
scene.save("output.glb")
print("Scene exported to output.glb")

모범 사례

Python 3D 시각화 또는 Python 3D 게임 엔진을 구축할 때 Aspose.3D를 사용한다면, 메모리 효율성을 우선시하고 재사용을 통해 Scene 그리고 Mesh 가능한 경우 인스턴스를 재사용하십시오. 특히 배치 3D Python 변환을 위해 많은 파일을 처리할 때, 빡빡한 루프에서 중복 객체 생성을 피하세요.

  • 재사용 Scene 파일당 새 객체를 생성하는 대신, 내보내기 사이클 전반에 걸쳐 객체를 재사용합니다.
  • 선호 Mesh 정적 지오메트리의 경우 공유 제어점을 사용해 재사용함으로써 할당 오버헤드를 줄이세요.
  • 형식별 저장 옵션을 사용하세요 (예:., GltfSaveOptions, StlSaveOptions).
  • python 3d 시각화 파이프라인에서 디스크 I/O 병목을 피하기 위해 메모리 내 내보내기 워크플로에 BytesIO 스트림을 사용하십시오.

문제 해결

이 섹션에서는 Aspose.3D를 사용하여 3D Python 시각화 및 게임 개발 워크플로우에서 발생하는 일반적인 문제들을 다룹니다. 여기에는 Scene, Node, Mesh, AnimationClip 클래스들이 포함됩니다.

지원되지 않는 작업은 NotImplementedError를 발생시킵니다.

특정 익스포터를 통한 내보내기 및 렌더링 관련 메서드(예: get_entity_renderer_key() 는 구현되지 않았으며 NotImplementedError를 발생시킵니다. 이는 현재 version Aspose.3D의 Python에 대한 기능이 미완성되었기 때문입니다. 런타임 오류를 방지하려면 지원되지 않는 메서드를 호출하기 전에 API 표면에서 메서드 가용성을 확인하세요. 사용하십시오 Scene.from_file() 그리고 scene.save() 지원되는 로드 및 내보내기 워크플로에 대해.

NotImplementedError를 발생시키는 Mesh 메서드

다음 Mesh 메서드가 API 표면에 선언되어 있지만 발생시킵니다 NotImplementedError 이번 릴리스에서는. 로드되었거나 생성된 어떤 인스턴스에서도 호출하지 마세요 Mesh 인스턴스:

메서드노트
mesh.optimize()메시 최적화 — 아직 구현되지 않음
mesh.do_boolean(...)일반 불리언 연산 — 아래의 특정 메서드를 사용하세요
mesh.union(other)CSG union — 아직 구현되지 않음
mesh.difference(other)CSG difference — 아직 구현되지 않음
mesh.intersect(other)CSG intersection — 아직 구현되지 않음
mesh.is_manifold()다양체 테스트 — 아직 구현되지 않음
Mesh(height_map, ...)높이 맵 생성자 변형 — 아직 구현되지 않음

워크플로우에 이러한 연산이 필요하다면, 다음과 같은 라이브러리에서 기하학을 처리하세요 trimesh 또는 open3d 그리고 결과를 다음을 사용해 다시 가져오세요 Scene.from_file() 또는 새로 생성하여 Mesh 원시 데이터에서 control_points 그리고 polygons.

애니메이션 기능은 읽기 전용입니다.

애니메이션 관련 클래스는 예를 들어 AnimationClip, AnimationNode, AnimationChannel, 그리고 KeyframeSequence 검사할 수는 있지만 animation export는 작동하지 않습니다. python 3d 게임 엔진이나 python 3d 시각화 도구를 개발하는 개발자는 전체 export 지원이 출시될 때까지 animation data를 읽기 전용으로 취급해야 합니다.

텍스처 이미지 로딩은 지원되지 않습니다.

텍스처 이미지를 로드하는 중 materials Aspose.3D에서는 구현되지 않았습니다. 설령 material properties 가 다음을 통해 설정된 경우 Mesh 또는 Geometry, 텍스처 매핑이 올바르게 렌더링되지 않습니다. 정적 모델 내보내기의 경우 이미지 기반 텍스처 대신 단색 또는 정점 기반 셰이딩을 사용하십시오.

Camera 및 Geometry 렌더링은 지원되지 않습니다

다음 Camera 및 Geometry 클래스는 렌더링 관련 메서드(예:)에 대해 NotImplementedError를 발생시킵니다 get_entity_renderer_key(). 이러한 클래스는 인스턴스화 및 구성은 가능하지만 픽셀 래스터화 파이프라인에서는 사용할 수 없습니다. 사용 Node 및 Mesh 용 scene 구성 및 내보내기 워크플로우.

FAQ

Aspose.3D for Python가 래스터화된 이미지 출력(PNG, JPEG)을 지원합니까?

아니요. Aspose.3D for Python는 픽셀 기반 래스터화를 수행하지 않습니다. 이 라이브러리에서 “렌더링”은 OBJ, GLTF2, STL, 3MF와 같은 3D 출력 형식으로 씬을 내보내는 것을 의미합니다, 사용하여 scene.save(). 이미지 출력을 위해서는 별도의 렌더링 엔진과 통합하십시오.

지원되는 내보내기 형식은 무엇입니까?

지원되는 내보내기 형식에는 OBJ, glTF 2.0 / GLB, STL (binary 및 ASCII), COLLADA (DAE), 및 3MF가 포함됩니다. 호출 시 파일 확장자를 사용하십시오 scene.save() 자동 형식 감지를 위해. 명시적인 형식 제어를 위해서는 팩터리 메서드를 사용하십시오 FileFormat.WAVEFRONT_OBJ(), FileFormat.GLTF2(), 및 FileFormat.MICROSOFT_3MF_FORMAT(). 참고: 속성 스타일 상수는 다음과 같습니다 FileFormat.GLTF2_BINARY, FileFormat.GLTF, FileFormat.STLASCII, FileFormat.STL_BINARY, 및 FileFormat.MICROSOFT_3MF 은(는) None 스텁이며 사용해서는 안 됩니다. FBX 내보내기는 다음을 발생시킵니다 NotImplementedError 현재 버전에서.

로드된 3D 파일에서 애니메이션 데이터를 읽을 수 있나요?

로드된 파일의 애니메이션 구조는 다음을 통해 접근할 수 있습니다 AnimationClip, AnimationNode, 및 관련 클래스이지만, 애니메이션 데이터를 수정하거나 재내보내는 것은 아직 지원되지 않으며 NotImplementedError를 발생시킵니다.

API 레퍼런스 요약

Aspose.3D는 Python에서 3D 씬을 조작하기 위한 핵심 클래스를 제공하며, 다음을 포함합니다 Scene, Node, Mesh, 및 Geometry. python 3d 게임, python 3d 엔진, 또는 python 3d 시각화 프로젝트를 진행하는 개발자는 이러한 클래스를 사용하여 프로그래밍 방식으로 3D 콘텐츠를 구축하고 수정할 수 있습니다. The Scene 클래스는 루트 컨테이너 역할을 하며, 반면 Node 객체는 scene 그래프 계층 구조를 형성하고, 그리고 Mesh 인스턴스는 기하학적 형태를 정의하며 Geometry 데이터를.

Aspose.3D의 애니메이션 지원은 다음에 의존합니다 AnimationClip, AnimationNode, AnimationChannel, 그리고 KeyframeSequence 정의하기 위해 time-기반 변환. 애니메이션 내보내기가 아직 구현되지 않았지만, 개발자는 이러한 클래스를 사용하여 애니메이션 구조를 여전히 검사할 수 있습니다. 그 Extrapolation 클래스와 ExtrapolationType enum은 키프레임 범위 외의 동작을 제어할 수 있게 합니다.

Entity-level properties 가시성 및 그림자 투사와 같은 기능은 다음을 통해 노출됩니다. Geometry.visible, Geometry.cast_shadows, 그리고 Geometry.receive_shadows. Scene 그래프 관계는 다음을 통해 관리됩니다. Entity.parent_node 그리고 Entity.parent_nodes, 반면에 Node 객체는 노출합니다 GlobalTransform 에 대한 translation, rotation, 그리고 scale. Camera 그리고 Light entities 으로부터 상속받습니다 Entity 및 다음을 통한 제외를 지원합니다 excluded.

또 보기

Aspose.3D는 Python에서 3D 모델 조작을 위한 핵심 클래스를 제공하며, 포함합니다 Scene, Mesh, Node, Geometry, 그리고 AnimationClip. 이러한 클래스들은 일관된 API 인터페이스를 통해 파이썬 3D 시각화, 파이썬 3D 게임 개발 및 3D 파이썬 워크플로우를 지원합니다.

 한국어