Files
template/docs/render-guide/basics/layer-transform-performance.md

141 lines
8.4 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 层级、变换与性能
元素摆好位置之后,还会遇到三类问题:层级怎么沿树生效、怎么缩放旋转与混合、什么时候该缓存。这三件事都写在元素属性上,不需要额外的图层对象。理解它们的前提是渲染树:层级、变换与缓存都沿着父子关系生效,不是全局开关。
<div id="渲染树层级与绘制顺序"></div>
## 前置知识
阅读本篇前,建议先读完:
- [容器与坐标](./container-and-coordinates.md)
- [通用参数](./common-props.md)
## 渲染树、层级与绘制顺序
元素组成一棵渲染树:子元素相对父元素定位,绘制顺序、变换与缓存都沿父子关系生效。同一父级下的兄弟按 `zIndex` 从小到大绘制,命中顺序相反;`zIndex` 只在兄弟之间比较,父级的 `zIndex` 带着整棵子树参与父级兄弟的排序。`zIndex` 与 `hidden` 的完整语义见[通用参数页](./common-props.md#zindex)。
UI 栈也遵循同一套规则。控制器把每个打开的面板当作 UI 容器下的兄弟,按栈顺序分配递增的 `zIndex`;面板之间的遮挡由打开顺序与显示策略决定,面板内部的 `zIndex` 只影响这棵子树内部。先看面板在哪个栈、哪个位置,再看面板内部的兄弟顺序。
## 变换:scale、rotate 与 transform
`scale` 是 `[x, y]` 数组,分别表示横向与纵向缩放比例;`rotate` 的单位是弧度,不是角度。两者都作用在元素自己的坐标系里,锚点就是变换中心:缩放与旋转都绕锚点进行。默认锚点在左上角;改成 `[0.5, 0.5]` 后,同一个缩放或旋转会绕中心进行,元素的视觉位置与扩展方向都会跟着改变。
`scale` 与 `rotate` 是底层 `transform` 的简写:`transform` 属性可以直接接收一个 `Transform` 对象,用来表达更一般的矩阵与平移。日常写界面用 `scale` / `rotate` 就够了;需要直接替换整个变换矩阵时再传 `transform`,本篇不展开构造方式。
```tsx
// scale 写 [x, y];rotate 写弧度。两者都是 transform 的简写属性
<g-rect loc={[40, 40, 120, 80]} fillStyle="#2f6fed" scale={[1.2, 0.8]} />
<g-rect loc={[220, 40, 120, 80]} fillStyle="#f2b84b" rotate={Math.PI / 12} />
// 同一个变换换锚点:anc 决定绕哪个点缩放 / 旋转
<g-rect
loc={[40, 180, 120, 80]}
fillStyle="#2f6fed"
scale={[1.2, 0.8]}
anc={[0.5, 0.5]}
/>
<g-rect
loc={[220, 180, 120, 80]}
fillStyle="#f2b84b"
rotate={Math.PI / 12}
anc={[0.5, 0.5]}
/>
```
`scale` 只写一个数字不会生效。需要等比缩放时写 `scale={[1.2, 1.2]}`,需要压扁时分别给两个值。`rotate` 想转 30 度要写 `Math.PI / 6`;写成 `30` 会转很多圈。
`container` 默认开启缓存。对默认缓存的容器做 `scale` 或 `rotate` 时,引擎会先画出缓存图,再对这张图做变换;缓存图被缩放或旋转后会重新采样,边缘可能发糊。需要清晰变换时,给做变换的容器加 `nocache`,让子元素按变换直接绘制。
下面四组对比同一个 `scale` 或 `rotate` 在 `anc={[0, 0]}` 与 `anc={[0.5, 0.5]}` 下的差异。每组锚点位置的白点就是变换中心:`anc={[0, 0]}` 以左上角为基准,缩放向右下方展开、旋转绕左上角扫过;`anc={[0.5, 0.5]}` 以中心为基准,缩放向四周展开、旋转绕中心转动,两者的视觉位置也不同。
<ClientOnly>
<RenderDemo :loader="layerTransformLoader" :width="480" :height="320" />
</ClientOnly>
## 变换沿树传递
父级的平移、缩放、旋转会复合到子级。父级移动,子级跟着移动;父级放大,子级的坐标与尺寸都按放大后的比例理解;父级旋转,子级的局部坐标轴也跟着旋转。子元素不需要知道父级做了哪些变换,它只按自己的局部坐标描述内容。
```tsx
// 父容器放大 1.5 倍;加 nocache 让子元素按变换直接绘制,避免缓存图被重采样
<container loc={[80, 40, 140, 100]} scale={[1.5, 1.5]} nocache>
<g-rect loc={[0, 0, 140, 100]} fill fillStyle="#2f6fed" />
<text loc={[12, 12]} text="局部坐标 140×100" fillStyle="#e8f0ff" />
</container>
```
子矩形的 `loc` 仍是 `[0, 0, 140, 100]`,但父级放大后,它在画布上占 210×150。文字也一起放大,包括字形。要反过来「让子元素不跟着放大」,不能靠给子元素写一个 0.667 的 `scale` 去抵消——父级变换已经作用在整棵子树上;正确做法是把需要独立缩放的内容移出这个父级,放到另一个不被缩放的容器里。
嵌套变换不要用「把每层坐标累加成屏幕坐标」的心算。按树逐层理解:先看元素在父容器里的局部坐标,再看父容器在它自己父级里的位置与变换。需要跨元素比较位置时,用事件里的 `absoluteX` / `absoluteY`(画布坐标),不要自己把若干层的 `x` / `y` 相加。
下面左侧的父容器放大了 1.5 倍,子元素仍按局部坐标写;右侧是同一棵子树未缩放的参考。
<ClientOnly>
<RenderDemo :loader="layerTransformTreeLoader" :width="480" :height="320" />
</ClientOnly>
## 缓存:cache 与 nocache {#缓存与脏更新}
默认值只作判断起点:`container` 默认缓存;`text`、`image` 与全部 `g-*` 图形默认不缓存。
- 什么时候开:结构复杂、内容稳定、重复绘制成本高的子树。
- 什么时候不开:内容频繁变化、子树很小,或者缓存的维护成本超过收益。
`cache` 用于打开缓存,`nocache` 用于关闭缓存。两者都在元素创建时决定,`nocache` 优先级更高;不要把它当成运行时反复切换的开关,需要改变缓存策略时应当重新创建元素。
```tsx
// 静态复杂子树:内容不变、绘制成本高,开缓存
<container loc={[40, 40, 240, 160]} cache>
<g-rect loc={[0, 0, 240, 160]} fillStyle="#1b2433" />
<g-rect loc={[16, 16, 208, 40]} fillStyle="#2f6fed" />
<g-circle circle={[48, 96, 24]} fillStyle="#f2b84b" />
<text loc={[96, 84]} text="静态标题" fillStyle="#e8f0ff" />
</container>
// 频繁变化的子树:文字随时会被改写,不开缓存
<container loc={[40, 40, 240, 160]} nocache>
<text loc={[0, 0]} text={String(clock.value)} fillStyle="#e8f0ff" />
</container>
```
## composite
`composite` 默认 `source-over`。值取 `GlobalCompositeOperation`(见 [MDN 的 composite 文档](https://developer.mozilla.org/zh-CN/docs/Web/API/CanvasRenderingContext2D/globalCompositeOperation)),例如 `multiply`、`screen`、`overlay`、`lighter`。它影响当前绘制结果与已绘制内容的混合方式,不改变布局与命中区域。
```tsx
// composite 默认 source-over;这里用 multiply 让上层与已绘制内容混合
<g-rect loc={[40, 40, 120, 120]} fillStyle="#2f6fed" />
<g-rect loc={[100, 80, 120, 120]} fillStyle="#f2b84b" composite="multiply" />
```
下面三组是相同的重叠图形,分别使用 `source-over`、`multiply` 与 `screen`。
<ClientOnly>
<RenderDemo :loader="layerCompositeLoader" :width="480" :height="320" />
</ClientOnly>
## 性能:缓存的代价
缓存用离屏画布换绘制次数:每帧少画一遍子树,代价是多占一份画布内存,内容变化时还要重画整块缓存。嵌套缓存会叠加内存占用,只在绘制成本确实高的地方开。没有确认有性能问题之前,先不开缓存。
## 边界与注意
- `scale` 必须是 `[x, y]` 数组。写成数字不会生效,也不会报错。
- `rotate` 的单位是弧度。想转 30 度要写 `Math.PI / 6`,不是 `30`。
- 锚点是变换中心:缩放与旋转都绕锚点进行,改锚点会连同变换一起改变视觉位置。
- 父级变换会作用在整棵子树上;子元素不能用自己的 `scale` 抵消父级缩放,需要独立缩放时把内容移出该父级。
- `cache` / `nocache` 在元素创建时决定,`nocache` 优先级更高;不要把它当成运行时反复切换的开关。
- `composite` 影响绘制结果的混合方式,不改变布局与命中区域。
<script setup>
import RenderDemo from '../../.vitepress/components/renderDemo.vue';
const layerTransformLoader = () =>
import('../../.vitepress/components/demos/ui/layer-transform.tsx');
const layerTransformTreeLoader = () =>
import('../../.vitepress/components/demos/ui/layer-transform-tree.tsx');
const layerCompositeLoader = () =>
import('../../.vitepress/components/demos/ui/layer-composite.tsx');
</script>