자주 묻는 질문

@aspose/3d를 어떻게 설치하나요?

npm에서 설치합니다. Node.js 18 이상이 필요합니다:

npm install @aspose/3d

설치 확인:

import { Scene } from '@aspose/3d';
const scene = new Scene();
console.log('@aspose/3d ready');

TypeScript 타입 정의는 패키지에 포함되어 있습니다. 별도의 @types/ 패키지는 필요하지 않습니다.

지원되는 파일 형식은 무엇입니까?

Format	Import	Export
OBJ (Wavefront)	예	예
glTF 2.0 / GLB	예	예
FBX (Autodesk)	아니오*	아니오*
STL (Stereo Lithography)	예	예
3MF (3D Manufacturing)	예	예
COLLADA (.dae)	예	예

3D 파일을 어떻게 로드하나요?

Scene을 만들고 scene.open()을 호출하십시오:

import { Scene } from '@aspose/3d';
import { ObjLoadOptions } from '@aspose/3d/formats/obj';

const scene = new Scene();
scene.open('model.obj', new ObjLoadOptions());

특별한 옵션이 필요 없는 형식의 경우, 두 번째 인수를 생략하십시오:

const scene = new Scene();
scene.open('model.glb');

scene.open()은 비동기인가요?

아니오. scene.open() 및 scene.openFromBuffer()는 동기 호출입니다. 논블로킹 I/O가 필요하면 Node.js 워커 스레드 내에서 실행하거나 setImmediate로 래핑하십시오.

glTF/GLB로 저장하려면 어떻게 해야 하나요?

파일 경로와 함께 scene.save()를 호출하십시오. 형식은 확장자를 통해 자동으로 감지됩니다:

scene.save('output.glb');   // binary glTF
scene.save('output.gltf');  // JSON glTF
scene.save('output.obj');   // OBJ
scene.save('output.stl');   // STL

버퍼(메모리 내)에서 어떻게 로드합니까?

scene.openFromBuffer() 사용:

import * as fs from 'fs';
import { Scene } from '@aspose/3d';
import { ObjLoadOptions } from '@aspose/3d/formats/obj';

const buffer = fs.readFileSync('model.obj');
const scene = new Scene();
scene.openFromBuffer(buffer, new ObjLoadOptions());

오류: 모듈 ‘@aspose/3d/formats/obj’을(를) 찾을 수 없습니다

이것은 Node.js 12.7+ 패키지 내보내기 해석을 필요로 합니다. Node.js 18+를 사용하고 있는지 확인하십시오. TypeScript의 경우 "moduleResolution": "node16" 또는 "bundler"을 tsconfig.json에 설정하십시오:

{
  "compilerOptions": {
    "moduleResolution": "node16",
    "target": "ES2020"
  }
}

node.entity의 타입은 무엇입니까?

node.entity은 넓게 타입 지정됩니다. 메시 전용 속성에 접근하려면 'controlPoints' in node.entity으로 존재 여부를 확인하거나 @aspose/3d/entities의 Mesh 클래스를 사용하십시오:

import { Mesh } from '@aspose/3d/entities';

if (node.entity instanceof Mesh) {
    const mesh = node.entity;
    console.log(mesh.controlPoints.length);
}

라이브러리가 브라우저에서 실행되나요?

이 라이브러리는 Node.js용으로 설계되었습니다. 브라우저 지원은 번들러 구성 및 파일 시스템 API를 메모리 기반 대안으로 교체하는 것에 따라 달라집니다.

라이브러리는 스레드 안전합니까?

각 Scene 객체는 독립적입니다. 별도의 Node.js 워커 스레드에서 별개의 Scene 인스턴스를 사용하는 것은 외부 동기화 없이 스레드 간에 단일 씬을 공유하지 않는 한 안전합니다.

지원되는 Node.js 버전은 무엇인가요?

Node.js 18, 20, 및 22는 공식적으로 지원됩니다. TypeScript 5.0+은 권장됩니다.

@aspose/3d는 애니메이션을 지원합니까?

예. 애니메이션 시스템에는 AnimationClip, AnimationChannel 및 @aspose/3d/animation에서 액세스할 수 있는 키프레임 곡선 유형이 포함됩니다.

자주 묻는 질문