Merge branch 'develop'

# Conflicts:
#	tiler/build.gradle

Author: znkim

manual.md MANUAL-EN.mdmanual.md renamed to MANUAL-EN.md

@@ -134,15 +134,6 @@ This is because Citygml data can have different extensions: ‘.xml’, ‘.gml
 java -jar mago-3d-tiler.jar -input "/input_path/citygml" -inputType "citygml" -output "/output_path/citygml" -crs "5186"
 ```
 
-### Converting Large 3D Mesh Data
-[Warning: Experimental]   
-This option tiles large mesh data by breaking it down into smaller units.
-This can be specified via the `-largeMesh` option.
-
-```
-java -jar mago-3d-tiler.jar -input "/input_path/ifc_large_mesh" -inputType "ifc" -output "/output_path/ifc_large_mesh" -largeMesh
-```
-
 ### Converting Large Point-Clouds Data
 When converting large point-clouds, you can use the `-pointRatio` option to adjust the percentage of conversion points from the source data as follows.
 

MANUAL-KO.md

@@ -0,0 +1,120 @@
+다양한 변환 사례
+===
+
+## 3D 메시 데이터 변환 (Batched Model)
+
+### 일반적인 메시 데이터 변환
+기본적인 메시 데이터를 변환하는 명령어입니다. 변환 시 기본 좌표계는 EPSG:3857로 설정됩니다.
+
+```
+java -jar mago-3d-tiler.jar -input "/input_path" -output "/output_path"
+```
+
+동일한 경우:
+```
+java -jar mago-3d-tiler.jar -input "/input_path" -output "/output_path" -crs 3857
+```
+
+### 배치 3D 모델 (b3dm)
+일반적인 데이터를 변환할 때 사용할 수 있습니다. 포인트 클라우드 데이터를 제외하고, `-outputType`을 입력하지 않으면 기본적으로 b3dm으로 생성됩니다.
+
+```
+java -jar mago-3d-tiler.jar -input "/input_path/kml_with_collada" -output "/output_path/kml_with_collada"
+```
+
+동일한 경우:
+```
+java -jar mago-3d-tiler.jar -input "/input_path/kml_with_collada" -output "/output_path/kml_with_collada"
+```
+
+### DEM 고도 적용 사례
+GeoTiff와 같은 단일 채널 지형 높이에 3D 데이터를 배치하는 경우입니다.
+
+```
+java -jar mago-3d-tiler.jar -input "/input_path/sample" -output "/output_path/sample" -terrain "/input_path/sample/terrain.tif"
+```
+
+### 좌표계를 적용한 3D 데이터 변환
+다음 예시는 3ds(3D MAX) 데이터를 변환하는 예제입니다. `crs` 옵션을 추가하여 좌표계를 적용하여 변환할 수 있습니다. 아래의 경우 EPSG:5186 좌표계를 적용했습니다.
+
+```
+java -jar mago-3d-tiler.jar -input "/input_path/3ds" -inputType "3ds" -output "/output_path/3ds" -crs "5186"
+```
+
+---
+# 2D 벡터 데이터 변환
+
+### 2D GIS 폴리곤 데이터(SHP, GeoJSON) 변환
+다음 예시는 2D GIS 폴리곤 데이터를 돌출하는(Extrude) 방법입니다. 돌출 높이는 `-heightColumn <arg>` 속성을 사용하여 특정 속성을 참조하도록 지정할 수 있습니다. 기본적으로 돌출 시작 높이는 0이며, `-altitudeColumn <arg>` 옵션을 사용하여 기준면의 높이를 설정할 수 있습니다.
+
+```
+java -jar mago-3d-tiler.jar -input "/input_path/shp" -inputType "shp" -output "/output_path/shp" -crs "5186"
+```
+
+동일한 경우:
+```
+java -jar mago-3d-tiler.jar -input "/input_path/shp" -inputType "shp" -output "/output_path/shp" -crs "5186" -heightAttribute "height"
+```
+
+GeoJSON 변환 사례:
+```
+java -jar mago-3d-tiler.jar -input "/input_path/geojson" -inputType "geojson" -output "/output_path/geojson" -crs "5186"
+```
+
+### 2D GIS 폴리라인 데이터(SHP) 변환
+폴리라인 데이터를 파이프 형태로 변환합니다. Z축이 있는 폴리라인 데이터는 `diameter` 속성을 이용해 변환할 수 있습니다. 기본적으로 mago 3DTiler의 파이프 크기는 직경 기준이며 단위는 밀리미터(mm)입니다.
+```
+java -jar mago-3d-tiler.jar -input "/input_path/shp" -inputType "shp" -output "/output_path/shp" -crs "5186"
+```
+
+---
+# 인스턴스 모델 변환 (Instanced Model)
+
+### 인스턴스 3D 모델 (i3dm)
+인스턴스 모델 데이터를 변환할 때 사용할 수 있는 옵션입니다. (kml with collada) 데이터를 변환할 때 `outputType` 옵션이 필요합니다.
+```
+java -jar mago-3d-tiler.jar -input "/input_path/i3dm" -output "/output_path/i3dm" -outputType "i3dm"
+```
+
+### i3dm 데이터를 Shape 파일로 변환
+i3dm 데이터를 Point 형식의 Shape 파일로 변환할 수 있습니다. `inputType`을 shp로 지정하고, `instance` 옵션을 사용해 인스턴스 파일 경로를 입력해야 합니다.
+
+```
+java -jar mago-3d-tiler.jar -input "/input_path/i3dm" -output "/output_path/i3dm" -inputType "shp" -outputType "i3dm" -instance "/input_path/instance.gltf"
+```
+
+---
+# 포인트 클라우드 데이터 변환 (Point Clouds)
+
+### 포인트 클라우드 데이터 변환(Point Clouds)
+포인트 클라우드 데이터를 변환할 때 사용할 수 있는 기본 옵션입니다. 입력 데이터가 "las"인 경우, `-outputType`은 자동으로 "pnts"로 설정됩니다.
+
+```
+java -jar mago-3d-tiler.jar -input "/input_path/las" -inputType "las" -output "/output_path/las"
+```
+
+동일한 경우:
+```
+java -jar mago-3d-tiler.jar -input "/input_path/las" -inputType "las" -output "/output_path/las" -outputType "pnts"
+```
+
+---
+# 기타 변환 예제
+
+### Up-Axis 변환
+mago3dTiler는 기본적으로 Z-Up 축 데이터를 Y-Up 축으로 변환합니다. 원본 데이터가 Y-Up 축을 사용하는 경우, `-rotateX <degree>` 옵션을 추가하여 변환을 방지할 수 있습니다.
+```
+java -jar mago-3d-tiler.jar -input "/input_path/y-up-fbx" -inputType "fbx" -output "/output_path/y-up-fbx" -rotateX "90"
+```
+
+### 뒤집힌 데이터 변환
+변환된 데이터가 뒤집혀 있는 경우, `-rotateX <degree>` 옵션을 추가하여 변환할 수 있습니다.
+```
+java -jar mago-3d-tiler.jar -input "/input_path/flip-y-up-fbx" -inputType "fbx" -output "/output_path/flip-y-up-fbx" -rotateX "180"
+```
+
+### CityGML 변환
+CityGML 데이터를 변환할 때 `inputType`을 "citygml"로 지정하는 것이 좋습니다. 이는 CityGML 데이터의 확장자가 `.xml`, `.gml` 등 다양할 수 있기 때문입니다.
+```
+java -jar mago-3d-tiler.jar -input "/input_path/citygml" -inputType "citygml" -output "/output_path/citygml" -crs "5186"
+```

README-KO.md

@@ -0,0 +1,98 @@
+mago 3DTiler
+===
+
+### 최고의 OGC 3D Tiles 솔루션!
+
+---
+
+### 개요
+mago 3DTiler는 오픈 소스를 기반으로 한 OGC 3DTiles 생성기입니다.  
+다양한 공간 정보 데이터를 OGC 3D Tiles로 변환하여 디지털 트윈 서비스를 위한 기반을 제공합니다.  
+Java 기반으로 개발된 mago 3DTiler는 높은 이식성, 유연성, 그리고 빠른 성능을 자랑합니다.
+
+![Static Badge](https://img.shields.io/badge/Gaia3D%2C%20Inc-blue?style=flat-square)
+![Static Badge](https://img.shields.io/badge/3DTiles-green?style=flat-square&logo=Cesium)
+![Static Badge](https://img.shields.io/badge/Jdk17-red?style=flat-square&logo=openjdk)
+![Static Badge](https://img.shields.io/badge/Gradle-darkorange?style=flat-square&logo=gradle)
+![Static Badge](https://img.shields.io/badge/Docker%20Image-blue?style=flat-square&logo=docker)
+
+#### 왜 mago 3DTiler인가?
+mago 3DTiler는 단순한 변환기가 아닙니다.  
+Java로 개발된 이 오픈 소스 프로젝트는 3D 데이터 변환 분야에서 유연성과 성능을 동시에 제공합니다.
+
+---
+
+### 주요 기능
+- **다양한 형식 지원**: 3DS, OBJ, FBX, Collada DAE, GlTF, GLB, IFC 등 다양한 3D 형식을 OGC 3D Tiles로 변환 가능
+- **포인트 클라우드 변환**: LAS, LAZ 등의 포인트 클라우드 데이터를 정밀하게 변환
+- **2D 데이터를 3D 모델로 변환**: ESRI SHP, GeoJSON 등의 2D 공간 데이터를 3D 모델로 변환하여 생동감 있는 표현 가능
+- **좌표 변환 지원**: Proj4 라이브러리를 활용한 다중 스레딩 및 실시간 좌표 변환 기능 제공
+
+---
+
+### 사용법
+릴리즈된 jar 파일을 다운로드하여 사용하거나, 직접 Gradle 스크립트를 이용해 빌드할 수 있습니다.  
+빌드된 jar 파일은 ```/dist``` 디렉터리에 생성됩니다.
+
+```
+gradlew jar
+```
+###### 릴리즈에 사용된 Java 버전은 openjdk 17입니다.
+
+#### 도움말 명령어 예시
+```
+java -jar mago-3d-tiler-x.x.x-natives-windows.jar -help
+```
+콘솔 출력 예시:
+```
+┳┳┓┏┓┏┓┏┓  ┏┓┳┓  ┏┳┓┳┓ ┏┓┳┓
+┃┃┃┣┫┃┓┃┃   ┫┃┃   ┃ ┃┃ ┣ ┣┫
+┛ ┗┛┗┗┛┗┛  ┗┛┻┛   ┻ ┻┗┛┗┛┛┗
+3d-tiler(dev) by Gaia3D, Inc.
+----------------------------------------
+usage: mago 3DTiler help
+```
+
+이 명령을 사용하여 KML 또는 Collada 데이터를 3D Tiles로 변환할 수 있습니다.
+```
+java -jar mago-3d-tiler-x.x.x-natives-windows.jar -input C:\data\kml-input-dir -inputType kml -output C:\data\kml-output-dir
+```
+또는
+```
+java -jar mago-3d-tiler-x.x.x-natives-windows.jar -i C:\data\kml-input-dir -o C:\data\kml-output-dir
+```
+
+### Docker 버전 사용법
+Docker를 이용하여 mago-3d-tiler를 간편하게 사용할 수도 있습니다.
+
+#### 설치 명령어:
+```
+docker pull gaia3d/mago-3d-tiler
+```
+
+#### 실행 명령어:
+```
+docker run --rm -v "/workspace:/workspace" gaia3d/mago-3d-tiler -inputType 3ds -input /workspace/3ds-samples -output /workspace/sample-3d-tiles -crs 5186
+```
+
+### 지원하는 Java 버전
+JDK17 및 JDK21 등 장기 지원(LTS) 버전을 지원합니다.
+
+### mago 3DTiler 체험하기
+![image](https://github.com/Gaia3D/mago-3d-tiler/assets/87691347/c778f7e1-771c-4df6-8d4c-b46412c80c19)  
+<https://seoul.gaia3d.com:10903>
+
+### 커뮤니티 및 라이선스
+- **오픈소스 커뮤니티**: GitHub에서 활발한 커뮤니티 활동 및 기여 가능
+- **자유로운 개발**: MPL2.0 라이선스를 통해 자유롭게 사용, 수정, 배포 가능 (<https://www.mozilla.org/en-US/MPL/2.0/>)
+- **상용 라이선스 옵션**: MPL2.0 조건을 원하지 않을 경우 상용 라이선스를 선택할 수 있으며, 관련 문의는 [email protected]으로 연락 바랍니다.
+
+### 라이브러리 의존성
+- **LWJGL3** (경량 Java 게임 라이브러리 3 OpenGL, Assimp): <https://github.com/LWJGL/lwjgl3>
+- **JOML** (Java OpenGL 수학 라이브러리): <https://github.com/JOML-CI/JOML>
+- **jgltf** (glTF를 위한 Java 라이브러리): <https://github.com/javagl/JglTF>
+- **laszip4j** (LASzip Java 포트): <https://github.com/mreutegg/laszip4j>
+- **geotools** (지리 공간 데이터 처리 라이브러리): <https://github.com/geotools/geotools>
+- **proj4j** (좌표 변환 라이브러리): <https://github.com/locationtech/proj4j>
+- **citygml4j** (CityGML을 위한 Java API): <https://github.com/citygml4j/citygml4j>
+