objTo3d-tiles

Node command line tool convert obj model file to 3D Tiles, based on .

NOTE: Only support .b3dm for now!

Please use Cesium after v1.37, cause this 3d tile use glTF2.0.

Getting Start

Clone this repository to local.

git clone https://github.com/PrincessGod/objTo3d-tiles.git

Navigate in the repository folder.

cd objTo3d-tiles

Make sure you have installed, and then

npm install

Basic Usage

Convert .obj to .gltf

node ./bin/obj23dtiles.js -i ./bin/barrel/barrel.obj// Export barrel.gltf at same folder.

Convert .obj to .glb

node ./bin/obj23dtiles.js -i ./bin/barrel/barrel.obj -b  // Export barrel.glb at same folder.

NOTE: More detial to convert .gltf and .glb can find at .

NOTE: If your model have tarnsparency texture please add --checkTransparency parameter.

NOTE: If your model using blinn-phong material, and use occlusion when convert to PBR material, the model will looks darker. The useOcclusion default is false, remember adding --useOcclusion if your model using PBR material. Here are some showcase about it.

Convert .obj to .b3dm with default batch table, which have batchId and name property, and name is model's name.

node ./bin/obj23dtiles.js -i ./bin/barrel/barrel.obj --b3dm// Export barrel.b3dm at same folder.

Convert .obj to .b3dm with default batch table and export default batch table (a JSON file). Maybe get information for custom batch table.

node ./bin/obj23dtiles.js -i ./bin/barrel/barrel.obj --b3dm --outputBatchTable// Export barrel.b3dm and barrel_batchTable.json at same folder.

Convert .obj to .b3dm with custom batch table.

node ./bin/obj23dtiles.js -i ./bin/barrel/barrel.obj -c ./bin/barrel/customBatchTbale.json --b3dm// Export barrel.b3dm with custom batch table at same folder.

Create Tileset

Create a single tileset with .b3dm tile.

node ./bin/obj23dtiles.js -i ./bin/barrel/barrel.obj --tileset// Export ./Batchedbarrel folder at same folder which is a tileset.

Create a single tileset with .b3dm tile and custom tileset options.

node ./bin/obj23dtiles.js -i ./bin/barrel/barrel.obj --tileset -p ./bin/barrel/customTilesetOptions.json// Export ./Batchedbarrel folder at same folder which is a tileset with custom tileset options.

The customTilesetOptions.json can have options bellow, and these are fake values, if do not have custom tileset config, these value will be auto calculate through .obj file.

{    "longitude":      -1.31968,     // Tile center's(models' point (0,0,0)) longitude in radian.    "latitude":       0.698874,     // Tile center's latitude in radian.    "transHeight":    0.0,          // Model height in meters.    "minHeight":      0.0,          // BoundingVolume minimum height in meters.    "maxHeight":      40.0,         // BoundingVolume maximum height in meters.    "tileWidth":      200.0,        // Tile horizontal(cross longitude) length in meters.    "tileHeight":     200.0,        // Tile virtical(cross latitude) length in meters.    "geometricError": 200.0,        // Tile geometric error in meters.    "region":         true,         // Using region bounding volume.    "box":            false,        // Using box bounding volume.    "sphere":         false         // Using sphere bounding volume.    //"transform":      [           // Using for custom transform, replace `longitude`,    //        0.9686356343768792,   `latitude` and `transHeight`.    //        0,    //        0.24848542777253735,    //        0,    //        -0.15986460744966327,    //        0.623177611820219,    //        0.765567091384559,    //        0,    //        0.19023226619126932,    //        -0.7415555652213445,    //        0.6433560667227647,    //        0,    //        1215011.9317263428,    //        -4736309.3434217675,    //        4081602.0044800863,    //        1    //      ]}

NOTE: If you are not specify the transHeight option, your model will be place at earth ground surface, which means no matter what the height your models are, the lowerest point of your models will be place at height = 0.0 on the earth. But if you want keep origin heigth you just need specify transHeight = 0.0.

Here are different bounding volumes.

Combine tilesets

You can combine tilesets into one tileset.json as external tileset.

node ./bin/obj23dtiles.js combine -i ./your/tilesets/folder/

Using as node module

If you want to use this tool in node or debug, check out .

Troubleshooting

First, make sure your .obj file is complete, normally include .obj, .mtl and textures like .jpg or .png. You can preview your .obj model via "Mixed Reality Viewer" if you are in windows 10. Otherwise you can use this .

Second, export .glb and check if it display correctly. You can use or gltf viewer.

In the end, just export .b3dm or tileset and load in Cesium.

Sample Data

Sample data under the .bin\barrel\ folder.

barrel\    |    - barrel.blend              --    |                             |- Blender project file with texture.    - barrel.png                --    |    - barrel.obj                --    |                             |- Obj model files.    - barrel.mtl                --    |    - customBatchTable.json     ---- Custom batchtable used in demonstration.    |    - customTilesetOptions.json ---- Custom tileset optional parameters.    |    - output\                   ---- Export data by using upper files.        |        - barrel.glb        |        - barrel.gltf        |        - barrel_batchTable.json    ---- Default batch table.        |        - Batchedbarrel\            ---- Tileset output        |   |        |   - tileset.json        |   |        |   - barrel.b3dm        |        - BatchedTilesets\          ---- Tileset with custom tileset.json            |            - tileset.json            |            - barrel_withDefaultBatchTable.b3dm            |            - barrel_withCustonBatchTable.b3dm

Resources

Online glTF viewer, make sure your glTF is correct. , .

Credits

Great thanks to Sean Lilley() for helping and advising.

Thanks provide a lot of open source project (like and ) and creat a great GIS environment.

License

转载地址：http://ablai.baihongyu.com/

你可能感兴趣的文章