@voxel-3d/docs
    Preparing search index...

    Class ImportManager

    ImportManager - 3D 파일 임포터

    다양한 3D 파일 포맷을 load하고 관리합니다.

    • GLTF/GLB/FBX 지원
    • 멀티 파일 병렬 로딩
    • 동시성 control (Semaphore)
    • progress callbacks
    const importer = new ImportManager({
      maxConcurrent: 6,
      onProgress: (progress) => {
        console.log(`${progress.percentage}% (${progress.completedFiles}/${progress.totalFiles})`);
      },
      onFileComplete: (info) => {
        if (info.success) {
          scene.add(info.object!);
        }
      }
    });

    // 단일 파일
    const result = await importer.load('/models/model.glb');

    // 멀티 파일
    const results = await importer.loadMultiple([
      '/models/model1.glb',
      '/models/model2.fbx',
      { url: '/models/model3.gltf', id: 'custom-id' }
    ]);

    Implements

    Index

    Accessors

    state supportedFormats gltfLoader fbxLoader modelCache

    Constructors

    constructor

    Methods

    load loadFiles loadMultiple setExternalFileUrlMap setFileContentCache clearFileContentCache clearExternalFileUrlMap getLastReport printImportReport cancel setOptions setCallbacks clearModelCache getModelCacheStats dispose

    Accessors

    • get gltfLoader(): GLTFLoaderWrapper

      GLTF 로더 접근

      Returns GLTFLoaderWrapper

      고급 설정이 필요한 경우 직접 로더에 접근합니다.

    • get modelCache(): IModelCache | null

      Returns the model cache instance. 모델 캐시 인스턴스를 반환합니다.

      Returns IModelCache | null

    Constructors

    Methods

    • File 객체 배열로 로드

      Parameters

      • files: File[]

        File 객체 배열

      Returns Promise<LoadCompleteInfo>

      로드 완료 정보

      File API로 선택한 파일들을 로드합니다. GLTF 파일이 참조하는 .bin 파일과 텍스처를 자동으로 매핑합니다.

      // input[type="file"]에서 선택한 파일들
      const files = Array.from(input.files);
      const result = await importer.loadFiles(files);

    • 외부 파일 (BIN, 텍스처 등) 해석을 위한 URL 맵 설정

      GLTF 파일이 외부 .bin 파일을 참조하는 경우, 해당 파일들의 blob URL을 미리 생성하여 전달해야 합니다.

      Parameters

      • urlMap: Map<string, string>

        파일명(소문자) → blob URL 매핑

      Returns void

      const urlMap = new Map([
        ['model.bin', 'blob:http://localhost/...'],
        ['texture.png', 'blob:http://localhost/...']
      ]);
      importer.setExternalFileUrlMap(urlMap);
      await importer.loadMultiple([...]);

    • 파일 콘텐츠 캐시 설정 (Blob URL fetch 우회용)

      Parameters

      • cache: Map<string, ArrayBuffer>

        Blob URL → ArrayBuffer 맵

      Returns void

    • 파일 콘텐츠 캐시 초기화

      Returns void

    • Returns the last import session report. 마지막 임포트 세션 리포트를 반환합니다.

      Returns ImportReport | null

    • Prints the last import report to the console. 마지막 임포트 리포트를 콘솔에 출력합니다.

      Returns void

    • load 취소

      Returns void

    • Clears the model cache. 모델 캐시를 초기화합니다.

      Returns Promise<boolean>

      Whether clear succeeded 초기화 성공 여부

    • Returns model cache statistics. 모델 캐시 통계를 반환합니다.

      Returns ModelCacheStats | null

      Cache statistics or null if cache is not available 캐시 통계 또는 null (캐시 미사용 시)

    • 리소스 cleanup

      Returns void

    Settings

    Member Visibility

    On This Page

    Accessors
    Constructors
    Methods