GLTF 뷰어 문서내보내기 가이드 - glTF/GLB 및 지원 형식
glTF/GLB 파일 내보내기의 모범 사례와 최적화 팁을 제공하는 완전한 가이드
내보내기 가이드
빠른 시작 - 간단한 2단계로 내보내기
내보내기 버튼 클릭
전체화면 모드에서 툴바의 내보내기 버튼 (📥 다운로드 아이콘)을 클릭하거나 Ctrl+E를 누르세요.
전문가 팁: 내보내기는 현재 로드된 모델과 함께 작동합니다. 내보내기 전에 모델이 올바르게 표시되는지 확인하세요. 모델의 복잡성에 따라 처리는 일반적으로 5-30초가 소요됩니다.
지원되는 내보내기 형식
10가지 내보내기 형식
여러 활용 시나리오에 맞춘 GLB (바이너리)/glTF (JSON) 선택 가이드
크로스 플랫폼
데스크톱, 태블릿, 모바일 기기에서 최적화된 경험
고품질
모델 정밀도를 유지하며 바이너리 및 텍스트 형식 모두 지원
스마트 선택
사용 목적에 따른 형식 추천
🎯 형식 빠른 참조
| 형식 | 최적 용도 | 파일 크기 | 호환성 | 일반적 사용 |
|---|---|---|---|---|
| GLB (바이너리) | 단일 파일 배포 | 작음 | 범용 | 일반적 |
전체 10가지 형식 보기
텍스트 기반 형식
| 형식 | 확장자 | 다중 파일 | 최적 용도 |
|---|---|---|---|
| glTF (JSON) | .gltf | 경우에 따라 외부 리소스 | 가독성과 디버깅 |
바이너리 형식
| 형식 | 확장자 | 다중 파일 | 최적 용도 |
|---|---|---|---|
| GLB (바이너리) | .glb | 아니오 | 단일 파일 패키징 (더 작은 파일 크기) |
모델 내보내기 방법
데스크톱 경험
전체화면 모드 진입
전체화면 버튼을 클릭하거나 F11을 눌러 전체화면 보기 모드로 들어가세요.
내보내기 도구 접근
전체화면 툴바에서 내보내기 버튼 (다운로드 아이콘)을 클릭하거나 키보드 단축키 Ctrl+E를 사용하세요.
형식 선택
대화 상자에서 원하는 내보내기 형식을 선택하세요. 각 형식은 다음을 표시합니다:
- 형식 이름 및 설명
- 파일 유형 표시기 (GLB (바이너리)/Text)
- 해당하는 경우 다중 파일 표시기
내보내기 확인
[형식 이름] 내보내기를 클릭하여 변환 프로세스를 시작하세요. 처리가 완료되면 내보내기가 자동으로 시작됩니다.
📱 모바일 및 태블릿 경험
내보내기 접근
전체화면 모드에서 더보기 버튼 (⋮ 점 3개) → 내보내기를 탭하세요.
선택 및 다운로드
형식을 선택하고 내보내기를 탭하세요. 파일이 다운로드 폴더에 자동으로 저장됩니다.
모바일 팁:
- 큰 모델에는 Wi-Fi 사용
- GLB (바이너리) 권장 (단일 파일, 더 작은 용량)
- 내보내기 후 다운로드 앱 확인
일반적인 사용 사례
형식 선택 가이드
문제 해결
일반적인 내보내기 문제
🚫 내보내기 버튼이 회색으로 비활성화됨
빠른 수정: 모델이 완전히 로드될 때까지 기다리세요 (진행 표시줄 완료)
여전히 비활성화된 경우:
- 페이지를 새로고침하고 모델을 다시 로드
- 브라우저가 WebGL을 지원하는지 확인 (webglreport.com 방문)
- 다른 브라우저 시도 (Chrome/Firefox 권장)
⚠️ 내보내기 실패 또는 너무 오래 걸림
즉시 해결책:
- 다른 브라우저 탭 닫기 (메모리 확보)
- GLB (바이너리) 형식 시도 (안정적)
- 파일 크기 확인 - 100MB 이상의 모델은 타임아웃될 수 있음
고급 해결책:
- 브라우저 캐시 지우기
- 브라우저 확장 프로그램 비활성화
- 시크릿/개인 모드 시도
📁 파일이 다운로드되지 않음
브라우저 문제:
- 먼저 다운로드 폴더 확인
- 이 사이트에서 다운로드 허용
- 다운로드 관리자/확장 프로그램 비활성화
- 다른 형식 시도 (GLB (바이너리)가 일반적으로 더 작음)
중요: 내보내기 시스템은 현재 로드되고 렌더링된 모델을 처리합니다. 내보내기는 현재 보기 상태를 반영하므로 내보내기 전에 모델이 올바르게 표시되는지 확인하세요.
소프트웨어 호환성
전문 3D 모델링 환경 호환성
| 모델링 환경 | 권장 형식 | 호환성 수준 |
|---|---|---|
| 전문 3D 엔지니어링 도구 | GLB (바이너리) | 높음 |
도구 호환성 예시
| 카테고리 | 권장 형식 | 비고 |
|---|---|---|
| 실무 CAD/콘텐츠 파이프라인 | GLB (바이너리) | 단일 파일 전달에 적합 |
| 웹/앱 통합 | glTF (JSON) 또는 GLB | 요구사항에 따라 선택 |
고급 기술 세부사항
기술 구현 세부사항
ExportDialog 컴포넌트
내보내기 기능은 ExportDialog 컴포넌트 (src/components/gltf-viewer/fullscreen/ExportDialog.tsx)를 통해 구현되며, 다음을 제공합니다:
// 핵심 내보내기 기능
const handleExport = useCallback(async () => {
if (!online3DViewerAPI?.exportModel) {
// API 사용 불가 처리
return;
}
await online3DViewerAPI.exportModel(
formatConfig.fileFormat, // 'GLB (바이너리)' 또는 'Text'
formatConfig.extension // 파일 확장자
);
}, [selectedFormat, online3DViewerAPI]);API 통합
시스템은 Online3D Viewer의 내보내기 기능과 통합됩니다:
- 형식 감지: 확장자 기반 자동 형식 선택
- 품질 제어: 변환 중 모델 정밀도 유지
- 진행 피드백: 처리 중 시각적 표시기
- 오류 복구: 내보내기 실패에 대한 우아한 처리
성능 고려사항
- 메모리 사용: 바이너리 형식이 일반적으로 더 적은 메모리 사용
- 처리 시간: 텍스트 형식은 생성에 더 오래 걸릴 수 있음
- 파일 크기: 바이너리 형식이 더 작은 파일 생성
- 호환성: 텍스트 형식이 더 나은 크로스 플랫폼 지원 제공
다음 단계
내보내기 기능을 마스터한 후:
이 가이드는 GLTF File Viewer의 전체화면 모드에서 사용 가능한 완전한 내보내기 기능을 다룹니다. 추가 지원이나 기능 요청은 지원 리소스를 방문하세요.