cesium_dev_kit 1.1.24 → 1.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +23 -8
- package/dist/index.cjs +34 -34
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.mts +168 -1
- package/dist/index.d.ts +168 -1
- package/dist/index.mjs +34 -34
- package/dist/index.mjs.map +1 -1
- package/package.json +3 -3
package/dist/index.d.mts
CHANGED
|
@@ -53,6 +53,13 @@ interface TerrainLngLat {
|
|
|
53
53
|
interface TerrainLngLatHeight extends TerrainLngLat {
|
|
54
54
|
height: number;
|
|
55
55
|
}
|
|
56
|
+
/** 经纬度包围盒 */
|
|
57
|
+
interface TerrainBounds {
|
|
58
|
+
minLng: number;
|
|
59
|
+
minLat: number;
|
|
60
|
+
maxLng: number;
|
|
61
|
+
maxLat: number;
|
|
62
|
+
}
|
|
56
63
|
/** 地形编辑模式的字面量类型 */
|
|
57
64
|
type TerrainEditMode = 'sink' | 'raise' | 'flatten' | 'smooth';
|
|
58
65
|
/** 形变参数 */
|
|
@@ -88,6 +95,28 @@ interface TerrainStats {
|
|
|
88
95
|
/** 笔刷模式:抬升 / 下沉 / 整平到目标高度 / 平滑 */
|
|
89
96
|
type TerrainBrushMode = 'raise' | 'lower' | 'level' | 'smooth';
|
|
90
97
|
|
|
98
|
+
/**
|
|
99
|
+
* 一份地形高度场载荷(可直接 `JSON.stringify`)。
|
|
100
|
+
*
|
|
101
|
+
* `base` / `current` 是 base64 编码的 Float32 小端字节流,长度必须是
|
|
102
|
+
* `(segments + 1)² × 4` 字节;解码时会校验,损坏或被截断会直接报错,
|
|
103
|
+
* 而不是悄悄渲染出一块乱七八糟的地形。
|
|
104
|
+
*/
|
|
105
|
+
interface TerrainHeightsPayload {
|
|
106
|
+
/** 每边划分数(顶点数 = segments + 1) */
|
|
107
|
+
segments: number;
|
|
108
|
+
/** 边缘过渡宽度(米) */
|
|
109
|
+
slopeWidth: number;
|
|
110
|
+
/** 是否填平多边形内部空洞(与导出时一致,决定 inside 掩膜) */
|
|
111
|
+
fillHoles: boolean;
|
|
112
|
+
/** 格网经纬度范围,载入时用来核对多边形是否配错 */
|
|
113
|
+
bounds: TerrainBounds;
|
|
114
|
+
/** 原始地形高度,base64(Float32 小端) */
|
|
115
|
+
base: string;
|
|
116
|
+
/** 编辑后地形高度,base64(Float32 小端) */
|
|
117
|
+
current: string;
|
|
118
|
+
}
|
|
119
|
+
|
|
91
120
|
/** 多边形顶点输入:`[lng, lat]`、`[lng, lat, height]`、`{lng, lat}` 或 Cesium.Cartesian3 */
|
|
92
121
|
type TerrainEditPosition = [number, number] | [number, number, number] | TerrainLngLat | TerrainLngLatHeight | any;
|
|
93
122
|
/** 绘制参数 */
|
|
@@ -184,6 +213,78 @@ interface TerrainEditAreaOptions {
|
|
|
184
213
|
*/
|
|
185
214
|
cutSurface?: boolean;
|
|
186
215
|
}
|
|
216
|
+
/** 笔刷参数快照(不含只在一次笔画内有效的 `targetHeight`) */
|
|
217
|
+
type TerrainEditBrushState = Required<Omit<TerrainEditBrushOptions, 'targetHeight'>>;
|
|
218
|
+
/** 笔刷区域参数快照,便于按同样的范围重建 */
|
|
219
|
+
interface TerrainEditAreaInfo {
|
|
220
|
+
/** 区域中心 */
|
|
221
|
+
center: TerrainLngLat;
|
|
222
|
+
/** 边长(米) */
|
|
223
|
+
size: number;
|
|
224
|
+
/** 每边划分数 */
|
|
225
|
+
segments: number;
|
|
226
|
+
/** 边缘过渡宽度(米) */
|
|
227
|
+
feather: number;
|
|
228
|
+
}
|
|
229
|
+
/** 导出时一并带走的表现状态 */
|
|
230
|
+
interface TerrainEditViewState {
|
|
231
|
+
/** 水面高程(米),null 表示没有水面 */
|
|
232
|
+
waterLevel: number | null;
|
|
233
|
+
/** 是否显示等高线 */
|
|
234
|
+
contour: boolean;
|
|
235
|
+
/** 等高距(米),0 表示按高差自动取 */
|
|
236
|
+
contourInterval: number;
|
|
237
|
+
/** 是否使用影像贴图 */
|
|
238
|
+
texture: boolean;
|
|
239
|
+
/** 是否启用程序化岩土材质 */
|
|
240
|
+
cutSurface: boolean;
|
|
241
|
+
}
|
|
242
|
+
/**
|
|
243
|
+
* 地形编辑数据包(`exportData()` 的返回值)。
|
|
244
|
+
*
|
|
245
|
+
* 整体是可 `JSON.stringify` 的纯数据:没有类实例、没有 TypedArray、没有 DOM 引用,
|
|
246
|
+
* 所以能直接 `POST` 给后端、塞进 `localStorage`、写进 IndexedDB 或做成文件下载。
|
|
247
|
+
*
|
|
248
|
+
* 高度场是 **base + current** 两份:只存 current 的话,载入后就没法再算挖填方、
|
|
249
|
+
* 也没法把坡面明暗重新烘对,二次编辑会「看起来一样、但所有统计都变 0」。
|
|
250
|
+
*/
|
|
251
|
+
interface TerrainEditSnapshot {
|
|
252
|
+
/** 固定标识:`cesium-dev-kit:terrain-edit`,用来识别数据来源 */
|
|
253
|
+
kind: 'cesium-dev-kit:terrain-edit';
|
|
254
|
+
/** 数据格式版本,当前为 1;结构不兼容变更时递增 */
|
|
255
|
+
version: number;
|
|
256
|
+
/** 导出时间(ISO 8601) */
|
|
257
|
+
createdAt: string;
|
|
258
|
+
/** `area`:`setArea()` 铺的矩形;`polygon`:手绘 / `setPolygon()` 的范围 */
|
|
259
|
+
mode: 'area' | 'polygon';
|
|
260
|
+
/** `setArea()` 的原始参数,`polygon` 模式下为 null */
|
|
261
|
+
area: TerrainEditAreaInfo | null;
|
|
262
|
+
/** 编辑范围顶点(含高度) */
|
|
263
|
+
polygon: TerrainLngLatHeight[];
|
|
264
|
+
/** 高度场与重建格网所需的参数 */
|
|
265
|
+
grid: TerrainHeightsPayload;
|
|
266
|
+
/** 表现状态 */
|
|
267
|
+
view: TerrainEditViewState;
|
|
268
|
+
/** 笔刷参数,载入后可接着刷 */
|
|
269
|
+
brush: TerrainEditBrushState;
|
|
270
|
+
/** 导出时的土方统计,便于「不载入模型也能读数据」的展示场景 */
|
|
271
|
+
stats: TerrainEditStatsResult | null;
|
|
272
|
+
}
|
|
273
|
+
/**
|
|
274
|
+
* 内存形态的高度场(`getHeightField()` 的返回值)。
|
|
275
|
+
*
|
|
276
|
+
* 不需要序列化、只想马上算点东西时用它:数组是副本,改它不会影响场景。
|
|
277
|
+
*/
|
|
278
|
+
interface TerrainHeightField {
|
|
279
|
+
/** 每边划分数(顶点数 = segments + 1) */
|
|
280
|
+
segments: number;
|
|
281
|
+
/** 格网覆盖的经纬度范围 */
|
|
282
|
+
bounds: TerrainBounds;
|
|
283
|
+
/** 原始地形高度(米) */
|
|
284
|
+
base: Float32Array;
|
|
285
|
+
/** 编辑后地形高度(米);与 `base` 之差即每点挖填量(负数挖、正数填) */
|
|
286
|
+
current: Float32Array;
|
|
287
|
+
}
|
|
187
288
|
/** 创建地形编辑模块的参数 */
|
|
188
289
|
interface TerrainEditModuleOptions {
|
|
189
290
|
/** 复用 kit 的 ThreeJs 实例(必填,且需先调用 initThree) */
|
|
@@ -286,6 +387,72 @@ interface TerrainEditInstance {
|
|
|
286
387
|
* 获取当前多边形(度)。
|
|
287
388
|
*/
|
|
288
389
|
getPolygon(): TerrainLngLatHeight[];
|
|
390
|
+
/**
|
|
391
|
+
* 导出当前编辑结果,得到一份可直接 `JSON.stringify` 的数据包。
|
|
392
|
+
*
|
|
393
|
+
* **为什么是「返回数据」而不是「保存文件」**:这个模块跑在调用方的页面里,
|
|
394
|
+
* 数据落到哪儿(后端接口、localStorage、对象存储、GIS 文件、剪贴板)属于业务决定,
|
|
395
|
+
* 库不该替用户选。所以这里只产出**完整、自包含、可序列化**的快照,
|
|
396
|
+
* 存哪儿、存多久、要不要加密压缩,交给调用方;示例页里的「保存数据」
|
|
397
|
+
* 就是拿这个返回值自己做了个下载,而不是库内置了一套存储。
|
|
398
|
+
*
|
|
399
|
+
* 快照不只包含高度:二次编辑需要「原始地形 + 几何参数」才能正确重算挖填方、
|
|
400
|
+
* 重烘坡面明暗、继续用笔刷,所以 `grid.base` 与 `grid.current` 两份高度场都会带上
|
|
401
|
+
* (Float32 原样 base64,往返逐位无损),并附带多边形、区域参数、水面 / 等高线 /
|
|
402
|
+
* 贴图状态以及笔刷设置。
|
|
403
|
+
*
|
|
404
|
+
* 体量:`segments = 160` 时约 277KB(两份 161×161 的 Float32,base64 后),gzip 约 180KB。
|
|
405
|
+
* 这份开销是「无损」换来的:需要更小的载荷就降低 `setArea({ segments })`,
|
|
406
|
+
* 或者只用 `getHeightField()` 自己量化 / 转成 GeoTIFF 等格式。
|
|
407
|
+
*
|
|
408
|
+
* @returns 数据包;尚未圈定编辑范围时返回 null
|
|
409
|
+
* @example
|
|
410
|
+
* // 存到自己的后端
|
|
411
|
+
* const data = terrainEdit.exportData()
|
|
412
|
+
* await fetch('/api/terrain/1', { method: 'POST', body: JSON.stringify(data) })
|
|
413
|
+
*
|
|
414
|
+
* // 或者做成文件让用户下载(下载这一步属于业务侧,不在库里)
|
|
415
|
+
* const blob = new Blob([JSON.stringify(data)], { type: 'application/json' })
|
|
416
|
+
* const a = document.createElement('a')
|
|
417
|
+
* a.href = URL.createObjectURL(blob)
|
|
418
|
+
* a.download = 'terrain.json'
|
|
419
|
+
* a.click()
|
|
420
|
+
*/
|
|
421
|
+
exportData(): TerrainEditSnapshot | null;
|
|
422
|
+
/**
|
|
423
|
+
* 载入 `exportData()` 导出的数据,恢复到可继续编辑的状态。
|
|
424
|
+
*
|
|
425
|
+
* 与 `setPolygon()` 的关键区别:**不会再采样地形**。高度直接从数据包里恢复,
|
|
426
|
+
* 所以即使此刻没有配置地形服务、或者原地形数据已经变了,也能一模一样地复原;
|
|
427
|
+
* 载入后笔刷、撤销、统计、水面、等高线照常工作,地表贴图按新范围在后台重新取。
|
|
428
|
+
*
|
|
429
|
+
* 数据包结构不对(不是本模块导出的、版本不匹配、base64 损坏、长度对不上、
|
|
430
|
+
* 范围与 polygon 不匹配)都会抛 `INVALID_ARGUMENT`,不会渲染出一块错位的地形。
|
|
431
|
+
*
|
|
432
|
+
* @param snapshot - `exportData()` 的返回值,或它 `JSON.parse` 之后的对象;
|
|
433
|
+
* 也可以直接给 JSON 字符串(例如 `localStorage.getItem()` 的返回值),内部会自己解析
|
|
434
|
+
* @example
|
|
435
|
+
* const data = await (await fetch('/api/terrain/1')).json()
|
|
436
|
+
* terrainEdit.importData(data).enableBrush(true)
|
|
437
|
+
*
|
|
438
|
+
* // 从 localStorage 读也一样
|
|
439
|
+
* terrainEdit.importData(localStorage.getItem('terrain-1') || '')
|
|
440
|
+
*/
|
|
441
|
+
importData(snapshot: TerrainEditSnapshot | string): TerrainEditInstance;
|
|
442
|
+
/**
|
|
443
|
+
* 取当前高度场(Float32Array 副本),用于在内存里做二次计算。
|
|
444
|
+
*
|
|
445
|
+
* 不需要序列化、只要数值时用这个:不经过 base64,直接拿到 `base` / `current`,
|
|
446
|
+
* 两者之差就是每个顶点的挖填量(负数挖、正数填),可以直接喂给等高线、
|
|
447
|
+
* 坡度分析、导出成 GeoTIFF 或自己的格网格式。数组是副本,改它不影响场景。
|
|
448
|
+
*
|
|
449
|
+
* @returns 高度场;尚未圈定编辑范围时返回 null
|
|
450
|
+
* @example
|
|
451
|
+
* const field = terrainEdit.getHeightField()
|
|
452
|
+
* const delta = field.current.map((h, i) => h - field.base[i])
|
|
453
|
+
* console.log('最大挖深', Math.min(...delta))
|
|
454
|
+
*/
|
|
455
|
+
getHeightField(): TerrainHeightField | null;
|
|
289
456
|
/**
|
|
290
457
|
* 就地开辟一块可连续涂抹的地形编辑区域(不需要先画多边形)。
|
|
291
458
|
*
|
|
@@ -671,4 +838,4 @@ interface InitCesiumConstructor {
|
|
|
671
838
|
}
|
|
672
839
|
declare const initCesium: InitCesiumConstructor;
|
|
673
840
|
|
|
674
|
-
export { type CesiumContext, type CesiumContextOptions, CesiumDevKitError, type CesiumDevKitErrorCode, type CesiumDevKitErrorHandler, CesiumGlobal, type CreateKitOptions, type ResModulesType, TerrainEdit, type TerrainEditApplyOptions, type TerrainEditConstructor, type TerrainEditDrawOptions, type TerrainEditInstance, type TerrainEditMode, type TerrainEditModuleOptions, type TerrainEditPosition, type TerrainEditStatsResult, assertBrowser, createContext, createKit, disposeContext, getErrorHandler, initCesium, isBrowser, isCesiumDevKitError, reportError, setErrorHandler };
|
|
841
|
+
export { type CesiumContext, type CesiumContextOptions, CesiumDevKitError, type CesiumDevKitErrorCode, type CesiumDevKitErrorHandler, CesiumGlobal, type CreateKitOptions, type ResModulesType, TerrainEdit, type TerrainEditApplyOptions, type TerrainEditAreaInfo, type TerrainEditBrushState, type TerrainEditConstructor, type TerrainEditDrawOptions, type TerrainEditInstance, type TerrainEditMode, type TerrainEditModuleOptions, type TerrainEditPosition, type TerrainEditSnapshot, type TerrainEditStatsResult, type TerrainEditViewState, type TerrainHeightField, type TerrainHeightsPayload, assertBrowser, createContext, createKit, disposeContext, getErrorHandler, initCesium, isBrowser, isCesiumDevKitError, reportError, setErrorHandler };
|
package/dist/index.d.ts
CHANGED
|
@@ -53,6 +53,13 @@ interface TerrainLngLat {
|
|
|
53
53
|
interface TerrainLngLatHeight extends TerrainLngLat {
|
|
54
54
|
height: number;
|
|
55
55
|
}
|
|
56
|
+
/** 经纬度包围盒 */
|
|
57
|
+
interface TerrainBounds {
|
|
58
|
+
minLng: number;
|
|
59
|
+
minLat: number;
|
|
60
|
+
maxLng: number;
|
|
61
|
+
maxLat: number;
|
|
62
|
+
}
|
|
56
63
|
/** 地形编辑模式的字面量类型 */
|
|
57
64
|
type TerrainEditMode = 'sink' | 'raise' | 'flatten' | 'smooth';
|
|
58
65
|
/** 形变参数 */
|
|
@@ -88,6 +95,28 @@ interface TerrainStats {
|
|
|
88
95
|
/** 笔刷模式:抬升 / 下沉 / 整平到目标高度 / 平滑 */
|
|
89
96
|
type TerrainBrushMode = 'raise' | 'lower' | 'level' | 'smooth';
|
|
90
97
|
|
|
98
|
+
/**
|
|
99
|
+
* 一份地形高度场载荷(可直接 `JSON.stringify`)。
|
|
100
|
+
*
|
|
101
|
+
* `base` / `current` 是 base64 编码的 Float32 小端字节流,长度必须是
|
|
102
|
+
* `(segments + 1)² × 4` 字节;解码时会校验,损坏或被截断会直接报错,
|
|
103
|
+
* 而不是悄悄渲染出一块乱七八糟的地形。
|
|
104
|
+
*/
|
|
105
|
+
interface TerrainHeightsPayload {
|
|
106
|
+
/** 每边划分数(顶点数 = segments + 1) */
|
|
107
|
+
segments: number;
|
|
108
|
+
/** 边缘过渡宽度(米) */
|
|
109
|
+
slopeWidth: number;
|
|
110
|
+
/** 是否填平多边形内部空洞(与导出时一致,决定 inside 掩膜) */
|
|
111
|
+
fillHoles: boolean;
|
|
112
|
+
/** 格网经纬度范围,载入时用来核对多边形是否配错 */
|
|
113
|
+
bounds: TerrainBounds;
|
|
114
|
+
/** 原始地形高度,base64(Float32 小端) */
|
|
115
|
+
base: string;
|
|
116
|
+
/** 编辑后地形高度,base64(Float32 小端) */
|
|
117
|
+
current: string;
|
|
118
|
+
}
|
|
119
|
+
|
|
91
120
|
/** 多边形顶点输入:`[lng, lat]`、`[lng, lat, height]`、`{lng, lat}` 或 Cesium.Cartesian3 */
|
|
92
121
|
type TerrainEditPosition = [number, number] | [number, number, number] | TerrainLngLat | TerrainLngLatHeight | any;
|
|
93
122
|
/** 绘制参数 */
|
|
@@ -184,6 +213,78 @@ interface TerrainEditAreaOptions {
|
|
|
184
213
|
*/
|
|
185
214
|
cutSurface?: boolean;
|
|
186
215
|
}
|
|
216
|
+
/** 笔刷参数快照(不含只在一次笔画内有效的 `targetHeight`) */
|
|
217
|
+
type TerrainEditBrushState = Required<Omit<TerrainEditBrushOptions, 'targetHeight'>>;
|
|
218
|
+
/** 笔刷区域参数快照,便于按同样的范围重建 */
|
|
219
|
+
interface TerrainEditAreaInfo {
|
|
220
|
+
/** 区域中心 */
|
|
221
|
+
center: TerrainLngLat;
|
|
222
|
+
/** 边长(米) */
|
|
223
|
+
size: number;
|
|
224
|
+
/** 每边划分数 */
|
|
225
|
+
segments: number;
|
|
226
|
+
/** 边缘过渡宽度(米) */
|
|
227
|
+
feather: number;
|
|
228
|
+
}
|
|
229
|
+
/** 导出时一并带走的表现状态 */
|
|
230
|
+
interface TerrainEditViewState {
|
|
231
|
+
/** 水面高程(米),null 表示没有水面 */
|
|
232
|
+
waterLevel: number | null;
|
|
233
|
+
/** 是否显示等高线 */
|
|
234
|
+
contour: boolean;
|
|
235
|
+
/** 等高距(米),0 表示按高差自动取 */
|
|
236
|
+
contourInterval: number;
|
|
237
|
+
/** 是否使用影像贴图 */
|
|
238
|
+
texture: boolean;
|
|
239
|
+
/** 是否启用程序化岩土材质 */
|
|
240
|
+
cutSurface: boolean;
|
|
241
|
+
}
|
|
242
|
+
/**
|
|
243
|
+
* 地形编辑数据包(`exportData()` 的返回值)。
|
|
244
|
+
*
|
|
245
|
+
* 整体是可 `JSON.stringify` 的纯数据:没有类实例、没有 TypedArray、没有 DOM 引用,
|
|
246
|
+
* 所以能直接 `POST` 给后端、塞进 `localStorage`、写进 IndexedDB 或做成文件下载。
|
|
247
|
+
*
|
|
248
|
+
* 高度场是 **base + current** 两份:只存 current 的话,载入后就没法再算挖填方、
|
|
249
|
+
* 也没法把坡面明暗重新烘对,二次编辑会「看起来一样、但所有统计都变 0」。
|
|
250
|
+
*/
|
|
251
|
+
interface TerrainEditSnapshot {
|
|
252
|
+
/** 固定标识:`cesium-dev-kit:terrain-edit`,用来识别数据来源 */
|
|
253
|
+
kind: 'cesium-dev-kit:terrain-edit';
|
|
254
|
+
/** 数据格式版本,当前为 1;结构不兼容变更时递增 */
|
|
255
|
+
version: number;
|
|
256
|
+
/** 导出时间(ISO 8601) */
|
|
257
|
+
createdAt: string;
|
|
258
|
+
/** `area`:`setArea()` 铺的矩形;`polygon`:手绘 / `setPolygon()` 的范围 */
|
|
259
|
+
mode: 'area' | 'polygon';
|
|
260
|
+
/** `setArea()` 的原始参数,`polygon` 模式下为 null */
|
|
261
|
+
area: TerrainEditAreaInfo | null;
|
|
262
|
+
/** 编辑范围顶点(含高度) */
|
|
263
|
+
polygon: TerrainLngLatHeight[];
|
|
264
|
+
/** 高度场与重建格网所需的参数 */
|
|
265
|
+
grid: TerrainHeightsPayload;
|
|
266
|
+
/** 表现状态 */
|
|
267
|
+
view: TerrainEditViewState;
|
|
268
|
+
/** 笔刷参数,载入后可接着刷 */
|
|
269
|
+
brush: TerrainEditBrushState;
|
|
270
|
+
/** 导出时的土方统计,便于「不载入模型也能读数据」的展示场景 */
|
|
271
|
+
stats: TerrainEditStatsResult | null;
|
|
272
|
+
}
|
|
273
|
+
/**
|
|
274
|
+
* 内存形态的高度场(`getHeightField()` 的返回值)。
|
|
275
|
+
*
|
|
276
|
+
* 不需要序列化、只想马上算点东西时用它:数组是副本,改它不会影响场景。
|
|
277
|
+
*/
|
|
278
|
+
interface TerrainHeightField {
|
|
279
|
+
/** 每边划分数(顶点数 = segments + 1) */
|
|
280
|
+
segments: number;
|
|
281
|
+
/** 格网覆盖的经纬度范围 */
|
|
282
|
+
bounds: TerrainBounds;
|
|
283
|
+
/** 原始地形高度(米) */
|
|
284
|
+
base: Float32Array;
|
|
285
|
+
/** 编辑后地形高度(米);与 `base` 之差即每点挖填量(负数挖、正数填) */
|
|
286
|
+
current: Float32Array;
|
|
287
|
+
}
|
|
187
288
|
/** 创建地形编辑模块的参数 */
|
|
188
289
|
interface TerrainEditModuleOptions {
|
|
189
290
|
/** 复用 kit 的 ThreeJs 实例(必填,且需先调用 initThree) */
|
|
@@ -286,6 +387,72 @@ interface TerrainEditInstance {
|
|
|
286
387
|
* 获取当前多边形(度)。
|
|
287
388
|
*/
|
|
288
389
|
getPolygon(): TerrainLngLatHeight[];
|
|
390
|
+
/**
|
|
391
|
+
* 导出当前编辑结果,得到一份可直接 `JSON.stringify` 的数据包。
|
|
392
|
+
*
|
|
393
|
+
* **为什么是「返回数据」而不是「保存文件」**:这个模块跑在调用方的页面里,
|
|
394
|
+
* 数据落到哪儿(后端接口、localStorage、对象存储、GIS 文件、剪贴板)属于业务决定,
|
|
395
|
+
* 库不该替用户选。所以这里只产出**完整、自包含、可序列化**的快照,
|
|
396
|
+
* 存哪儿、存多久、要不要加密压缩,交给调用方;示例页里的「保存数据」
|
|
397
|
+
* 就是拿这个返回值自己做了个下载,而不是库内置了一套存储。
|
|
398
|
+
*
|
|
399
|
+
* 快照不只包含高度:二次编辑需要「原始地形 + 几何参数」才能正确重算挖填方、
|
|
400
|
+
* 重烘坡面明暗、继续用笔刷,所以 `grid.base` 与 `grid.current` 两份高度场都会带上
|
|
401
|
+
* (Float32 原样 base64,往返逐位无损),并附带多边形、区域参数、水面 / 等高线 /
|
|
402
|
+
* 贴图状态以及笔刷设置。
|
|
403
|
+
*
|
|
404
|
+
* 体量:`segments = 160` 时约 277KB(两份 161×161 的 Float32,base64 后),gzip 约 180KB。
|
|
405
|
+
* 这份开销是「无损」换来的:需要更小的载荷就降低 `setArea({ segments })`,
|
|
406
|
+
* 或者只用 `getHeightField()` 自己量化 / 转成 GeoTIFF 等格式。
|
|
407
|
+
*
|
|
408
|
+
* @returns 数据包;尚未圈定编辑范围时返回 null
|
|
409
|
+
* @example
|
|
410
|
+
* // 存到自己的后端
|
|
411
|
+
* const data = terrainEdit.exportData()
|
|
412
|
+
* await fetch('/api/terrain/1', { method: 'POST', body: JSON.stringify(data) })
|
|
413
|
+
*
|
|
414
|
+
* // 或者做成文件让用户下载(下载这一步属于业务侧,不在库里)
|
|
415
|
+
* const blob = new Blob([JSON.stringify(data)], { type: 'application/json' })
|
|
416
|
+
* const a = document.createElement('a')
|
|
417
|
+
* a.href = URL.createObjectURL(blob)
|
|
418
|
+
* a.download = 'terrain.json'
|
|
419
|
+
* a.click()
|
|
420
|
+
*/
|
|
421
|
+
exportData(): TerrainEditSnapshot | null;
|
|
422
|
+
/**
|
|
423
|
+
* 载入 `exportData()` 导出的数据,恢复到可继续编辑的状态。
|
|
424
|
+
*
|
|
425
|
+
* 与 `setPolygon()` 的关键区别:**不会再采样地形**。高度直接从数据包里恢复,
|
|
426
|
+
* 所以即使此刻没有配置地形服务、或者原地形数据已经变了,也能一模一样地复原;
|
|
427
|
+
* 载入后笔刷、撤销、统计、水面、等高线照常工作,地表贴图按新范围在后台重新取。
|
|
428
|
+
*
|
|
429
|
+
* 数据包结构不对(不是本模块导出的、版本不匹配、base64 损坏、长度对不上、
|
|
430
|
+
* 范围与 polygon 不匹配)都会抛 `INVALID_ARGUMENT`,不会渲染出一块错位的地形。
|
|
431
|
+
*
|
|
432
|
+
* @param snapshot - `exportData()` 的返回值,或它 `JSON.parse` 之后的对象;
|
|
433
|
+
* 也可以直接给 JSON 字符串(例如 `localStorage.getItem()` 的返回值),内部会自己解析
|
|
434
|
+
* @example
|
|
435
|
+
* const data = await (await fetch('/api/terrain/1')).json()
|
|
436
|
+
* terrainEdit.importData(data).enableBrush(true)
|
|
437
|
+
*
|
|
438
|
+
* // 从 localStorage 读也一样
|
|
439
|
+
* terrainEdit.importData(localStorage.getItem('terrain-1') || '')
|
|
440
|
+
*/
|
|
441
|
+
importData(snapshot: TerrainEditSnapshot | string): TerrainEditInstance;
|
|
442
|
+
/**
|
|
443
|
+
* 取当前高度场(Float32Array 副本),用于在内存里做二次计算。
|
|
444
|
+
*
|
|
445
|
+
* 不需要序列化、只要数值时用这个:不经过 base64,直接拿到 `base` / `current`,
|
|
446
|
+
* 两者之差就是每个顶点的挖填量(负数挖、正数填),可以直接喂给等高线、
|
|
447
|
+
* 坡度分析、导出成 GeoTIFF 或自己的格网格式。数组是副本,改它不影响场景。
|
|
448
|
+
*
|
|
449
|
+
* @returns 高度场;尚未圈定编辑范围时返回 null
|
|
450
|
+
* @example
|
|
451
|
+
* const field = terrainEdit.getHeightField()
|
|
452
|
+
* const delta = field.current.map((h, i) => h - field.base[i])
|
|
453
|
+
* console.log('最大挖深', Math.min(...delta))
|
|
454
|
+
*/
|
|
455
|
+
getHeightField(): TerrainHeightField | null;
|
|
289
456
|
/**
|
|
290
457
|
* 就地开辟一块可连续涂抹的地形编辑区域(不需要先画多边形)。
|
|
291
458
|
*
|
|
@@ -671,4 +838,4 @@ interface InitCesiumConstructor {
|
|
|
671
838
|
}
|
|
672
839
|
declare const initCesium: InitCesiumConstructor;
|
|
673
840
|
|
|
674
|
-
export { type CesiumContext, type CesiumContextOptions, CesiumDevKitError, type CesiumDevKitErrorCode, type CesiumDevKitErrorHandler, CesiumGlobal, type CreateKitOptions, type ResModulesType, TerrainEdit, type TerrainEditApplyOptions, type TerrainEditConstructor, type TerrainEditDrawOptions, type TerrainEditInstance, type TerrainEditMode, type TerrainEditModuleOptions, type TerrainEditPosition, type TerrainEditStatsResult, assertBrowser, createContext, createKit, disposeContext, getErrorHandler, initCesium, isBrowser, isCesiumDevKitError, reportError, setErrorHandler };
|
|
841
|
+
export { type CesiumContext, type CesiumContextOptions, CesiumDevKitError, type CesiumDevKitErrorCode, type CesiumDevKitErrorHandler, CesiumGlobal, type CreateKitOptions, type ResModulesType, TerrainEdit, type TerrainEditApplyOptions, type TerrainEditAreaInfo, type TerrainEditBrushState, type TerrainEditConstructor, type TerrainEditDrawOptions, type TerrainEditInstance, type TerrainEditMode, type TerrainEditModuleOptions, type TerrainEditPosition, type TerrainEditSnapshot, type TerrainEditStatsResult, type TerrainEditViewState, type TerrainHeightField, type TerrainHeightsPayload, assertBrowser, createContext, createKit, disposeContext, getErrorHandler, initCesium, isBrowser, isCesiumDevKitError, reportError, setErrorHandler };
|