형식	재질	텍스처	애니메이션	파일 크기	최적 용도
OBJ	기본	참조	미지원	중간	광범위 호환
PLY	버텍스 색	미지원	미지원	작음	포인트클라우드/스캔
glTF	완전	완전	완전	중간	다중 파일 보존
GLB	완전	완전	완전	최적화	웹 배포

형식 선택 가이드

다음 경우 OBJ 선택…

– 레거시/호환성 중요 – 기본 재질(MTL)로 충분 – 도구 간 편집/교환 필요

웹 배포의 경우…

유지: 최적화 GLB

Draco 압축 및 텍스처 최적화
GLB 기능 완전 보존

다중 파일 파이프라인…

선택: glTF (JSON + BIN)

자원 분리 관리
특정 파이프라인/엔진에 용이

내보내기 방법(데스크톱)

전체화면 모드 진입

전체화면 버튼 또는 F11로 전체 도구 사용

내보내기 도구 열기

전체화면 툴바에서 내보내기(다운로드) 또는 Ctrl+E

형식 선택

워크플로우에 따라:

OBJ – 호환성 우수(MTL 포함)
PLY – 포인트클라우드/스캔
최적화 GLB – 웹 배포
glTF – 다중 파일(JSON + BIN)

내보내기

내보내기를 클릭해 변환 시작. 완료 후 자동 다운로드

📱 모바일/태블릿 내보내기

내보내기 접근

전체화면 모드에서 더보기 버튼 (⋮ 점 3개) → 내보내기를 탭하세요.

선택 및 다운로드

OBJ / glTF / 최적화 GLB 등을 선택해 내보내기. 파일은 다운로드에 저장됩니다.

모바일 팁:

OBJ가 호환성 우수(기본 재질 유지)
큰 텍스처 포함 GLB는 Wi-Fi 권장

문제 해결

일반적인 내보내기 문제

내보내기 버튼이 회색으로 비활성화됨

빠른 수정: GLB(텍스처 포함) 완전 로드까지 대기

여전히 비활성화된 경우:

페이지 새로고침
WebGL 2.0 확인
Chrome/Edge 시도

내보내기 실패 또는 너무 오래 걸림

즉시 해결책:

다른 탭/앱 종료(메모리 확보)
더 단순한 형식 선택(OBJ/PLY가 더 빠름)
모델 복잡도 확인(텍스처 다수 = 느림)

고급 해결책:

브라우저 캐시 지우기
브라우저 확장 프로그램 비활성화
시크릿/개인 모드 시도

파일이 다운로드되지 않음

브라우저 문제:

다운로드 폴더 확인
브라우저 다운로드 권한 확인
다른 형식으로 시도
다운로드 매니저/차단 확장 비활성화

중요: 현재 로드된 GLB를 기준으로 변환합니다. 재질/텍스처는 지원 형식에서만 유지(OBJ 일부). 완전 보존은 최적화 GLB 또는 glTF 사용

호환성 개요

소프트웨어 유형	GLB	glTF	OBJ	PLY
게임 엔진	네이티브	네이티브	양호	약함
3D 에디터	매우 좋음	매우 좋음	범용	양호
CAD 소프트웨어	플러그인	플러그인	양호	양호
3D 프린팅	해당 없음	해당 없음	일부	제한적
웹 뷰어	네이티브	네이티브	제한적	약함
AR/VR 플랫폼	네이티브	네이티브	변환	해당 없음

고급 기술 세부사항

기술 구현 세부사항

ExportDialog 컴포넌트

내보내기 기능은 ExportDialog 컴포넌트 (src/components/glb-viewer/fullscreen/ExportDialog.tsx)를 통해 구현되며, 다음을 제공합니다:

// 핵심 내보내기 기능
const handleExport = useCallback(async () => {
  if (online3DViewerAPI?.exportModel === undefined) {
    // API 사용 불가 처리
    return;
  }
  
  await online3DViewerAPI.exportModel(
    formatConfig.fileFormat,  // 'Binary' 또는 'Text'
    formatConfig.extension    // 파일 확장자
  );
}, [selectedFormat, online3DViewerAPI]);

API 통합

시스템은 GLB File Viewer의 내보내기 파이프라인과 통합됩니다:

형식 감지: 확장자 기반 자동 형식 선택
품질 제어: 변환 중 모델 정밀도 유지
진행 피드백: 처리 중 시각적 표시기
오류 복구: 내보내기 실패에 대한 우아한 처리

성능 고려사항

메모리 사용: 바이너리 형식이 일반적으로 더 적은 메모리 사용
처리 시간: 텍스트 형식은 생성에 더 오래 걸릴 수 있음
파일 크기: 바이너리 형식이 더 작은 파일 생성
호환성: 텍스트 형식이 더 나은 크로스 플랫폼 지원 제공

다음 단계

내보내기 기능을 마스터한 후:

시각적 문서화를 위한 스크린샷 기능 탐색
정밀한 분석을 위한 측정 도구 학습
추가 도움을 위한 문제 해결 확인
모바일 전용 기능을 위한 모바일 가이드 검토

이 가이드는 전체화면 모드에서의 GLB File Viewer 내보내기 기능을 설명합니다. 디지털 콘텐츠, 게임, 웹 시각화 워크플로우에 최적화되어 있습니다.

GLB 내보내기 가이드 - 전문 3D 형식 변환

빠른 시작 – 2단계로 내보내기

내보내기 버튼 클릭

전체화면 모드에서 툴바의 내보내기 또는 Ctrl+E

형식 선택 및 다운로드

대상 형식을 선택하고 내보내기 클릭 → 자동 다운로드

인기 변환:

GLB → OBJ – 광범위한 호환성(MTL 포함)
GLB → glTF – 다중 파일(JSON + BIN)
GLB → 최적화 GLB – 웹 배포(압축 지원)

GLB 내보내기 기능

다중 형식 변환

GLB를 OBJ, PLY, glTF, 최적화 GLB 등으로 변환

재질 보존

지원 형식에서 재질과 텍스처 최대한 유지(OBJ 일부)

최적화 옵션

내보내기 시 압축/최적화 적용으로 파일 크기 절감

워크플로우 통합

CAD, 게임 엔진, 디지털 콘텐츠 워크플로우와 호환

형식 비교

형식	재질	텍스처	애니메이션	파일 크기	최적 용도
OBJ	기본	참조	미지원	중간	광범위 호환
PLY	버텍스 색	미지원	미지원	작음	포인트클라우드/스캔
glTF	완전	완전	완전	중간	다중 파일 보존
GLB	완전	완전	완전	최적화	웹 배포

형식 선택 가이드

다음 경우 OBJ 선택…

– 레거시/호환성 중요 – 기본 재질(MTL)로 충분 – 도구 간 편집/교환 필요

웹 배포의 경우…

유지: 최적화 GLB

Draco 압축 및 텍스처 최적화
GLB 기능 완전 보존

다중 파일 파이프라인…

선택: glTF (JSON + BIN)

자원 분리 관리
특정 파이프라인/엔진에 용이

내보내기 방법(데스크톱)

전체화면 모드 진입

전체화면 버튼 또는 F11로 전체 도구 사용

내보내기 도구 열기

전체화면 툴바에서 내보내기(다운로드) 또는 Ctrl+E

형식 선택

워크플로우에 따라:

OBJ – 호환성 우수(MTL 포함)
PLY – 포인트클라우드/스캔
최적화 GLB – 웹 배포
glTF – 다중 파일(JSON + BIN)

내보내기

내보내기를 클릭해 변환 시작. 완료 후 자동 다운로드

📱 모바일/태블릿 내보내기

내보내기 접근

전체화면 모드에서 더보기 버튼 (⋮ 점 3개) → 내보내기를 탭하세요.

선택 및 다운로드

OBJ / glTF / 최적화 GLB 등을 선택해 내보내기. 파일은 다운로드에 저장됩니다.

모바일 팁:

OBJ가 호환성 우수(기본 재질 유지)
큰 텍스처 포함 GLB는 Wi-Fi 권장

문제 해결

일반적인 내보내기 문제

내보내기 버튼이 회색으로 비활성화됨

빠른 수정: GLB(텍스처 포함) 완전 로드까지 대기

여전히 비활성화된 경우:

페이지 새로고침
WebGL 2.0 확인
Chrome/Edge 시도

내보내기 실패 또는 너무 오래 걸림

즉시 해결책:

다른 탭/앱 종료(메모리 확보)
더 단순한 형식 선택(OBJ/PLY가 더 빠름)
모델 복잡도 확인(텍스처 다수 = 느림)

고급 해결책:

브라우저 캐시 지우기
브라우저 확장 프로그램 비활성화
시크릿/개인 모드 시도

파일이 다운로드되지 않음

브라우저 문제:

다운로드 폴더 확인
브라우저 다운로드 권한 확인
다른 형식으로 시도
다운로드 매니저/차단 확장 비활성화

중요: 현재 로드된 GLB를 기준으로 변환합니다. 재질/텍스처는 지원 형식에서만 유지(OBJ 일부). 완전 보존은 최적화 GLB 또는 glTF 사용

호환성 개요

소프트웨어 유형	GLB	glTF	OBJ	PLY
게임 엔진	네이티브	네이티브	양호	약함
3D 에디터	매우 좋음	매우 좋음	범용	양호
CAD 소프트웨어	플러그인	플러그인	양호	양호
3D 프린팅	해당 없음	해당 없음	일부	제한적
웹 뷰어	네이티브	네이티브	제한적	약함
AR/VR 플랫폼	네이티브	네이티브	변환	해당 없음

고급 기술 세부사항

기술 구현 세부사항

ExportDialog 컴포넌트

내보내기 기능은 ExportDialog 컴포넌트 (src/components/glb-viewer/fullscreen/ExportDialog.tsx)를 통해 구현되며, 다음을 제공합니다:

// 핵심 내보내기 기능
const handleExport = useCallback(async () => {
  if (online3DViewerAPI?.exportModel === undefined) {
    // API 사용 불가 처리
    return;
  }
  
  await online3DViewerAPI.exportModel(
    formatConfig.fileFormat,  // 'Binary' 또는 'Text'
    formatConfig.extension    // 파일 확장자
  );
}, [selectedFormat, online3DViewerAPI]);

API 통합

시스템은 GLB File Viewer의 내보내기 파이프라인과 통합됩니다:

형식 감지: 확장자 기반 자동 형식 선택
품질 제어: 변환 중 모델 정밀도 유지
진행 피드백: 처리 중 시각적 표시기
오류 복구: 내보내기 실패에 대한 우아한 처리

성능 고려사항

메모리 사용: 바이너리 형식이 일반적으로 더 적은 메모리 사용
처리 시간: 텍스트 형식은 생성에 더 오래 걸릴 수 있음
파일 크기: 바이너리 형식이 더 작은 파일 생성
호환성: 텍스트 형식이 더 나은 크로스 플랫폼 지원 제공

다음 단계

내보내기 기능을 마스터한 후:

시각적 문서화를 위한 스크린샷 기능 탐색
정밀한 분석을 위한 측정 도구 학습
추가 도움을 위한 문제 해결 확인
모바일 전용 기능을 위한 모바일 가이드 검토

이 가이드는 전체화면 모드에서의 GLB File Viewer 내보내기 기능을 설명합니다. 디지털 콘텐츠, 게임, 웹 시각화 워크플로우에 최적화되어 있습니다.

GLB 내보내기 가이드 - 전문 3D 형식 변환

다중 형식 변환

재질 보존

최적화 옵션

워크플로우 통합

목차

GLB 내보내기 가이드 - 전문 3D 형식 변환

다중 형식 변환

재질 보존

최적화 옵션

워크플로우 통합

목차