mago 3DTiler is an open source-based OGC 3DTiles generator.
It converts various spatial information data into OGC 3D Tiles, the basis of the Digital Twin service.
Based on Java, mago 3DTiler is highly portable, flexible, and fast.
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.
- Multi-Format Mastery: Effortlessly convert an array of 3D formats, including 3DS, OBJ, FBX, Collada DAE, GlTF/GLB, CityGML, IFC and more.
- Point Cloud Precision: Bring your detailed point cloud data (LAS, LAZ) into the fold with pinpoint accuracy.
- 2D to 3D Extrusion: Turn 2D geospatial data (ESRI SHP, GeoJSON, GeoPackage) into detailed 3D extrusion models, breathing life into flat representations.
- On-The-Fly CRS Conversion: Leverage the power of multi-threading and on-the-fly coordinate conversion with comprehensive PCS and GCS support via the Proj4 library.
download the mago-3d-tiler jar file or use the Docker image to get started quickly.
You can easily run mago 3dTiler using the jar file.
⚠️ Requires JDK 21
java -jar mago-3d-tiler-x.x.x.jar -input C:\data\kml-input-dir -output C:\data\kml-output-dir
you can run mago-3d-tiler using the Docker image without installing Java or other dependencies.
docker pull gaia3d/mago-3d-tiler
docker run --rm -v "/workspace:/workspace" gaia3d/mago-3d-tiler -input /workspace/3ds-samples -output /workspace/sample-3d-tiles -crs 5186
If you prefer to build the mago 3DTiler jar file from source, clone the repository and use Gradle to build the project.
cloning the repository:
git clone https://github.com/Gaia3D/mago-3d-tiler.git
then navigate to the project directory and run:
gradle jarjava -jar mago-3d-tiler.jar --helpconsole output:
----------------------------------------
mago-3d-tiler(dev) by Gaia3D, Inc.
----------------------------------------
Usage: command options
-h, --help Print Help
-q, --quiet Quiet mode/Silent mode
-lt, --leaveTemp Leave temporary files
-m, --merge Merge tileset.json files
-i, --input <arg> [Required] Input directory path
-o, --output <arg> [Required] Output directory path
-t, --temp <arg> Temporary directory path
(default: {OUTPUT}/temp)
-it, --inputType <arg> Input files type
(options: kml, 3ds, fbx, obj, gltf/glb, las/laz, citygml, indoorgml, shp, geojson, gpkg)
-ot, --outputType <arg> Output 3DTiles Type [b3dm, i3dm, pnts]
-l, --log <arg> Output log file path.
-r, --recursive Tree directory deep navigation.
-te, --terrain <arg> Terrain path for clampToGround (GeoTIFF or a local Quantized Mesh layer.json)
-ge, --geoid <arg> Geoid file path for height correction,
(default: Ellipsoid)(options: Ellipsoid, EGM84, EGM96, EGM2008 or GeoTIFF File Path)
-if, --instance <arg> Instance file path for I3DM
(default: {OUTPUT}/instance.dae)
-qt, --quantize Quantize glTF 3DMesh via "KHR_mesh_quantization" Extension
-tv, --tilesVersion <arg> 3DTiles Version
(default: 1.1)(options: 1.0, 1.1)
-c, --crs <arg> Set input data CRS (Coordinate Reference System)
(default: 3857)(options: 4326, 3857, 4978, 32652, 5186...)
(ECEF: 4978, WGS84: 4326, Web Mercator: 3857)
-p, --proj <arg> Set Proj4 parameters
(ex: +proj=tmerc +lat_0=...)
When this option is set, the 'crs' option is ignored.
-xo, --xOffset <arg> X Offset value for coordinate transformation
-yo, --yOffset <arg> Y Offset value for coordinate transformation
-zo, --zOffset <arg> Z Offset value for coordinate transformation
-lon, --longitude <arg> Longitude value for coordinate transformation. (The lon lat option must be used together).
-lat, --latitude <arg> Latitude value for coordinate transformation. (The lon lat option must be used together).
-rx, --rotateXAxis <arg> Rotate the X-Axis in degrees
-ra, --refineAdd [Tileset] Set 3D Tiles Refine 'ADD' mode
-mx, --maxCount <arg> [Tileset] Maximum number of triangles per node.
-nl, --minLod <arg> [Tileset] min level of detail
-xl, --maxLod <arg> [Tileset] Max Level of detail
-ng, --minGeometricError <arg> [Tileset] Minimum geometric error
-mg, --maxGeometricError <arg> [Tileset] Maximum geometric error
-mp, --maxPoints <arg> [Tileset] Maximum number of points per a tile
-pcr, --pointRatio <arg> [PointCloud] Percentage of points from original data
-sp, --sourcePrecision [PointCloud] Create pointscloud tile with original precision.
-f4, --force4ByteRGB [PointCloud] Force 4Byte RGB for pointscloud tile.
-fc, --flipCoordinate [GISVector] Flip x, y coordinate for 2D Original Data.
-af, --attributeFilter <arg> [GISVector] Attribute filter setting for extrusion model (ex: "classification=window,door;type=building")
-nc, --nameColumn <arg> [GISVector] Specify the column name for the feature name.
(default: name)
-ac, --altitudeColumn <arg> [GISVector] Specify the column name for the altitude base height.
(default: altitude)(units: meters)
-hd, --headingColumn <arg> [GISVector][I3DM] Specify the column name for the heading rotation.
(default: heading)(units: degrees)
-scl, --scaleColumn <arg> [GISVector][I3DM] Specify the column name for the scale value.
(default: scale)(units: meters)
-den, --densityColumn <arg> [GISVector][I3DM] Specify the column name for the density value.
(default: density)
-dc, --diameterColumn <arg> [GISVector][Pipe] Specify the column name for the pipe diameter value.
(default: diameter)(units: millimeters)
-hc, --heightColumn <arg> [GISVector][Extrusion] Specify the column name for the reference ceil level height.
(default: height)(units: meters)
-aa, --absoluteAltitude <arg> [GISVector] Set absolute altitude value for all features (overrides altitude column)
-mh, --minimumHeight <arg> [GISVector][Extrusion] Set Building Minimum height
(default: 0.0)(units: meters)
-sh, --skirtHeight <arg> [GISVector][Extrusion] Set Building Skirt height
(default: 4.0)(units: meters)
-pg, --photogrammetry [Experimental] Generate b3dm with the compatibility-focused photogrammetry pipeline.
-sbn, --splitByNode [Experimental] Split tiles by nodes of scene.
-cc, --curvatureCorrection [Experimental] Apply curvature correction for ellipsoid surface.
-urt, --updateRootTransform <arg> [Experimental] Add 16 comma-separated transform values to the root node of tileset.json.
-tm, --tilingMode <arg> [Experimental] 3DTiles hierarchy mode
(default: explicit)(options: explicit, implicit)
-isl, --implicitSubtreeLevels <arg> [Experimental] Implicit tiling subtree levels
(default: 4)
-mc, --multiThreadCount <arg> [Deprecated] set thread count
-glb, --glb [Deprecated] Create glb file with B3DM.
-igtx, --ignoreTextures [Deprecated] Ignore diffuse textures.
-vr, --validationReport [Validation] Save per-file validation JSON reports to the temp directory and write a batch summary to the output directory.
-v, --verbose [Verbose] Show debug-level logs without changing the log format or disabling async logging.
-d, --debug [DEBUG] More detailed log output and stops on Multi-Thread bugs.
For detailed documentation, including installation and usage instructions, please refer to the official documentation:
- Manual : github.com/Gaia3D/mago-3d-tiler
- JavaDocs : gaia3d.github.io/mago-3d-tiler
- Community and Code: Join our vibrant community on GitHub and contribute to the future of 3D data conversion.
- Freedom to Innovate: Embrace the flexibility of MPL2.0 licensing(https://www.mozilla.org/en-US/MPL/2.0/), ensuring your freedom to use, modify, and distribute without hindrance
- License: If you prefer not to share your modified or improved code under the MPL2.0 license, you can opt for a commercial license instead In this case, please contact us at sales@gaia3d.com
main dependencies used in the mago-3d-tiler project include
- LWJGL3 (Lightweight Java Game Library 3): https://github.com/LWJGL/lwjgl3
- Assimp (Open Asset Import Library Java binding): https://github.com/assimp/assimp
- JOML (Java OpenGL Math Library): https://github.com/JOML-CI/JOML
- JglTF (Java libraries for glTF): https://github.com/javagl/JglTF
- laszip4j (The LASzip library ported to Java): https://github.com/mreutegg/laszip4j
- GeoTools (Geospatial data tools library): https://github.com/geotools/geotools
- Proj4J (Converting coordinate reference systems): https://github.com/locationtech/proj4j
- citygml4j (The Open Source Java API for CityGML): https://github.com/citygml4j/citygml4j
- MPL2.0: The Mozilla Public License 2.0 (MPL2.0) governs the use of this software