Skip to content

Commit f79118a

Browse files
PrincessGodPrincessGod
committed
update readme for create i3dm tileset
1 parent 52adec8 commit f79118a

7 files changed

Lines changed: 163 additions & 86 deletions

File tree

‎NODEUSAGE.md‎

Lines changed: 88 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -108,6 +108,8 @@ Or use custom BatchTable.
108108

109109
## Convert to tileset
110110

111+
* Convert to `.b3dm` tileset.
112+
111113
```javascript
112114
var obj23dtiles = require('./lib/obj23dtiles');
113115

@@ -116,7 +118,7 @@ Or use custom BatchTable.
116118
obj23dtiles(objPath, tilesetPath, {tileset: true});
117119
```
118120

119-
Or use custom tileset options.
121+
Or use custom tileset options and BatchTable.
120122

121123
```javascript
122124
var obj23dtiles = require('./lib/obj23dtiles');
@@ -135,6 +137,91 @@ Or use custom tileset options.
135137
tileHeight: 200.0,
136138
geometricError: 200.0,
137139
region: true
140+
},
141+
customBatchTable: {
142+
name: [
143+
'model1',
144+
'model2'
145+
],
146+
id: [
147+
0,
148+
1
149+
]
150+
}
151+
});
152+
```
153+
154+
* Convert to `.i3dm` tileset.
155+
156+
```javascript
157+
var obj23dtiles = require('./lib/obj23dtiles');
158+
159+
var objPath = './bin/barrel/barrel.obj';
160+
var tilesetPath = './bin/barrel/barrel.i3dm';
161+
obj23dtiles(objPath, tilesetPath, {
162+
tileset: true,
163+
i3dm: true,
164+
customFeatureTable: {
165+
position: [
166+
[0, 0, 0],
167+
[20, 0, 0]
168+
],
169+
orientation: [
170+
[0, 0, 0],
171+
[0, 0, 45]
172+
],
173+
scale: [
174+
[1, 1, 1],
175+
[0.8, 0.8, 0.8]
176+
]
177+
}
178+
});
179+
```
180+
181+
Or use custom tileset options and BatchTable.
182+
183+
```javascript
184+
var obj23dtiles = require('./lib/obj23dtiles');
185+
186+
var objPath = './bin/barrel/barrel.obj';
187+
var tilesetPath = './bin/barrel/barrel.i3dm';
188+
obj23dtiles(objPath, tilesetPath, {
189+
tileset: true,
190+
i3dm: true,
191+
customFeatureTable: {
192+
position: [
193+
[0, 0, 0],
194+
[20, 0, 0]
195+
],
196+
orientation: [
197+
[0, 0, 0],
198+
[0, 0, 45]
199+
],
200+
scale: [
201+
[1, 1, 1],
202+
[0.8, 0.8, 0.8]
203+
]
204+
},
205+
tilesetOptions: {
206+
longitude: -1.31968,
207+
latitude: 0.698874,
208+
transHeight: 0.0,
209+
minHeight: 0.0,
210+
maxHeight: 40.0,
211+
tileWidth: 200.0,
212+
tileHeight: 200.0,
213+
geometricError: 200.0,
214+
region: true
215+
},
216+
customBatchTable: {
217+
name: [
218+
'model1',
219+
'model2'
220+
],
221+
id: [
222+
0,
223+
1
224+
]
138225
}
139226
});
140227
```

‎README.md‎

Lines changed: 22 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -101,46 +101,41 @@ node ./bin/obj23dtiles.js -i ./bin/barrel/barrel.obj --tileset
101101
// Export ./Batchedbarrel folder at obj folder which is a tileset.
102102
```
103103

104-
* Create a single tileset with `.b3dm` tile and custom tileset options.
104+
* Create a single tileset with `.b3dm` tile and custom tileset options, custom BatchTable.
105105

106106
```
107-
node ./bin/obj23dtiles.js -i ./bin/barrel/barrel.obj --tileset -p ./bin/barrel/customTilesetOptions.json
107+
node ./bin/obj23dtiles.js -i ./bin/barrel/barrel.obj --tileset
108+
-p ./bin/barrel/customTilesetOptions.json -c ./bin/barrel/customBatchTbale.json
108109
// Export ./Batchedbarrel folder at obj folder which is a tileset with custom tileset options.
109110
```
110111

112+
* Create a single tileset with `.i3dm` tile.
113+
114+
```
115+
node ./bin/obj23dtiles.js -i ./bin/barrel/barrel.obj --tileset --i3dm
116+
-f ./bin/barrel/customFeatureTable.json
117+
// Export ./Instancedbarrel folder at obj folder which is a tileset.
118+
```
119+
120+
* Create a single tileset with `.i3dm` tile and custom tileset options, custom BatchTable.
121+
122+
```
123+
node ./bin/obj23dtiles.js -i ./bin/barrel/barrel.obj --tileset --i3dm
124+
-f ./bin/barrel/customFeatureTable.json -p ./bin/barrel/customTilesetOptions.json
125+
-c ./bin/barrel/customI3dmBatchTable.json
126+
// Export ./Instancedbarrel folder at obj folder which is a tileset.
127+
```
128+
111129
The `customTilesetOptions.json` can have options bellow, and these are fake values, please only add properties you need, other value will be auto calculate through `.obj` file.
112130

113131
```
114132
{
115133
"longitude": -1.31968, // Tile origin's(models' point (0,0,0)) longitude in radian.
116134
"latitude": 0.698874, // Tile origin's latitude in radian.
117-
"transHeight": 0.0, // Model height in meters.
118-
"minHeight": 0.0, // BoundingVolume minimum height in meters.
119-
"maxHeight": 40.0, // BoundingVolume maximum height in meters.
120-
"tileWidth": 200.0, // Tile horizontal(cross longitude) length in meters.
121-
"tileHeight": 200.0, // Tile virtical(cross latitude) length in meters.
122-
"geometricError": 200.0, // Tile geometric error in meters.
135+
"transHeight": 0.0, // Tile origin's height in meters.
123136
"region": true, // Using region bounding volume.
124137
"box": false, // Using box bounding volume.
125138
"sphere": false // Using sphere bounding volume.
126-
//"transform": [ // Using for custom transform, replace `longitude`,
127-
// 0.9686356343768792, `latitude` and `transHeight`.
128-
// 0,
129-
// 0.24848542777253735,
130-
// 0,
131-
// -0.15986460744966327,
132-
// 0.623177611820219,
133-
// 0.765567091384559,
134-
// 0,
135-
// 0.19023226619126932,
136-
// -0.7415555652213445,
137-
// 0.6433560667227647,
138-
// 0,
139-
// 1215011.9317263428,
140-
// -4736309.3434217675,
141-
// 4081602.0044800863,
142-
// 1
143-
// ]
144139
}
145140
146141
```
@@ -209,7 +204,7 @@ barrel\
209204
| |
210205
| - barrel.b3dm
211206
|
212-
- BatchedbarrelI3dm\ ---- Tileset use i3dm
207+
- Instancedbarrel\ ---- Tileset use i3dm
213208
| |
214209
| - tileset.json
215210
| |

‎README_CN.md‎

Lines changed: 23 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -97,14 +97,32 @@ node ./bin/obj23dtiles.js -i ./bin/barrel/barrel.obj -f ./bin/barrel/customFeatu
9797

9898
```
9999
node ./bin/obj23dtiles.js -i ./bin/barrel/barrel.obj --tileset
100-
// 在模型目录导出 ./Batchedbarrel 文件夹
100+
// 在模型目录导出 Batchedbarrel 文件夹
101101
```
102102

103-
* 创建一个 `.b3dm` 瓦片，并自定义[属性表](https://github.com/AnalyticalGraphicsInc/3d-tiles/blob/master/TileFormats/BatchTable/README.md)。
103+
* 创建一个 `.b3dm` 瓦片，并自定义瓦片参数和属性表。
104104

105105
```
106-
node ./bin/obj23dtiles.js -i ./bin/barrel/barrel.obj --tileset -p ./bin/barrel/customTilesetOptions.json
107-
// 在模型目录导出 ./Batchedbarrel
106+
node ./bin/obj23dtiles.js -i ./bin/barrel/barrel.obj --tileset
107+
-p ./bin/barrel/customTilesetOptions.json -c ./bin/barrel/customBatchTbale.json
108+
// 在模型目录导出 Batchedbarrel 文件夹
109+
```
110+
111+
* 创建一个 `.i3dm` 瓦片。
112+
113+
```
114+
node ./bin/obj23dtiles.js -i ./bin/barrel/barrel.obj --tileset --i3dm
115+
-f ./bin/barrel/customFeatureTable.json
116+
// 在模型目录导出 Instancedbarrel 文件夹
117+
```
118+
119+
* 创建一个 `.i3dm` 瓦片，并自定义瓦片参数和属性表。
120+
121+
```
122+
node ./bin/obj23dtiles.js -i ./bin/barrel/barrel.obj --tileset --i3dm
123+
-f ./bin/barrel/customFeatureTable.json -p ./bin/barrel/customTilesetOptions.json
124+
-c ./bin/barrel/customI3dmBatchTable.json
125+
// 在模型目录导出 Instancedbarrel 文件夹
108126
```
109127

110128
`customTilesetOptions.json` 配置文件可以包含以下信息, 这些都是虚拟值，请在文件中包含自己想修改的属性，没有出现的属性会根据模型自动计算。
@@ -113,32 +131,9 @@ node ./bin/obj23dtiles.js -i ./bin/barrel/barrel.obj --tileset -p ./bin/barrel/c
113131
"longitude": -1.31968, // 瓦片原点(模型原点 (0,0,0)) 经度的弧度值。
114132
"latitude": 0.698874, // 瓦片原点维度的弧度值。
115133
"transHeight": 0.0, // 瓦片原点所在高度，单位为米。
116-
"minHeight": 0.0, // BoundingVolume 最低高度，单位为米。
117-
"maxHeight": 40.0, // BoundingVolume 最高高度，单位为米。
118-
"tileWidth": 200.0, // 瓦片水平（横穿经度）方向长度，单位为米。
119-
"tileHeight": 200.0, // 瓦片垂直（横穿纬度）方向长度，单位为米。
120-
"geometricError": 200.0, // 瓦片几何误差，用来控制显隐。
121134
"region": true, // 使用 region 作为外包体。
122135
"box": false, // 使用 box 作为外包体。
123136
"sphere": false // 使用 sphere 作为外包体。
124-
//"transform": [ // 使用自定义转换矩阵, 用来代替 `longitude`,
125-
// 0.9686356343768792, `latitude` 和 `transHeight` 属性。
126-
// 0,
127-
// 0.24848542777253735,
128-
// 0,
129-
// -0.15986460744966327,
130-
// 0.623177611820219,
131-
// 0.765567091384559,
132-
// 0,
133-
// 0.19023226619126932,
134-
// -0.7415555652213445,
135-
// 0.6433560667227647,
136-
// 0,
137-
// 1215011.9317263428,
138-
// -4736309.3434217675,
139-
// 4081602.0044800863,
140-
// 1
141-
// ]
142137
}
143138
144139
```
@@ -205,7 +200,7 @@ barrel\
205200
| |
206201
| - barrel.b3dm
207202
|
208-
- BatchedbarrelI3dm\ ---- 使用 i3dm 的瓦片
203+
- Instancedbarrel\ ---- 使用 i3dm 的瓦片
209204
| |
210205
| - tileset.json
211206
| |

‎bin/barrel/output/Batchedbarrel/barrel.b3dm‎

1.39 KB
Binary file not shown.

‎bin/barrel/output/Batchedbarrel/tileset.json‎

Lines changed: 15 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -8,30 +8,30 @@
88
"root": {
99
"transform": [
1010
0.9686356343768792,
11-
0.24848542777253735,
11+
0.24848542777253732,
1212
0,
1313
0,
14-
-0.15986460744966327,
15-
0.623177611820219,
16-
0.765567091384559,
14+
-0.15986460744316267,
15+
0.6231776117948786,
16+
0.7655670914065438,
1717
0,
18-
0.19023226619126932,
19-
-0.7415555652213445,
20-
0.6433560667227647,
18+
0.19023226619673222,
19+
-0.7415555652426398,
20+
0.6433560666966038,
2121
0,
22-
1215011.9317263428,
23-
-4736309.3434217675,
24-
4081602.0044800863,
22+
1215011.9192183807,
23+
-4736309.294663747,
24+
4081601.9621787807,
2525
1
2626
],
2727
"boundingVolume": {
2828
"region": [
29-
-1.3197004795898053,
30-
0.6988582109,
31-
-1.3196595204101946,
32-
0.6988897891,
29+
-1.3196812388922754,
30+
0.6988730441359575,
31+
-1.3196785765456007,
32+
0.6988749388279575,
3333
0,
34-
40
34+
12.060076788067818
3535
]
3636
},
3737
"geometricError": 0,

bin/barrel/output/BatchbarrelI3dm/barrel.i3dm renamed to bin/barrel/output/Instancedbarrel/barrel.i3dm

File renamed without changes.

bin/barrel/output/BatchbarrelI3dm/tileset.json renamed to bin/barrel/output/Instancedbarrel/tileset.json

Lines changed: 15 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -8,30 +8,30 @@
88
"root": {
99
"transform": [
1010
0.9686356343768792,
11-
0.24848542777253735,
11+
0.24848542777253732,
1212
0,
1313
0,
14-
-0.15986460744966327,
15-
0.623177611820219,
16-
0.765567091384559,
14+
-0.15986460744316267,
15+
0.6231776117948786,
16+
0.7655670914065438,
1717
0,
18-
0.19023226619126932,
19-
-0.7415555652213445,
20-
0.6433560667227647,
18+
0.19023226619673222,
19+
-0.7415555652426398,
20+
0.6433560666966038,
2121
0,
22-
1215011.9317263428,
23-
-4736309.3434217675,
24-
4081602.0044800863,
22+
1215011.9192183807,
23+
-4736309.294663747,
24+
4081601.9621787807,
2525
1
2626
],
2727
"boundingVolume": {
2828
"region": [
29-
-1.3196852388922754,
30-
0.6988700441359575,
31-
-1.3196745765456007,
32-
0.6988779388279575,
29+
-1.3196853348102364,
30+
0.6988698863159575,
31+
-1.3196744806276397,
32+
0.6988780966479575,
3333
0,
34-
40
34+
32.06007678806782
3535
]
3636
},
3737
"geometricError": 0,

0 commit comments

Comments
 (0)