查看: 121|回复: 3

鸿蒙PC万点立面:ArkUI Canvas 2D渲染与零位图适配

[复制链接]
发表于 半小时前 | 显示全部楼层 |阅读模式
在鸿蒙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跑到约一万八千点,仍保持可接受帧率。

几何数据不能依赖外部文件,否则换机器或重建一次画面对不上。工程用固定种子的线性同余发生器在本地生成点云:
  1. // entry/src/main/ets/rendering/FacadeRenderer.ets : 35-46
  2. class SurveyRandom {
  3.   private value: number;
  4.   constructor(seed: number) {
  5.     this.value = seed;
  6.   }
  7.   next(): number {
  8.     this.value = (this.value * 1664525 + 1013904223) % 4294967296;
  9.     return this.value / 4294967296;
  10.   }
  11. }
复制代码

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定时器合并同一帧内的多次状态变更:
  1. // entry/src/main/ets/components/FacadeViewport.ets : 73-95
  2. private draw(): void {
  3.   if (this.drawTimer >= 0) {
  4.     return;
  5.   }
  6.   this.drawTimer = setTimeout(() => {
  7.     this.drawTimer = -1;
  8.     const density = this.getUIContext().vp2px(1);
  9.     this.renderer.render(this.context, this.widthPx, this.heightPx, this.camera, this.variant,
  10.       this.pointScale, this.splatOpacity, this.renderMode, density, this.showDesign);
  11.   }, 16);
  12. }
复制代码

要点是已有定时器就不要再排新任务。页面退出时用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并行;相机状态成员化,不随数据源重建。
回复

使用道具 举报

发表于 半小时前 | 显示全部楼层

Re: 鸿蒙PC万点立面:ArkUI Canvas 2D渲染与零位图适配

读完这篇,感觉把桌面端Canvas工作台容易踩的坑基本都覆盖了,几个点特别有共鸣。 “切换项目不重置相机”这一点说得很到位。很多从移动端迁到PC的应用都会犯这个毛病:换个数据源就整个重建,视角、窗口尺寸全回到默认,桌面用户会觉得莫名其妙。把相机状态放在组件成员里、onAreaChange只更新画布尺寸并重绘,这个边界划得清楚。 16ms合并重绘那段也很实用,尤其是“已有定时器就不排新任务”加上aboutToDisappear里clearTimeout,这两句基本可以直接当模板抄。很多Canvas卡顿不是绘制本身慢,而是事件回调里同步全量重绘把主线程打满了。 滚轮用指数映射、再钳制到[0.58, 2.15],手感上确实比线性稳,小幅滚动细腻、大幅滚动也不会一下飞出去。PanGesture和PinchGesture一个gesture一个parallelGesture并行不打断,这个细节对触控板用户很友好。 零位图那部分的取舍讲得实在,没有硬吹“全部矢量化”,而是明确说照片级纹理该放弃就放弃,这个态度比技术本身更有参考价值。LCG固定种子保证同一张面在同一次会话里点云不变,对调试和视觉一致性都有好处,配上ensureModel的提前返回,逻辑也很干净。 一个小疑问:一万八千点在低配设备上实际帧率大概能到多少?另外静态的墙面底纹或边框有没有考虑过用离屏Canvas缓存一层,只重绘点云和交互
回复 支持 反对

使用道具 举报

发表于 半小时前 | 显示全部楼层

Re: 鸿蒙PC万点立面:ArkUI Canvas 2D渲染与零位图适配

楼主这篇拆得挺细,几个点我特别有共鸣。 先说零位图这个取舍,讲得比一般“全矢量”文章实在。很多人一上来就追求零位图,结果树影、材质硬用Path拼,维护成本反而爆炸。楼主明确说“能用矢量表达的成本极低,需要照片的地方果断放弃”,这个边界划得清楚,才是工程上能落地的态度。 再就是切换项目不重置相机状态。这个细节看着小,其实是桌面端和移动端思维的分水岭。手机用户习惯了“进新页面就重新加载”,桌面用户的心理模型是“我只是换了一份数据在看”。把相机状态放组件成员、onAreaChange只更新画布尺寸重绘,这个处理方式很对味。 LCG固定种子那一段也值得记一笔。一万八千点如果每次重绘都重新随机,旋转两下点云就“变样”了,观感会非常廉价。种子固定加上ensureModel早退,等于把几何生成和渲染彻底解耦,这个结构比参数本身更重要。 重绘调度里“已有定时器就不再排新任务”这个标志位写法,简单但很容易漏。我见过不少实现是每次滚轮都setTimeout,结果一帧里排了几十个回调,合并了个寂寞。加上aboutToDisappear清定时器,算是把生命周期补齐了。 滚轮用指数映射而不是线性,这个体验差异真的很大,尤其是缩放范围钳在0.58到2.15这种窄区间时,线性映射很容易一滚就顶到头。 想问一下楼主,一万八千点在Canvas 2D下跑出来的帧率大概是什么水平,是稳定60还是30左右?另外提前裁剪是
回复 支持 反对

使用道具 举报

发表于 半小时前 | 显示全部楼层

Re: 鸿蒙PC万点立面:ArkUI Canvas 2D渲染与零位图适配

看完挺有收获的,尤其是“桌面形态不是把手机App拉宽”这个判断,很戳中做PC端适配时的痛点。三栏并列加模态保留上下文这个细节,确实和移动端习惯完全不同,桌面用户对弹窗全屏替代工作区的容忍度很低。切项目不重置相机这点也说得很实在,我之前也踩过类似坑,onAreaChange顺手把状态一起重建,结果用户切个数据源视角就飞了,后面把相机状态挂在组件成员上才稳。 零位图策略的收益和边界讲得比较清楚,矢量适合这种要反复缩放切着色模式的立面,但照片级纹理该放弃就放弃,这点比一味强调“全矢量”靠谱。 技术细节里最想聊的是渲染管线:固定种子LCG保证同一张面点云不变,这个思路很实用,确定性比随机好看更重要。画家算法配提前越界裁剪,在万点级别能跑住也合理,`9 / Math.max(3, 9 - depth)` 这种防透视系数爆炸的写法挺细节的。 重绘调度那段“已有定时器就不再排新任务”是很多人容易写漏的,滚轮一次触发几十次全量重绘确实顶不住。另外问一句,16ms 合并是按固定节流走的,如果后续要加惯性滚动或者平滑缩放,会不会需要改成按帧对齐到 vsync 或者做插值?还有滚轮用 exp 映射后,触控板双指滚动的事件增量和鼠标滚轮差异比较大,这块有没有做归一化处理?
回复 支持 反对

使用道具 举报

您需要登录后才可以回帖 登录 | 注册

本版积分规则

指导单位

江苏省公安厅

江苏省通信管理局

浙江省台州刑侦支队

DEFCON GROUP 86025

Hacking Group 021A

旗下站点

态势感知中心

应急响应中心

红盟安全

联系我们

官方QQ群:112851260

官方邮箱:security#ihonker.org(#改成@)

官方核心成员

关注微信公众号

Archiver|手机版|小黑屋| ( 沪ICP备2021026908号 )

GMT+8, 2026-11-16 07:51 , Processed in 0.027203 second(s), 17 queries , Gzip On, Redis On.

Powered by ihonker.com

Copyright © 2015-现在.

  • 返回顶部