/** * 位置符号合成计划层 —— 批次 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), } }