# 프로젝트에 파일 추가

Chloros에서 프로젝트를 생성하거나 열었다면, 다음 단계는 다중 스펙트럼 이미지를 추가하여 처리를 시작하는 것입니다. 파일 브라우저<img src="https://1848333212-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIZ9fPWpw2lqTHigj7goj%2Fuploads%2Fgit-blob-65a5d12fb868533fcc66abebb71865d48a50f35f%2Ficon_file-browser.JPG?alt=media" alt="" data-size="line"> 탭을 사용하면 이미지를 쉽게 가져오고 데이터 세트를 관리할 수 있습니다.

## 파일 브라우저 접근 방법

1. Chloros에서 프로젝트를 열거나 생성합니다.
2. 왼쪽 사이드바의 **파일 브라우저** <img src="https://1848333212-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIZ9fPWpw2lqTHigj7goj%2Fuploads%2Fgit-blob-65a5d12fb868533fcc66abebb71865d48a50f35f%2Ficon_file-browser.JPG?alt=media" alt="" data-size="line"> 아이콘을 클릭합니다
3. 파일 브라우저 패널에 프로젝트의 파일 목록이 표시됩니다

{% hint style="info" %}
**지원 파일 형식**: Chloros는 MAPIR, Survey3W 및 Survey3N 카메라의 RAW+JPG 및 JPG 이미지 파일을 지원합니다. RAW+JPG 형식만 권장됩니다.
{% endhint %}

***

## 프로젝트에 이미지 추가하기

프로젝트에 이미지를 추가하는 두 가지 주요 방법이 있습니다:

### 방법 1: 파일 추가

개별 이미지 파일 또는 소량의 파일을 가져오려면 이 옵션을 사용하세요.

1. 파일 브라우저 패널 상단의 **"파일 추가"** <img src="https://1848333212-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIZ9fPWpw2lqTHigj7goj%2Fuploads%2Fgit-blob-821c1e53cab823a422e05c55588a79562eea9b5e%2Fimage.png?alt=media" alt="" data-size="line"> 버튼을 클릭합니다
2. 이미지 파일이 있는 폴더로 이동합니다
3. 하나 이상의 이미지 파일을 선택합니다(**Ctrl** 키를 누른 상태에서 여러 파일 선택)
4. \*\*"열기"\*\*를 클릭하여 선택한 파일을 가져옵니다

### 방법 2: 폴더 추가

폴더 내 모든 이미지를 한 번에 가져오려면 이 옵션을 사용합니다.

1. 파일 브라우저 패널 상단의 **"폴더 추가"** <img src="https://1848333212-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIZ9fPWpw2lqTHigj7goj%2Fuploads%2Fgit-blob-35bf69ff9fefec88d05eb5f9fe78d972e1cb15d7%2Fimage%20(1).png?alt=media" alt="" data-size="line"> 버튼을 클릭하세요
2. 촬영 세션 이미지가 포함된 폴더로 이동하여 선택하세요
3. \**"폴더 선택"**을 클릭하여 해당 폴더의 모든 지원 이미지 가져오기***

## 파일 브라우저 테이블 이해하기

이미지가 가져오기 완료되면 다음 열로 구성된 테이블에 표시됩니다:

### 파일 이름

* 카메라의 원본 파일명
* 카메라 명명 규칙 유지 (예: IMG\_0001.RAW)

### 타임스탬프

* 이미지 촬영 날짜 및 시간
* 이미지 EXIF 메타데이터에서 추출
* PPK 동기화 및 교정 대상 감지에 사용

### 카메라 모델

* 자동 감지된 카메라 및 필터 구성
* 예시: Survey3W\_RGN, Survey3N\_OCN, Survey3W\_RGB
* 올바른 처리 프로필 적용에 사용

### 타겟 열 (체크박스)

* 보정 타겟이 포함된 이미지의 경우 이 상자를 선택하십시오
* 처리 중 타겟 감지 속도를 크게 향상시킵니다
* 자세한 내용은 [타겟 이미지 선택](https://mapir.gitbook.io/chloros/ko/gui/choosing-target-images)을 참조하십시오

### 이미지 메타데이터 보기

테이블 상단 오른쪽 모서리의 토글 버튼을 클릭하면 선택된 이미지의 메타데이터가 이미지 그리드 영역에 표시됩니다.

<figure><img src="https://1848333212-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIZ9fPWpw2lqTHigj7goj%2Fuploads%2Fgit-blob-3b60fe8846b9675597c469460e50b0dda3356af7%2Fchloros_grid_meta.gif?alt=media" alt=""><figcaption></figcaption></figure>

***

## 프로젝트 파일 관리

### 파일 제거

프로젝트에서 불필요한 이미지를 제거하려면:

1. 파일 브라우저 테이블에서 하나 이상의 이미지를 선택합니다
2. **"선택 항목 제거"** <img src="https://1848333212-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIZ9fPWpw2lqTHigj7goj%2Fuploads%2Fgit-blob-955302324fb2317af2a57a9dbf0e5e9fa3cbe66b%2Fimage%20(2).png?alt=media" alt="" data-size="line"> 버튼
3. 제거 확인 (파일은 디스크에서 삭제되지 않고 프로젝트에서만 제거됨)

### 정렬 및 필터링

* **열별 정렬**: 이미지 정렬을 위해 열 헤더를 클릭하세요
* **타임스탬프 정렬**: 시간순 촬영 순서 정리에 유용합니다
* **카메라 모델 필터**: 여러 대의 카메라를 사용하는 경우 카메라 유형별로 이미지를 그룹화합니다\*\*\*

## 이미지 미리보기

### 전체 이미지 보기

파일 브라우저의 이미지 썸네일을 클릭하면 메인 미리보기 영역에 표시됩니다:

1. 이미지가 중앙 미리보기 패널에 나타납니다
2. 확대/축소 컨트롤을 사용하여 이미지 세부 사항을 확인하세요
3. 화살표 키를 사용하여 이미지 간 이동

### 빠른 탐색

* **이전 이미지**: 왼쪽 화살표 클릭 또는 ← 키 누르기
* **다음 이미지**: 오른쪽 화살표 클릭 또는 → 키 누르기
* **확대/축소**: 마우스 휠 또는 확대/축소 버튼 사용
* **이동**: 확대 시 이미지 위에서 클릭 후 드래그\*\*\*

## 중복 파일 처리

Chloros는 중복 파일을 자동으로 감지하여 무시합니다:

* 동일한 파일명을 가진 파일은 건너뜁니다
* 실수로 중복 처리되는 것을 방지합니다
* 중복이 감지되면 경고 메시지가 표시됩니다

{% hint style="warning" %}
**중요**: 가져오기 전에 원본 이미지 파일의 이름을 변경하거나 수정하지 마십시오. Chloros는 올바른 처리를 위해 원본 파일명과 메타데이터에 의존합니다.
{% endhint %}

***

## 혼합 카메라 데이터셋

프로젝트에 여러 MAPIR 카메라의 이미지가 포함된 경우:

1. Chloros가 각 카메라 모델을 자동으로 감지합니다
2. 각 카메라 유형은 해당 보정 프로필로 처리됩니다
3. 파일 브라우저의 '카메라 모델' 열에 카메라 모델 표시
4. 각 카메라 유형에 맞는 올바른 설정 적용

**예시 시나리오**: Survey3W RGN + Survey3N OCN 듀얼 카메라 설정\*\*\*

## 모범 사례

### 가져오기 전 정리

* 교정 대상 이미지를 측량 이미지와 동일한 폴더에 보관하십시오
* 카메라/SD 카드의 원래 폴더 구조를 유지하십시오
* 서로 다른 세션의 데이터 세트를 하나의 프로젝트에 혼합하지 마십시오

### 파일 명명

* 카메라의 원래 파일명(예: IMG\_0001.RAW)을 보존하십시오
* 가져오기 전에 파일명을 변경하지 마십시오
* 원본 이름에는 중요한 메타데이터가 포함됨

### 보정 대상 이미지

* 세션당 항상 1\~2개의 보정 대상 이미지를 포함하세요
* 촬영 세션 전후에 대상 이미지를 캡처하세요
* 대상 이미지를 촬영 영역과 동일한 조명 조건에 배치하세요
* 처리 속도 향상을 위해 대상 이미지에는 '대상' 체크박스를 표시하세요

***

## 일반적인 문제 및 해결 방법

### 가져오기 후 이미지가 표시되지 않음

**가능한 원인:**

* 지원되지 않는 파일 형식 (MAPIR 카메라의 RAW+JPG 및 JPG만 지원)
* MAPIR 카메라가 아닌 다른 카메라의 이미지 ([지원 카메라](https://mapir.gitbook.io/chloros/ko/supported-cameras) 참조)
* 파일 손상 또는 SD 카드에서 불완전한 전송

**해결 방법**: 파일 형식 및 카메라 모델 호환성 확인

### 카메라 모델 미검출

**가능한 원인:**

* 수정된 EXIF 메타데이터
* 외부 소프트웨어에서 편집된 이미지
* 불완전한 파일 전송

**해결 방법**: 카메라/SD 카드에서 수정되지 않은 원본 파일을 재가져오기

### 타임스탬프 누락

**가능한 원인:**

* 카메라 시계가 올바르게 설정되지 않음
* 외부 소프트웨어에 의해 EXIF 데이터가 제거됨

**해결 방법**: 촬영 당시 카메라 시간 설정이 정확한지 확인\*\*\*

## 다음 단계

파일 가져오기 완료 후:

1. **파일 목록 검토** - 모든 이미지가 올바르게 로드되었는지 확인
2. **카메라 모델 확인** - 올바른 카메라 인식 여부 검증
3. **대상 이미지 표시** - [대상 이미지 선택](https://mapir.gitbook.io/chloros/ko/gui/choosing-target-images) 참조
4. **설정 조정** - [프로젝트 설정](https://mapir.gitbook.io/chloros/ko/gui/adjusting-project-settings)에서 처리 옵션 구성
5. **처리 시작** - [처리 시작](https://mapir.gitbook.io/chloros/ko/gui/starting-the-processing) 참조

프로젝트 구성에 대한 자세한 내용은 [프로젝트 설정 조정](https://mapir.gitbook.io/chloros/ko/gui/adjusting-project-settings)을 참조하십시오.
