This is the official repository of mago-3d-tiler.
Unlock the potential of your geospatial projects with mago 3DTiler
the robust, versatile tool designed to elevate your 3D data into the realm of OGC 3D Tiles with unprecedented ease.
mago 3DTiler isn’t just a converter;
developed with Java, this open-source marvel stands as a beacon for flexibility and performance in the world of 3D data conversion.
Basically, when you modify source, you can generate a runnable jar via shadowjar, the tiler project's gradle script.
There are pre-built jars in the /tiler/dist/ directory.
The JAVA version used when building is JDK 17.
Below is an example of running the Help code.
java -jar mago-3d-tiler-x.x.x-natives-windows.jar --help
console output:
┌┬┐┌─┐┌─┐┌─┐ -┐┌┬┐ ┌┬┐┬┬ ┌─┐┬─┐
│││├─┤│ ┬│ │ -┤ ││ │ ││ ├┤ ├┬┘
┴ ┴┴ ┴└─┘└─┘ -┘-┴┘ ┴ ┴┴─┘└─┘┴└─
3d-tiler(x.x.x) by Gaia3D, Inc.
----------------------------------------
usage: Gaia3D Tiler
-aa,--autoUpAxis [Experimental] automatically Assign 3D
Matrix Axes
-ac,--altitudeColumn <arg> altitude Column setting.
-c,--crs <arg> Coordinate Reference Systems, only epsg
code (4326, 3857, etc...)
-d,--debug debug mode
-dad,--debugAllDrawing debug all drawing
-dit,--debugIgnoreTextures debug ignore textures
-fc,--flipCoordinate flip x,y Coordinate.
-glb,--glb create glb file.
-gltf,--gltf create gltf file.
-gt,--geoTiff <arg> [Experimental] geoTiff file path, 3D
Object applied as clampToGround.
-h,--help print this message
-hc,--heightColumn <arg> height column setting. (Default: height)
-i,--input <arg> input file path
-it,--inputType <arg> input file type (kml, 3ds, obj, gltf,
etc...)
-l,--log <arg> output log file path
-mc,--multiThreadCount <arg> multi thread count (Default: 8)
-mh,--minimumHeight <arg> minimum height setting.
-mp,--maxPoints <arg> max points of pointcloud data (Default:
20000)
-mt,--multiThread multi thread mode
-mx,--maxCount <arg> max count of nodes (Default: 1024)
-nc,--nameColumn <arg> name column setting. (Default: name)
-nl,--minLod <arg> min level of detail (Default: 0)
-o,--output <arg> output file path
-ot,--outputType <arg> output file type
-p,--proj <arg> proj4 parameters (ex: +proj=tmerc +la...)
-pt,--pngTexture png texture mode
-q,--quiet quiet mode
-r,--recursive deep directory exploration
-ra,--refineAdd refine addd mode
-rt,--reverseTexCoord texture y-axis coordinate reverse
-te,--terrain <arg> [Experimental] terrain file path, 3D
Object applied as clampToGround.
-v,--version print version
-xl,--maxLod <arg> max level of detail (Default: 3)
-ya,--yUpAxis Assign 3D root transformed matrix Y-UP
axis
-zo,--zeroOrigin [Experimental] fix 3d root transformed
matrix origin to zero point.
This is a simple kml/collada -> 3dTiles conversion code with the mandatory argument values.
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
Alternatively, you can easily use mago3dtiler with docker.
Example usage :
docker pull gaia3d/mago-3d-tiler
docker run --rm -v "/workspace:/workspace" gaia3d/mago-3d-tiler -it 3ds -i /workspace/3ds-samples -o /workspace/sample-3d-tiles -crs 5186 -aa
It supports compatibility with long-term support (LTS) versions of the JDK, such as JDK11, JDK17 and JDK21.
JDK21 has been found to be partially available.
https://seoul.gaia3d.com:10903
mago 3DTiler는 오픈소스 기반의 OGC 3D Tiles 변환기입니다.
다양한 공간정보 데이터를 디지털트윈 서비스의 근간이 되는 OGC 3D Tiles로 변환해 줍니다.
mago 3DTiler는 Java 기반으로 뛰어난 이식성, 유연함과 함께 빠른 속도를 자랑합니다.
기본적으로 코드 수정 시 tiler프로젝트의 gradle script인 shadowjar를 통해 runnable jar를 생성할 수 있습니다.
/tiler/dist/ 디렉토리에는 미리 빌드된 jar가 준비 되어있습니다.
빌드할 사용된 java 버전은 jdk 17 입니다.
아래는 Help 코드를 실행시킨 예시입니다.
java -jar mago-3d-tiler-x.x.x-natives-windows.jar -h
출력 결과물:
┌┬┐┌─┐┌─┐┌─┐ -┐┌┬┐ ┌┬┐┬┬ ┌─┐┬─┐
│││├─┤│ ┬│ │ -┤ ││ │ ││ ├┤ ├┬┘
┴ ┴┴ ┴└─┘└─┘ -┘-┴┘ ┴ ┴┴─┘└─┘┴└─
3d-tiler(x.x.x) by Gaia3D, Inc.
----------------------------------------
usage: Gaia3D Tiler
-aa,--autoUpAxis [Experimental] automatically Assign 3D
Matrix Axes
-ac,--altitudeColumn <arg> altitude Column setting.
-c,--crs <arg> Coordinate Reference Systems, only epsg
code (4326, 3857, etc...)
-d,--debug debug mode
-dad,--debugAllDrawing debug all drawing
-dit,--debugIgnoreTextures debug ignore textures
-fc,--flipCoordinate flip x,y Coordinate.
-glb,--glb create glb file.
-gltf,--gltf create gltf file.
-gt,--geoTiff <arg> [Experimental] geoTiff file path, 3D
Object applied as clampToGround.
-h,--help print this message
-hc,--heightColumn <arg> height column setting. (Default: height)
-i,--input <arg> input file path
-it,--inputType <arg> input file type (kml, 3ds, obj, gltf,
etc...)
-l,--log <arg> output log file path
-mc,--multiThreadCount <arg> multi thread count (Default: 8)
-mh,--minimumHeight <arg> minimum height setting.
-mp,--maxPoints <arg> max points of pointcloud data (Default:
20000)
-mt,--multiThread multi thread mode
-mx,--maxCount <arg> max count of nodes (Default: 1024)
-nc,--nameColumn <arg> name column setting. (Default: name)
-nl,--minLod <arg> min level of detail (Default: 0)
-o,--output <arg> output file path
-ot,--outputType <arg> output file type
-p,--proj <arg> proj4 parameters (ex: +proj=tmerc +la...)
-pt,--pngTexture png texture mode
-q,--quiet quiet mode
-r,--recursive deep directory exploration
-ra,--refineAdd refine addd mode
-rt,--reverseTexCoord texture y-axis coordinate reverse
-te,--terrain <arg> [Experimental] terrain file path, 3D
Object applied as clampToGround.
-v,--version print version
-xl,--maxLod <arg> max level of detail (Default: 3)
-ya,--yUpAxis Assign 3D root transformed matrix Y-UP
axis
-zo,--zeroOrigin [Experimental] fix 3d root transformed
matrix origin to zero point.
필수 인자 값으로 작성한 간단한 kml/collada -> 3dTiles 변환코드 입니다.
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
mago 3DTiler 1.3.1 버전부터 도커 버전으로 손쉽게 사용할 수 있습니다.
사용 예시:
docker pull gaia3d/mago-3d-tiler
docker run --rm -v "/workspace:/workspace" gaia3d/mago-3d-tiler -it 3ds -i /workspace/3ds-samples -o /workspace/sample-3d-tiles -crs 5186 -aa
JDK11, JDK17, JDK21 등 JDK의 LTS(Long-term support) 버전의 호환을 지원합니다.
JDK21는 부분적으로 사용이 가능한 것을 확인했습니다.
https://seoul.gaia3d.com:10903