在鸿蒙PC上做桌面工作台,不是把手机App拉宽。原文用纯ArkTS + ArkUI实现“织界 · SiteWeave”城市立面测绘工作台,先遇到四个工程问题:窗口可拖宽后布局如何响应,鼠标滚轮、悬停、拖拽交互从哪一层设计,性能受限时巨大画布用什么画,以及能否做到全文零位图。下面按桌面形态、资源策略、Canvas 2D渲染管线、重绘调度、桌面输入和工程边界拆解可复用的做法。
一、桌面形态:三栏并列、模态不替代世界、切换数据不重置环境
工程把桌面工作台拆成形态、渲染、资源策略三件事。默认界面是“街巷档案—立面点云视口—测绘校核”三栏并列,宽屏同时铺开项目列表、工作画布和参数检查器。模态对话框宽度取92%,再用constraintSize({ maxWidth: 520 })限死,背景虽然压暗但仍保留三栏上下文。这是鸿蒙PC与手机的关键差异:弹窗应辅助当前工作,而不是全屏替代。
另一个容易忽略的细节是切换项目不重置工作环境。换到“阜丰里仓库”后,视口点云、右侧评分、左侧选中态一起刷新,但窗口尺寸、相机视角、缩放级别不变。原文明确要求相机状态以组件成员承载,onAreaChange只更新画布尺寸并重绘,不随数据源重建相机。桌面用户会默认“只是换了要看的数据,不是重新打开程序”。
二、零位图资源策略:Path/Rect/Row加Canvas绘制指令
工程只有两个SVG应用图标,没有任何PNG/JPG位图资源。图标与排版使用ArkUI的Path、Rect、Row等矢量形状,场景与数据可视化使用Canvas绘制指令,颜色、圆角、阴影负责质感。收益有三点:矢量按逻辑单位绘制并由系统渲染器缩放,适配高分屏和任意窗口尺寸的成本低;改立面颜色、遮罩色调、平面图底纹只需改常量或绘制代码;所有视觉先有数据再画出来,迫使界面和场景建立在一套清晰数据结构上。
代价也要讲清楚:照片级树影、水彩质感、复杂拟真纹理不适合硬用Path拼。更准确的取舍是“能用矢量表达的成本极低,需要照片的地方果断放弃”。对一座要反复缩放、切换着色模式的立面,矢量是合适选择。
三、Canvas 2D渲染管线:确定性点云、画家算法与提前裁剪
原文强调先用平台原生2D能力把交互链路跑通,确认手感与数据模型,再按测量结果决定是否换GPU、XComponent或着色器。工程用CanvasRenderingContext2D跑到约一万八千点,仍保持可接受帧率。
几何数据不能依赖外部文件,否则换机器或重建一次画面对不上。工程用固定种子的线性同余发生器在本地生成点云:
- // entry/src/main/ets/rendering/FacadeRenderer.ets : 35-46
- class SurveyRandom {
- private value: number;
- constructor(seed: number) {
- this.value = seed;
- }
- next(): number {
- this.value = (this.value * 1664525 + 1013904223) % 4294967296;
- return this.value / 4294967296;
- }
- }
复制代码
1664525与1013904223是LCG参数,% 4294967296保证32位循环。种子固定,同一张面在同一次会话里始终是同一批点,旋转、缩放、切换着色模式时不会出现点云“变样”。
ensureModel里还有几个可抄走的性能与结构手法:函数开头判断variant没变且points已有就直接返回,避免每次重绘重建点云;先铺满墙面候选点,再用continue跳过窗洞与店门内的点,而不是推导复杂采样方程;砖墙、电线、行道树、工业立管由同一variant分支差异化叠加,让不同项目有辨识度又不散落重复代码。原文中variant为2时墙点18500,其余15200,种子为2601 + variant * 971。
render阶段是一套“带相机的2.5D绘制流”。每个相机参数的cos/sin只算一遍,深度值depth写回点本身供排序;按depth从远到近sort,用画家算法得到遮挡,不引入深度缓冲;透视系数用9 / Math.max(3, 9 - depth),既防深度接近9时系数爆炸,也让近处远点保持有限;屏幕外的点先算screenX/screenY与半径,越界直接continue,省下fill调用;每种模式配色预计算,循环内只做分支选择;四种模式共享同一份点云,只决定用fillRect还是ellipse。
四、重绘调度:16ms合并请求,@Watch显式触发
Canvas 2D是同步绘制,如果事件回调里直接调render,一次滚轮会触发几十次全量重绘。工程用16ms定时器合并同一帧内的多次状态变更:
- // entry/src/main/ets/components/FacadeViewport.ets : 73-95
- private draw(): void {
- if (this.drawTimer >= 0) {
- return;
- }
- this.drawTimer = setTimeout(() => {
- this.drawTimer = -1;
- const density = this.getUIContext().vp2px(1);
- this.renderer.render(this.context, this.widthPx, this.heightPx, this.camera, this.variant,
- this.pointScale, this.splatOpacity, this.renderMode, density, this.showDesign);
- }, 16);
- }
复制代码
要点是已有定时器就不要再排新任务。页面退出时用aboutToDisappear()执行clearTimeout,避免回调悬空。所有改变画面内容的@Watch回调,包括variant、pointScale、splatOpacity、showDesign、frameAngle,都要显式调用draw(),保证状态一变画面必然刷新。
五、桌面输入:滚轮指数映射、手势并行、悬停控件复用
滚轮缩放在onAxisEvent中取垂直增量,再执行zoom * Math.exp(-delta * 0.08)。指数曲线对增量是比例性的,小幅滚动细腻、大幅滚动跨度统一,不会“滚一点就飞远”或“滚半天没反应”。setZoom里再把范围钳制在[0.58, 2.15]。
拖拽与捏合可以并存:PanGesture用.gesture挂,PinchGesture用.parallelGesture挂,互不打断。pan模式下拖拽平移画布,否则拖动即旋转视角;俯仰角钳制在[-0.7, 0.7],旋转不会把立面翻到背面。相机状态保存在组件成员里,所以拖窗口不会重置视角。
悬停态收敛为一个通用UtilityButton控件,内部用@State hovered记录状态,所有按钮共用同一套悬停逻辑,而不是每个按钮各写一份。高分屏换算则在draw中通过getUIContext().vp2px(1)取得density,再传入渲染器。
六、工程边界与验证:导出是界面契约,不是写文件实现
原文专门提醒:“导出测绘成果”对话框当前只把所选格式记进状态、弹一条“已加入本地队列”的toast,并没有真正写文件。它演示的是导出能力的界面契约,不是导出实现;把占位换成真实管线需要另行实现。这一点在技术分享中必须讲明,否则容易把演示界面误当成可交付能力。
验证以鸿蒙PC真机完整桌面为准。原文截图覆盖模态补采对话框、默认三栏工作台、切换项目后的点云与评分刷新、导出格式对话框,以及“采集”页签中312帧注册影像、关键帧八格序列和街面覆盖平面图。后者全部由Rect、Path等矢量元素或Canvas指令拼出,没有位图。验证时重点看切换数据后相机与缩放是否被重置、连续滚轮是否触发全量重绘、高分屏下矢量是否发虚。
总结可复用的方法:桌面工作台先处理形态、渲染、资源三件事;零位图是低成本适配策略,但复杂拟真纹理要果断放弃;点云用固定种子LCG保证确定性;ensureModel提前返回并用continue剔除窗洞;render用画家算法、包围盒裁剪和预计算颜色;重绘用16ms合并;滚轮用指数映射;PanGesture与PinchGesture并行;相机状态成员化,不随数据源重建。 |