Aspose.3D FOSS for TypeScript

다음에 대한 API 레퍼런스 @aspose/3d 버전 24.12.0. 다음을 통해 설치:

npm install @aspose/3d

런타임: Node.js 18, 20, 22+ · 언어: TypeScript 5.0+ / JavaScript (CommonJS) · 라이선스: MIT

핵심 씬 그래프

ImageRenderOptions

3D 씬의 루트 컨테이너입니다. 호출 scene.open() 또는 scene.openFromBuffer() 파일을 로드하고, 그리고 scene.save() 출력을 기록합니다. 노출 scene.rootNode 노드 계층 구조의 진입점으로.

ImageRenderOptions

씬 트리에서 이름이 지정된 노드입니다. 다음을 보유합니다 Transform, 선택적인 entity (mesh, camera, light, 또는 기타 SceneObject), 그리고 0개 이상의 자식 노드에 접근 가능 childNodes.

ImageRenderOptions

에 부착될 수 있는 모든 객체의 기본 클래스 Node 를 기본 엔터티로 사용합니다. 다음에 의해 서브클래스화됨 Mesh, Camera, Light, 및 기타.

SceneObject

씬에 속하는 이름이 지정된 객체를 위한 추상 기본 클래스입니다. 다음을 제공합니다 name 노드, 엔터티 및 자산 수준 객체가 공유하는 속성 및 씬 멤버십 추적.

A3DObject

모든 Aspose.3D 객체의 루트 기본 클래스. 속성 시스템을 제공합니다 (getProperty, setProperty) 및 name 모든 public 클래스가 상속받는 필드.

기하학 및 메쉬

ImageRenderOptions

다각형 메쉬를 나타냅니다. 포함하는 것은 controlPoints 배열 Vector4 정점 및 다각형 정의가 을 통해 생성됩니다 createPolygon(). 호출 triangulate() 내보내기 전에 모든 다각형을 삼각형으로 변환합니다.

ImageRenderOptions

모든 기하학 유형의 기본 클래스입니다. 보유합니다 controlPoints 및 기하학에 연결된 정점 요소(법선, UV, 색상) 컬렉션을.

VertexElement

정점당 속성 채널에 연결된 기본 클래스 Geometry. 서브클래스는 타입이 지정된 데이터 배열과 mappingMode / referenceMode 메타데이터를 포함합니다.

VertexElementNormal

A VertexElement 표면 법선을 저장하는 서브클래스입니다. 데이터는 내부적으로 다음과 같이 저장됩니다 FVector4[] (상속받은 VertexElementFVector). 올바른 조명을 위해 대부분의 렌더러에서 필요합니다.

VertexElementUV

A VertexElement 2D 텍스처 좌표를 저장하는 서브클래스입니다. 단일 메쉬는 서로 다른 텍스처 레이어를 위해 여러 UV 세트를 가질 수 있습니다.

VertexElementVertexColor

A VertexElement 각 정점의 RGBA 색상 값을 저장하는 서브클래스입니다.

VertexElementType

속성 채널 유형을 열거한 것으로 a VertexElement 표현할 수 있습니다 (예:., NORMAL, UV, VERTEX_COLOR, TANGENT, BINORMAL).

MappingMode

요소 데이터가 기하학에 매핑되는 방식을 제어하는 열거형: CONTROL_POINT, POLYGON_VERTEX, POLYGON, EDGE, 또는 ALL_SAME.

ReferenceMode

요소 인덱스가 데이터를 참조하는 방식을 제어하는 열거형: DIRECT (일대일) 또는 INDEX_TO_DIRECT (인덱스 배열을 통해).

TextureMapping

텍스처 채널 의미의 열거형: DIFFUSE, SPECULAR, NORMAL, EMISSIVE, BUMP, 등.

Transform 및 Spatial

ImageRenderOptions

로컬 위치를 보유합니다 (translation), 회전 (rotation 로 Quaternion), 그리고 스케일 (scaling) 의 a Node. 여기서의 변경은 노드와 그 모든 자식에게 영향을 미칩니다.

GlobalTransform

노드의 월드 스페이스 변환에 대한 읽기 전용 뷰로, 모든 조상을 누적하여 계산됩니다. Transform 값. 접근 방법: node.globalTransform.

BoundingBox

축에 정렬된 경계 상자는 a minimum 와 maximum Vector3 코너. 메쉬 또는 씬의 공간 범위를 설명하는 데 사용됩니다.

ImageRenderOptions

Material, LambertMaterial, PhongMaterial, PbrMaterial

Material은 모든 재질 타입의 추상 기본 클래스입니다. 세 가지 구체적인 구현이 제공됩니다:

  • LambertMaterial — 주변광, 확산광 및 방출 색상 채널만 있는 디퓨즈 전용. 비반사 표면에 적합합니다.
  • PhongMaterial — 확장 LambertMaterial — Phong 셰이딩을 위한 반사 색상 및 광택 속성을 포함합니다.
  • PbrMaterial — 금속성, 거칠기, 기본 색상 및 노멀맵 채널을 갖는 물리 기반 렌더링 재질입니다. glTF 2.0 PBR 재질 모델에 직접 매핑됩니다.

카메라 및 조명

ImageRenderOptions

투영 유형, 시야각, 근거리/원거리 클립 거리 및 종횡비 속성을 가진 뷰포인트 노드 엔터티.

ImageRenderOptions

광원 노드 엔티티입니다. 유형은 다음에 의해 제어됩니다. LightType 열거형.

LightType

지원되는 광원 종류의 열거형: POINT, DIRECTIONAL, SPOT, AREA, VOLUME.

ProjectionType

카메라 투영 모드의 열거형: PERSPECTIVE 및 ORTHOGRAPHIC.

수학 유틸리티

ImageRenderOptions

3개의 구성 요소를 가진 부동소수점 벡터이며 x, y, z 필드와 일반적인 산술 메서드 (dot, cross, normalize, minus, times). 다음에서 내보냅니다 @aspose/3d/utilities.

ImageRenderOptions

4개의 구성 요소를 가진 부동소수점 벡터이며 x, y, z, w 필드. 다음의 항목 유형으로 사용됩니다 Mesh.controlPoints.

ImageRenderOptions

2개의 구성 요소를 가진 배정밀도 벡터이며 x 및 y 필드. UV 텍스처 좌표에 사용됩니다.

FVector3

정점 요소 데이터 배열에서 노멀 및 탄젠트를 위해 사용되는, 컴팩트한 3구성 요소 단정밀도 부동소수점 벡터.

ImageRenderOptions

4×4 변환 행렬입니다. 연결, 역변환, 전치 및 변환, 회전, 스케일 구성 요소로 분해를 지원합니다. 내보낸 위치 @aspose/3d/utilities.

ImageRenderOptions

짐벌 락 없이 회전을 나타내는 단위 쿼터니언입니다. 제공합니다 slerp() 부드러운 보간 및 오일러 각도와의 상호 변환을 위해 Matrix4. 내보낸 위치 @aspose/3d/utilities.

ImageRenderOptions

AnimationClip

이름이 지정된, 시간 제한이 있는 컬렉션 AnimationNode tracks. FBX 또는 COLLADA 파일에서 로드된 키프레임 애니메이션 데이터의 기본 컨테이너.

AnimationNode

특정 씬 객체의 속성 경로를 대상으로 하는 이름이 지정된 애니메이션 트랙. 하나 이상의 AnimationChannel objects.

AnimationChannel

단일 애니메이션 속성 채널 within an AnimationNode. 보유하는 a KeyframeSequence 시간/값 쌍.

KeyFrame

단일 시간/값 샘플 in a KeyframeSequence. 타임스탬프(초), 값 및 보간을 위한 탄젠트 정보를 포함합니다.

KeyframeSequence

정렬된 목록 of KeyFrame 하나의 속성 채널에 대한 샘플과 함께 the Interpolation 및 Extrapolation 재생을 제어하는 설정.

ImageRenderOptions

키프레임 보간 모드의 열거형. 알려진 멤버에는 LINEAR 와 CONSTANT. 추가 멤버 예시 such as BEZIER 사용 가능할 수 있습니다.

ImageRenderOptions

키프레임 범위 외부(첫 번째 키 이전 및 마지막 키 이후)의 동작을 정의합니다. 다음에 의해 제어됩니다. ExtrapolationType.

StepMode

경계에서 단계적(상수) 보간이 적용되는 방식을 제어하는 열거형.

WeightedMode

베지어 탄젠트 가중치 처리에 대한 열거형: NONE, OUT_WEIGHT, NEXT_IN_WEIGHT, 또는 BOTH.

ExtrapolationType

범위 초과 동작 열거: CONSTANT, GRADIENT, CYCLE, CYCLE_RELATIVE, 및 OSCILLATE.

포맷 I/O

FileFormat

3D 파일 형식에 대한 기본 설명자. 지원되는 각 형식은 via를 통해 구체적인 싱글톤을 제공합니다 getInstance().

ImageRenderOptions

형식별 가져오기 구현을 위한 기본 클래스. 직접 인스턴스화되지 않으며; 내부적으로 by에 의해 호출됩니다 scene.open().

ImageRenderOptions

형식별 내보내기 구현을 위한 기본 클래스. 직접 인스턴스화되지 않으며; 내부적으로 by에 의해 호출됩니다 scene.save().

LoadOptions

형식별 로드 옵션 객체를 위한 기본 클래스. 서브클래스 인스턴스를 to에 전달하십시오 scene.open() 또는 scene.openFromBuffer().

SaveOptions

형식별 저장 옵션 객체를 위한 기본 클래스. 서브클래스 인스턴스를 to에 전달하십시오 scene.save().

IOService

임포터와 익스포터를 위해 파일 시스템 및 버퍼 I/O를 추상화하는 내부 서비스 인터페이스입니다.

OBJ 포맷

OBJ는 가져오기와 내보내기를 모두 지원합니다. OBJ로 저장할 때, 재질 라이브러리 (.mtl)는 자동으로 옆에 기록됩니다 .obj 파일.

ObjImporter

Wavefront OBJ 파일을 읽고, 해결하는 내부 가져오기 .mtl 재질 라이브러리를 해결하고, 를 채웁니다 Scene. 자동으로 호출됩니다 when ObjLoadOptions 가 전달될 때 scene.open().

ObjExporter

Wavefront OBJ 파일을 쓰는 내부 내보내기 구현. 보조 .mtl material library는 자동으로 작성됩니다. 호출될 때 scene.save() 대상은 .obj 경로.

ObjLoadOptions

OBJ 파일에 대한 로드 옵션. 주요 속성: enableMaterials (불리언, 기본값 true), flipCoordinateSystem (불리언), normalizeNormal (불리언, 기본값 true), scale (숫자). 참조 포맷 로드 및 저장 옵션 전체 세부 사항은.

ObjSaveOptions

OBJ 내보내기를 위한 저장 옵션. 다음에 전달: scene.save() OBJ 출력 동작을 제어합니다. 참조 포맷 로드 및 저장 옵션 전체 세부 사항은.

ObjFormat

OBJ용 포맷 디스크립터 싱글톤. 두 개 모두 canImport 및 canExport 입니다 true.

glTF 포맷

GltfImporter

읽습니다 glTF 2.0 JSON (.gltf).glb) 파일. 임베디드 및 외부 버퍼 참조, PBR 재질, 스킨, 애니메이션 클립을 처리합니다.

GltfExporter

glTF 2.0 출력을 작성합니다. 언제 GltfSaveOptions.binaryMode 입니다 true, 자체 포함된 GLB를 생성합니다; 그렇지 않으면 JSON을 씁니다 .gltf 동반 파일과 .bin 버퍼.

GltfLoadOptions

glTF/GLB 파일 로드 옵션. 버퍼 해상도 및 텍스처 로드 동작을 제어합니다.

GltfSaveOptions

glTF/GLB 내보내기를 위한 저장 옵션. 주요 속성: binaryMode (boolean, true → GLB, 기본값 false), flipTexCoordV (boolean, UV 수직 축을 뒤집음, 기본값 true). 참조 포맷 로드 및 저장 옵션 자세한 내용은.

GltfFormat

포맷 디스크립터 싱글톤. 다음을 통해 얻음 GltfFormat.getInstance() 그리고 전달 scene.save() 두 번째 인수로.

STL 포맷

StlImporter

ASCII와 바이너리 STL 파일을 모두 읽어 Scene 단일을 포함하는 Mesh 엔티티.

StlExporter

바이너리 STL을 씁니다. 출력에는 씬의 삼각형 메시가 포함되며, 삼각형이 아닌 폴리곤은 자동으로 삼각형화됩니다.

StlLoadOptions

STL 로드 옵션. 가져오기 중에 인포터가 노멀을 뒤집는지 여부를 제어합니다.

StlSaveOptions

STL 내보내기 저장 옵션. 주요 속성: binaryMode (boolean, 기본값 false). 출력이 ASCII인지 바이너리 STL인지 제어합니다. 참조 포맷 로드 및 저장 옵션 자세한 내용은.

StlFormat

포맷 디스크립터 싱글톤. 다음을 통해 얻음 StlFormat.getInstance().

3MF Format

ThreeMfImporter

Open Packaging Convention 3MF 아카이브를 읽고 a를 채웁니다 Scene mesh objects, colors, and material properties를 포함합니다.

ThreeMfExporter

현재 씬에서 유효한 3MF 아카이브를 작성합니다. 3D 프린팅 워크플로에 적합합니다.

ThreeMfLoadOptions

3MF 파일에 대한 로드 옵션.

ThreeMfSaveOptions

3MF 내보내기에 대한 저장 옵션.

ThreeMfFormat

Format descriptor singleton. 다음을 통해 얻음 ThreeMfFormat.getInstance().

FBX 포맷

FbxImporter

기하학, 재질, 스켈레톤, 블렌드 쉐이프 및 애니메이션 클립을 포함한 FBX 바이너리 및 ASCII 파일을 읽습니다.

FbxExporter

현재 씬에서 FBX 파일을 씁니다. 옵션에 따라 바이너리와 ASCII FBX 출력 모두를 지원합니다.

FbxLoadOptions

FBX에 대한 로드 옵션. 애니메이션, 스킨 및 블렌드 쉐이프가 가져와지는지를 제어합니다.

FbxSaveOptions

FBX export를 위한 저장 옵션. 주요 속성: embedTextures (불리언, 기본값 false). 보기 포맷 로드 및 저장 옵션 전체 세부 정보를 보려면.

FbxFormat

포맷 디스크립터 싱글톤. 다음을 통해 얻음 FbxFormat.getInstance().

COLLADA 포맷

COLLADA 가져오기 및 내보내기에는 xmldom 피어 종속성은 자동으로 설치됩니다 @aspose/3d.

ColladaImporter

COLLADA (를 읽습니다.dae) XML 파일을 사용하여 xmldom. 기하학, 재질, 카메라, 조명 및 애니메이션을 처리합니다.

ColladaExporter

현재 씬에서 COLLADA XML 출력을 작성합니다. DCC 도구(Blender, Maya 등)와의 교환에 적합합니다.

ColladaFormat

포맷 디스크립터 싱글톤. 다음을 통해 얻음 ColladaFormat.getInstance().

속성 시스템

ImageRenderOptions

어떤 객체에도 첨부할 수 있는 타입이 지정된 이름/값 쌍 A3DObject. 스칼라 및 벡터 값 타입을 지원합니다.

PropertyCollection

다음의 정렬된 컨테이너 Property 객체들. 모든 A3DObject 를 통해 properties 액세서.

CustomObject

확장되는 자유 형식 속성 가방 A3DObject. 표준 클래스에 매핑되지 않는 임의의 메타데이터를 저장하는 데 사용됩니다.

자산 정보

AssetInfo

소스 파일에서 로드된 씬 수준 메타데이터를 포함합니다: 작성자, 애플리케이션 이름, 생성 날짜, 단위 스케일 및 좌표 축 정보.

ImageRenderOptions

이미지 데이터를 포함하는 포맷(예: GLB)으로 저장할 때 텍스처와 이미지를 해석하고 인코딩하는 방식을 제어하는 옵션 binaryMode: true).

참고

 한국어