| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238 |
- /**
- * 位置符号合成计划层 —— 批次 3 的唯一新接缝(规格 10 / 执行票 16)。
- *
- * 输入对象种类、状态、行业或设备类型与修饰(无设备、未关联),输出完整合成计划:
- * 外层母版选型(实心/镂空白水滴)、内层行业图标与几何、尺寸(宽度基准)、
- * 尖端锚点偏移、着色策略与降饱和标记。地图标记、设备符号、图例从此都问本层要
- * "这个对象长什么样",不再各自拼装母版/内层/尺寸/锚点。
- *
- * 母版与内层图标走 manifest 语义 key(`markerAssets.js` 解析),本层不拼物理路径。
- * 色相仍由调用方注入(tokens 单一口径),本层只输出「用什么色键」。
- *
- * 实测依据(research/measure-master.mjs,与票 05 一致):
- * 母版 512×512 画布,bbox 378×475(宽高比 1.2566),尖端 x=49.87%、y=1.0;
- * 圆帽帽心相对高度 0.397、相对宽 49.9%;内层直径 = 60% 圆帽区域(≈0.60 × 母版宽)。
- */
- import { isBusinessAttentionStatus, unassociatedVisualFor } from './pointStatus.js'
- import { MASTER_ASPECT, MASTER_SOURCE, markerMetricsFor } from './markerMetrics.js'
- import { facilityStatusTone, facilityVisualStatus } from './facilityStatus.js'
- /** 母版素材属性(实测登记,两个母版同形同包围盒)。尺寸关系来自单源 `markerMetrics.MASTER_SOURCE`。 */
- export const MASTER_GEOMETRY = {
- /** 画布内不透明包围盒(px,512 画布) */
- bbox: { x: 67, y: 19, width: MASTER_SOURCE.bboxWidth, height: MASTER_SOURCE.bboxHeight },
- /** 高 / 宽 */
- aspect: MASTER_ASPECT,
- /** 尖端(锚点)相对 bbox:x 49.87%、y 100% */
- anchor: { x: 0.4987, y: 1.0 },
- /** 圆帽帽心相对 bbox:x 49.9%、y 0.397 */
- capCenter: { x: 0.499, y: 0.397 },
- /** 内层图标直径 = 80% × 母版宽(走查反馈 60% 看不清 → 80%;圆帽区占母版宽约 88%,80% 仍在安全区内) */
- innerDiameterRatio: 0.8,
- }
- // 宽度基准、pad 比例、绘制宽**全部**来自单源 `domain/markerMetrics.js`(票 72 规格 / 票 82)。
- // 本层不再持有任何尺寸常量:旧宽度基准与 pad 换算常量已退役(票 82),
- // 消费方只需继续读 `plan.size` / `plan.draw`(返回形状不变)。
- /**
- * 内层行业/设备图标映射(`CockpitIcon` 同一套语义名 → markerAssets 的 manifest key)。
- * 键 = `industry`(GAS/WATER_SUPPLY/DRAINAGE/MANHOLE)或设备类型语义(后端行业枚举)。
- */
- const INNER_ICONS = {
- GAS: 'gas',
- WATER_SUPPLY: 'water',
- DRAINAGE: 'drainage',
- MANHOLE: 'manhole',
- }
- /** @param {string} industry 后端行业枚举值 */
- export function innerIconFor(industry) {
- return INNER_ICONS[industry] || ''
- }
- /**
- * 设施点内层图标(票 68):四类设施各一枚可辨符号(语义名 → manifest `marker.inner.*`)。
- *
- * 与行业图标**分开一张表**:设施类型不是行业(水源地/用水户没有行业图标语义),
- * 借用行业图标会让「水厂」和「供水设备」看起来是同一类对象。
- */
- const FACILITY_INNER_ICONS = {
- WATER_PLANT: 'facilityPlant',
- PUMP_STATION: 'facilityPump',
- WATER_SOURCE: 'facilitySource',
- WATER_USER: 'facilityUser',
- PIPE_NETWORK: 'pipeSpecial',
- ENGINEERING_FACILITY: 'pipeSpecial',
- }
- /** @param {string} facilityType 设施类型(WATER_PLANT/PUMP_STATION/WATER_SOURCE/WATER_USER) */
- export function innerIconForFacilityType(facilityType) {
- return FACILITY_INNER_ICONS[facilityType] || ''
- }
- /**
- * 管线构件内层图标(票 101):阀门/弯头/三通/特殊管点各一枚,窨井复用既有窨井图标。
- * 与行业图标、设施图标**各一张表**:构件类别既不是行业也不是设施类型。
- */
- const PIPE_COMPONENT_ICONS = {
- valve: 'pipeValve',
- elbow: 'pipeElbow',
- branch: 'pipeBranch',
- other: 'pipeSpecial',
- }
- /** @param {string} componentKind 构件类别(valve/elbow/branch/other);窨井按行业判定 */
- export function innerIconForPipeComponent(componentKind, industry) {
- if (industry === 'MANHOLE') return 'manhole'
- return PIPE_COMPONENT_ICONS[componentKind] || PIPE_COMPONENT_ICONS.other
- }
- /**
- * 状态 → 色键(tokens 语义键)。色值本身仍只在 tokens.css 一份,本表只定「用哪一档」。
- * 与 domain/pointStatus.js 的 POINT_STATUS_VISUALS 同一状态词表口径。
- */
- const TONE_BY_STATUS = {
- ALARM: 'lv1',
- WARNING: 'lv2',
- WORK_ORDER: 'lv3',
- NORMAL: 'lv4',
- OFFLINE: 'neutral',
- EMPTY: 'neutral',
- UNKNOWN: 'neutral',
- }
- /**
- * 合成计划(纯函数,无副作用)。
- *
- * @param {object} input
- * @param {'monitoring-point'|'monitoring-device'|'facility-point'|'pipe-component'} input.kind 对象种类
- * @param {string} input.status 点位聚合状态(ALARM/WARNING/WORK_ORDER/NORMAL/OFFLINE/EMPTY/UNKNOWN)或设备自身状态
- * @param {string} [input.industry] 后端行业枚举(GAS/WATER_SUPPLY/DRAINAGE/MANHOLE)
- * @param {string} [input.facilityType] 设施类型(仅 kind='facility-point':四类设施之一)
- * @param {string} [input.componentKind] 构件类别(仅 kind='pipe-component':valve/elbow/branch/other)
- * @param {boolean} [input.unassociated] 未关联设备(无监测点归属)
- * @param {string} [input.tone] 覆盖色键(默认按状态词表推导;调用方读 tokens 后也可直接给)
- * @returns {{
- * master: 'solid'|'hollow',
- * inner: { icon: string, enabled: boolean, diameterRatio: number, center: {x:number,y:number} },
- * size: { width: number, height: number },
- * anchor: { x: number, y: number },
- * tint: string,
- * effectStatus: string,
- * desaturate: boolean,
- * labelOffsetY: number,
- * labelMaxWidth: number,
- * draw: { width: number, height: number, pad: number },
- * }}
- */
- export function planMarker({ kind, status, industry = '', facilityType = '', componentKind = '', unassociated = false, tone }) {
- const isPoint = kind === 'monitoring-point'
- // 票 68:设施点用**设施类型图标**而不是行业图标;母版恒实心、不降饱和
- //(设施点的「类型」靠图标区分,状态靠色键,与独立设备点同一套读法)。
- const isFacility = kind === 'facility-point'
- // 票 101:管线构件点位同理——图标按构件类别(阀门/弯头/三通/特殊管点/窨井),
- // 颜色由调用方给行业色(toneHex 直传),不走状态色键。
- const isComponent = kind === 'pipe-component'
- // 无设备的监测点:只对监测点语义成立(EMPTY 是点位六态,设备五态没有它)。
- const empty = isPoint && status === 'EMPTY'
- // 未关联设备:无监测点归属的设备,走镂空 + 行业图标 + 降饱和。
- const unassoc = !isPoint && !isFacility && !isComponent && unassociated === true
- // 色键:默认按状态词表推导;调用方可显式覆盖(如设备自身状态表与点位表并行的场合)。
- const effectStatus = isFacility ? facilityVisualStatus(status) : isComponent ? '' : status || ''
- // 未关联设备的色键必须走 `unassociatedVisualFor()`(维护者 2026-11-16):
- // 该函数在 NORMAL 时给黄绿 `point-unassociated`,压过普通的在线绿。
- // 旧实现只查 `TONE_BY_STATUS`,于是未关联与已关联设备**同为 lv4 绿**,
- // 仅靠「镂空 + 降饱和」区分 —— 图上是个暗淡绿点,与图例的黄绿对不上。
- const unassocTone = unassoc ? (unassociatedVisualFor(status) || {}).tone : ''
- const tint = tone || (isFacility
- ? facilityStatusTone(status)
- : unassocTone || TONE_BY_STATUS[status]) || 'neutral'
- // 母版归属(规格 10):监测点与关联监测设备 = 实心;EMPTY 点位与未关联设备 = 镂空。
- const master = empty || unassoc ? 'hollow' : 'solid'
- // 内层图标:EMPTY 点位不用;设施点按设施类型;构件点按构件类别;其余按行业(未知行业不画内层)。
- const innerIcon = isFacility
- ? innerIconForFacilityType(facilityType)
- : isComponent
- ? innerIconForPipeComponent(componentKind, industry)
- : innerIconFor(industry)
- const innerEnabled = !empty && innerIcon !== ''
- // 尺寸全部来自单源 `markerMetrics`:本体宽、描边 pad、绘制宽。pad 按**本档**比例缩放,
- // 设备不再吃监测点的换算比(设备 pad 2.22、绘制宽 25.44;监测点 2.86 / 32.72)。
- // 锚点/尖端仍按**本体**几何(pad 只是描边画布余量)。
- const { bodyWidth: width, height, pad: padScreen, drawWidth, drawHeight } = markerMetricsFor(kind)
- // 锚点 = 尖端(相对 bbox 的比例,宽度基准下高度随比例缩放)。
- const anchor = { ...MASTER_GEOMETRY.anchor }
- // 内层几何:直径 60% × 母版宽,圆心对齐帽心(相对 bbox)。
- const inner = {
- icon: innerEnabled ? innerIcon : '',
- enabled: innerEnabled,
- diameterRatio: MASTER_GEOMETRY.innerDiameterRatio,
- center: { ...MASTER_GEOMETRY.capCenter },
- }
- // 降饱和:未关联设备的附加弱化。票 45 裁定「附加状态不抢业务状态」的**反向**也要成立——
- // 业务异常(报警/预警/工单处置)的未关联设备**不降饱和**:一台正在报警的设备被画成灰的,
- // 等于附加状态把业务严重性又抢走了一次(规格 10 的降饱和原本以「无业务异常」为前提)。
- //
- // 2026-11-16(维护者实测图):**NORMAL 也不降饱和**。它的黄绿是图例登记色,
- // 再叠 saturate(0.55) brightness(0.72) 会压成暗绿,与图例「独立设备」的亮黄绿对不上;
- // 「没挂到点位上」这层信息由**镂空母版 + 黄绿色键**表达,不需要再调暗一次。
- // 仍降饱和的只剩真正没有信息量的:离线、状态未发布。
- const desaturate = unassoc && !isBusinessAttentionStatus(status) && status !== 'NORMAL'
- // 文字标签偏移(px,Cesium pixelOffset 正值向下):BOTTOM 锚定下标记从尖端向上画,
- // 标签须在**图标上方**——偏移 = -(本体高 + 描边余量 + 间距)。
- // 批次 3 第三轮:底板样式改由 label 自带(showBackground),间距放宽到 3px;走查再校。
- const labelOffsetY = -(height + padScreen + 3)
- // 文字限宽(走查 2.2 倍仍嫌窄 → **2.6 倍**;底板 padding 同步收窄让文字更贴近框边)。
- const labelMaxWidth = Math.round(width * 2.6 * 100) / 100
- return {
- master, inner, size: { width, height }, anchor, tint, desaturate, effectStatus,
- labelOffsetY, labelMaxWidth,
- // billboard 绘制尺寸(含描边余量)与 pad 屏显值——引擎按它设 billboard 宽高。
- draw: { width: drawWidth, height: drawHeight, pad: padScreen },
- }
- }
- /**
- * 合成计划 → 宿主 `data-*` 读数(规格 10 的宿主观测接缝)。
- * 全部为扁平短值,供走查断言「母版种类/内层图标/锚点偏移/降饱和」而不读渲染内部。
- */
- export function planToDataset(plan) {
- return {
- markerMaster: plan.master,
- markerInner: plan.inner.enabled ? plan.inner.icon : '',
- markerAnchor: `${plan.anchor.x},${plan.anchor.y}`,
- markerDesaturate: plan.desaturate ? 'yes' : 'no',
- }
- }
- /**
- * 合成计划 → **几何读数**(票 83 / 规格接缝二):实际渲染的本体宽 / 绘制宽 / pad。
- *
- * 为什么要单独一个读数面:`planToDataset` 只证明「选了哪种母版/有没有内层」,
- * 走查无法据此核对「屏幕上这条标记到底多宽」。几何读数把渲染真值摊平成字符串,
- * 闸门拿它跟单源 `markerMetrics` 的派生值对账,**不读 DOM 内部结构**。
- *
- * 两位小数统一格式(27 → "27.00"):可比对、不随浮点尾巴抖动。
- *
- * @param {object} plan `planMarker()` 的输出
- * @returns {{markerWidth:string, markerDrawWidth:string, markerPad:string}}
- */
- export function markerGeometryDataset(plan) {
- return {
- markerWidth: plan.size.width.toFixed(2),
- markerDrawWidth: plan.draw.width.toFixed(2),
- markerPad: plan.draw.pad.toFixed(2),
- }
- }
|