Skip to content

Latest commit

 

History

History
142 lines (125 loc) · 7.98 KB

README.md

File metadata and controls

142 lines (125 loc) · 7.98 KB

mago 3DTiler

The Premier OGC 3D Tiles Solution!

Overview

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.

Static Badge Static Badge Static Badge Static Badge Static Badge

Why mago 3DTiler?

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.

Key Features

  • Multi-Format Mastery: Effortlessly convert an array of 3D formats, including 3DS, OBJ, FBX, Collada DAE, GlTF, GLB , 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) 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.​

Usage

You can download the released jar file or build the jar yourself via the mago-3d-tiler project gradle script.
The built jar is created in the /dist directory.

gradlew jar
The java version used in the release is openjdk 17.

Example help command

java -jar mago-3d-tiler-x.x.x-natives-windows.jar -help

console output:

┳┳┓┏┓┏┓┏┓  ┏┓┳┓  ┏┳┓┳┓ ┏┓┳┓
┃┃┃┣┫┃┓┃┃   ┫┃┃   ┃ ┃┃ ┣ ┣┫
┛ ┗┛┗┗┛┗┛  ┗┛┻┛   ┻ ┻┗┛┗┛┛┗
3d-tiler(dev) by Gaia3D, Inc.
----------------------------------------
usage: mago 3DTiler help
 -aa,--absoluteAltitude <arg>    Absolute altitude value for extrusion model
 -ac,--altitudeColumn <arg>      Altitude Column setting for extrusion model ((Default Column: altitude)
 -c,--crs <arg>                  Coordinate Reference Systems, EPSG Code(4326, 3857, 32652, 5186...)
 -d,--debug                      More detailed log output and stops on Multi-Thread bugs.
 -dc,--diameterColumn <arg>      Diameter column setting for extrusion model, Specify a length unit for Diameter in millimeters(mm) (Default Column: diameter)
 -f4,--force4ByteRGB             Force 4Byte RGB for pointscloud tile.
 -fc,--flipCoordinate            Flip x, y coordinate for 2D Original Data. (Default: false)
 -glb,--glb                      Create glb file with B3DM.
 -h,--help                       Print Gelp
 -hc,--heightColumn <arg>        Height column setting for extrusion model ((Default Column: height)
 -hd,--headingColumn <arg>       Heading column setting for I3DM converting (Default Column: heading)
 -i,--input <arg>                Input directory path
 -if,--instance <arg>            Instance file path for I3DM (Default: {OUTPUT}/instance.dae)
 -igtx,--ignoreTextures          Ignore diffuse textures.
 -it,--inputType <arg>           Input files type (kml, 3ds, fbx, obj, gltf, glb, las, laz, citygml, indoorgml, shp, geojson)(Default: kml)
 -l,--log <arg>                  Output log file path.
 -lm,--largeMesh                 [Experimental] Large Mesh Splitting Mode (Default: false)
 -mc,--multiThreadCount <arg>    set Multi-Thread count
 -mg,--maxGeometricError <arg>   Maximum geometric error (Default: Integer max value)
 -mh,--minimumHeight <arg>       Minimum height value for extrusion model (Default: 1.0)
 -mp,--maxPoints <arg>           Maximum number of points per a tile (Default: 100000)
 -mx,--maxCount <arg>            Maximum number of triangles per node.
 -nc,--nameColumn <arg>          Name column setting for extrusion model (Default Column: name)
 -ng,--minGeometricError <arg>   Minimum geometric error (Default: 16.0)
 -nl,--minLod <arg>              min level of detail (Default: 0)
 -o,--output <arg>               Output directory file path
 -ot,--outputType <arg>          Output 3DTiles Type (b3dm, i3dm, pnts)(Default : b3dm)
 -p,--proj <arg>                 Proj4 parameters (ex: +proj=tmerc +la...)
 -pcr,--pointRatio <arg>         Percentage of points from original data (Default: 50)
 -pr,--photorealistic            [Experimental] Photorealistic mode for b3dm (Default: false)
 -q,--quiet                      Quiet mode/Silent mode
 -r,--recursive                  Tree directory deep navigation.
 -ra,--refineAdd                 Set 3D Tiles Refine 'ADD' mode
 -ru,--flipUpAxis                Rotate the matrix 180 degrees about the X-axis. (Default: false)
 -rx,--rotateXAxis <arg>         Rotate the X-Axis in degrees (Unit: degrees)(Default: 0.0)
 -sh,--skirtHeight <arg>         Building Skirt height setting for extrusion model (Default: 4.0)
 -sp,--sourcePrecision           Create pointscloud tile with original precision. (Slow)
 -su,--swapUpAxis                Rotate the matrix -90 degrees about the X-axis. (Default: false)
 -te,--terrain <arg>             GeoTiff Terrain file path, 3D Object applied as clampToGround (Supports geotiff format)
 -v,--version                    Print Version Info
 -vl,--voxelLod                  [Experimental] Voxel Level Of Detail setting for i3dm (Default: false)
 -xl,--maxLod <arg>              Max Level of detail (Default: 3)
 -xo,--xOffset <arg>             X Offset value for coordinate transformation
 -yo,--yOffset <arg>             Y Offset value for coordinate transformation
 -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

or

java -jar mago-3d-tiler-x.x.x-natives-windows.jar -i C:\data\kml-input-dir -o C:\data\kml-output-dir

Using Docker Versions

Alternatively, you can easily use mago-3d-tiler with docker.

Installation command:

docker pull gaia3d/mago-3d-tiler

Running command:

docker run --rm -v "/workspace:/workspace" gaia3d/mago-3d-tiler -inputType 3ds -input /workspace/3ds-samples -output /workspace/sample-3d-tiles -crs 5186

Supported Java versions:

Supports long-term support (LTS) versions of the JDK, including JDK17 and JDK21.

Experience the mago 3DTiler:

image
https://seoul.gaia3d.com:10903

Explore and Experience:

  • 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 [email protected]

Library Dependencies: