gis-view-webgl2 0.1.11 → 0.1.13

package/docs/manual/21-/350/257/264/346/230/216/344/270/216/345/270/270/350/247/201/351/227/256/351/242/230.md

@@ -24,6 +24,9 @@
 **拖也拖不动、点了没反应，是不是坏了？**
 不是 —— 功能开关**缺省全关**（见「功能开关」），什么都不写时组件只剩画布与数据。查看类要手动打开：详细配置写 `interactive: true`（平移 / 缩放 / 右键回调）与 `clickable: true`（悬停 / 选中），或一步写 `features: 'view'`；改数据的交互各有自己的开关 —— `boxSelect: true` / `draggable: true` / `waypointEditable: true` / `copy: {…}` / `merge: {…}` / `remove: {…}` / `features: { channelDraft: true }`，`features: 'edit'` 一次全开。标签 / 提示 / 鹰眼图不在开关表里：配了 `label` / `lineLabel` / `tooltip` / `minimap` 就等于打开。
 
+**想先铺网架、再对背景，或者只把网架压淡怎么办？**
+网架展示用两个顶层配置：`networkVisible: false` 真正跳过节点、线路、通道、装饰、动画与标签（拾取和框选也停止命中），但背景、网格与自定义 WebGL 层照常显示；`networkOpacity` 在逐要素透明度之后再乘一层，适合保留交互、只把网架压淡来对底图。背景图片用 `image.corners` 摆四角（旋转后重算四角即可），GeoJSON 用 `geoJsonStyle.bounds` 独立缩放 / 平移，并用 `geoJsonStyle.rotation` 绕目标矩形中心顺时针旋转，二者都不改原始数据。对底图直接用内置编辑器：`view.beginBackgroundEdit({ aspectLocked: true, rotation: true, fitView: true })` 会自动锁住网架交互（滚轮缩放与 `fitView` 仍可用），拖动手柄即可移动、缩放和旋转；样式用同一调用的 `style` 或后续 `updateBackgroundEdit({ style })` 改，`getBackgroundEdit()` 读当前状态，`endBackgroundEdit()` 退出并恢复进入前的 `backgroundEditing`。完整演示见 `?demo=background`：锁比例时四个角点，解锁后八个缩放手柄，勾选“允许旋转”才出现第九个旋转点。
+
 **怎么一次关闭 / 打开组件的所有功能？**
 `features: false` 或 `features: 'static'` 会把全部 17 个功能开关关掉（`'static'` 连已配置的标签 / 提示 / 鹰眼图也一起关；`false` 与缺省全关同一口径）；`features: true` 或 `features: 'edit'` 全部打开。运行时用 `view.setFeatures(...)` 换、`view.getFeatures()` 读 17 项有效值，完整清单见「功能开关」一节的表。
 
@@ -93,7 +96,7 @@
 图案是 CSS 像素量屏幕距离，线很粗时应把图案调长（`[10, 6]` 在 3px 线宽下很清楚，在 12px 线宽下就显得密）；另外图案槽位上限 16 组，超过的线会退回实线。
 
 **线路怎么设线形（solid / dashed / dotted / dashdot）？**
-最短的写法是给线路数据加一个字段：`lineType: 'dashed'`（点线 `'dotted'`、点划线 `'dashdot'`、实线 `'solid'`；别名 `none` / `line` / `dash` / `dot` / `dash-dot` 都认）。要自定义图案就写 `dash: [12, 4, 2, 4]`（CSS 像素）或 `dash: { type: 'dashed', offset: 6 }`，相位也能单独写 `dashOffset`。运行中改单条用 `updateLine(id, { lineType })`（批量 `patchLines`）、改全局用 `updateLineStyle({ lineType, dashOffset })`；规则 `lineRules` 与全局 `lineStyle` 都只是「要素自己没写」时的回落，优先级别记反了：**状态样式 > 要素自身 > 规则 > `lineStyle` > 实线**，图案长度、相位与槽位上限这些注意点见「线型」一节。
+最短的写法是给线路数据加一个字段：`lineType: 'dashed'`（点线 `'dotted'`、点划线 `'dashdot'`、实线 `'solid'`；别名 `none` / `line` / `dash` / `dot` / `dash-dot` 都认）。要自定义图案就写 `dash: [12, 4, 2, 4]`（CSS 像素）或 `dash: { type: 'dashed', offset: 6 }`，相位也能单独写 `dashOffset`。运行中改单条用 `updateLine(id, { lineType })`（批量 `patchLines`）、改全局用 `updateLineStyle({ lineType, dashOffset })`；优先级是 **状态样式 > `override` 规则 > 要素自身 > 普通规则 > `lineStyle` > 实线**。普通规则只补「要素自己没写」的线型，`override: true` 的规则才会盖住逐条字段；图案长度、相位与槽位上限这些注意点见「线型」一节。
 
 **标签太多盖住画面？**
 

package/docs/steps/index.html

@@ -450,7 +450,7 @@
 				{ goal: '把每段线展开成四边形状，在顶点着色器里按法线撑开线宽。', accept: '线宽不随缩放变糊，拐点处不断裂，颜色与宽度能逐条覆盖。', source: 'src/gis-view/line.js + shaders.js' },
 				{ goal: '把世界坐标经相机矩阵投到屏幕，并实现 fitView / 滚轮缩放 / 拖动平移。', accept: '滚轮以指针位置为锚点、拖动位移跟手，fitView 能完整包住数据范围。', source: 'src/gis-view/engine.js · 相机段' },
 				{ goal: '用屏幕距离做拾取，把 hover / click / dblClick / pointer / contextMenu 接成一套回调。', accept: '每个回调都带 type / index / item；点空白不误命中，拖动不会被当成点击。', source: 'src/gis-view/utils.js + engine.js' },
-				{ goal: '把业务字段翻译成样式，再按“点自身 > 状态 > 规则 > 全局”的优先级落地。', accept: '现场改规则只重算样式、不写业务数据；选中与悬停状态仍然优先。', source: 'src/gis-view/rules.js + condition.js' },
+				{ goal: '把业务字段翻译成样式，再按“全局 > 普通规则 > 点自身 > override 规则 > 状态”的优先级落地。', accept: '现场改规则只重算样式、不写业务数据；override 规则可压过逐点样式，选中与悬停状态仍然优先。', source: 'src/gis-view/rules.js + condition.js' },
 				{ goal: '先算通道公共骨架，再按车道生成平行回线，并把两次点击变成可取消的草稿。', accept: '点两个节点能落成一条通道；回线间距稳定；取消 / 落地 / 连续新增都有回调。', source: 'src/gis-view/channel.js + engine.js' },
 				{ goal: '用 DOM 覆盖层承载标签和提示框，按视口、缩放级别与避让结果决定显示谁。', accept: '平移缩放后标签仍贴住要素；超过上限会隐藏或避让，悬停提示不阻塞画布。', source: 'src/gis-view/overlay.js' },
 				{ goal: '用两层小画布画全景与视口框，并把点击、拖动映射回主图相机。', accept: '主图缩放时视口框准确变化；点小图或拖框都能定位主图；销毁后不残留帧任务。', source: 'src/gis-view/minimap.js' },

package/docs/steps/selftest-demo.html

@@ -696,7 +696,7 @@
 				await wait(200)
 				const minBox = [...document.querySelectorAll('.demo-panel-inline .demo-slider')].find(item => item.textContent.includes('最小比例'))?.querySelector('input')
 				const maxBox = [...document.querySelectorAll('.demo-panel-inline .demo-slider')].find(item => item.textContent.includes('最大比例'))?.querySelector('input')
-				check('面板上有「最小比例 / 最大比例」两个输入框，初值就是组件缺省的两条线', Boolean(minBox) && Boolean(maxBox) && Number(minBox.value) === 0.002 && Number(maxBox.value) === 20000, `${minBox?.value ?? '没找到'} / ${maxBox?.value ?? '没找到'}`)
+				check('面板上有「最小比例 / 最大比例」两个输入框，初值就是组件缺省的两条线', Boolean(minBox) && Boolean(maxBox) && Number(minBox.value) === 0.002 && Number(maxBox.value) === 1000000000, `${minBox?.value ?? '没找到'} / ${maxBox?.value ?? '没找到'}`)
 				if (overlayView && minBox && maxBox) {
 					const atLimit = (scale, limit) => Math.abs(scale - limit) < limit * 1e-6
 					const limitsOf = () => overlayView.getOptions()
@@ -714,7 +714,7 @@
 					check('喂一个远高于上限的比例：setCamera 被夹在上限上', atLimit(overlayView.getCamera().scale, high), `上限 ${high} · 相机 ${overlayView.getCamera().scale}`)
 					popoverButton('解除限制')?.click()
 					await wait(200)
-					check('「解除限制」回到组件缺省的两条线', Number(minBox.value) === 0.002 && Number(maxBox.value) === 20000, `${minBox.value} ~ ${maxBox.value}`)
+					check('「解除限制」回到组件缺省的两条线', Number(minBox.value) === 0.002 && Number(maxBox.value) === 1000000000, `${minBox.value} ~ ${maxBox.value}`)
 				}
 				const liveRow = [...document.querySelectorAll('.demo-panel-inline label')].find(item => item.textContent.includes('线路实时跟随'))
 				const liveBox = liveRow?.querySelector('input')