RenderNode 类

定义

[Android.Runtime.Register("android/graphics/RenderNode", ApiSince=29, DoNotGenerateAcw=true)]
public sealed class RenderNode : Java.Lang.Object

[<Android.Runtime.Register("android/graphics/RenderNode", ApiSince=29, DoNotGenerateAcw=true)>]
type RenderNode = class
    inherit Object

继承

Object

Object

RenderNode

属性

RegisterAttribute

注解

RenderNode 用于生成硬件加速呈现层次结构。 每个 RenderNode 都包含一个显示列表以及一组影响显示列表呈现的属性。 默认情况下，RenderNode 在内部用于所有视图，通常不直接使用。

RenderNodes 用于将复杂场景的呈现内容划分为较小的片段，然后可以单独更新更便宜。 更新场景的一部分只需更新少量 RenderNode 的显示列表或属性，而不是从头开始重新绘制所有内容。 RenderNode 只需在仅更改其内容时重新录制其显示列表。 RenderNodes 也可以转换，而无需通过转换属性重新录制显示列表。

文本编辑器可能用于实例将每个段落存储到其自己的 RenderNode 中。 因此，当用户插入或删除字符时，只需再次记录受影响的段落的显示列表。

<h3>硬件加速</h3>

可以使用 /&a0> 绘制 RenderNodes。 软件不支持它们。 始终确保 android.graphics.Canvas 你用于呈现显示列表的硬件加速使用 android.graphics.Canvas#isHardwareAccelerated()。

<h3>创建 RenderNode</h3>

RenderNode renderNode = new RenderNode("myRenderNode");
                renderNode.setPosition(0, 0, 50, 50); // Set the size to 50x50
                RecordingCanvas canvas = renderNode.beginRecording();
                try {
                    // Draw with the canvas
                    canvas.drawRect(...);
                } finally {
                    renderNode.endRecording();
                }

<h3>在 View</h3 中绘制 RenderNode>

protected void onDraw(Canvas canvas) {
                    if (canvas.isHardwareAccelerated()) {
                        // Check that the RenderNode has a display list, re-recording it if it does not.
                        if (!myRenderNode.hasDisplayList()) {
                            updateDisplayList(myRenderNode);
                        }
                        // Draw the RenderNode into this canvas.
                        canvas.drawRenderNode(myRenderNode);
                    }
                }

<h3>释放资源</h3>

如果想要尽快释放显示列表持有的资源，则此步骤不是强制性的，但建议这样做。 最重要的是，它可能包含的任何位图。

// Discards the display list content allowing for any held resources to be released.
                // After calling this
                renderNode.discardDisplayList();

<h3>属性</h3>

此外，RenderNode 还提供多个属性，例如 #setScaleX(float) ， #setTranslationX(float)或者，可用于影响记录的所有绘图命令。 例如，这些属性可用于在大量图像周围移动，而无需重新发出所有单个 canvas.drawBitmap() 调用。

private void createDisplayList() {
                    mRenderNode = new RenderNode("MyRenderNode");
                    mRenderNode.setPosition(0, 0, width, height);
                    RecordingCanvas canvas = mRenderNode.beginRecording();
                    try {
                        for (Bitmap b : mBitmaps) {
                            canvas.drawBitmap(b, 0.0f, 0.0f, null);
                            canvas.translate(0.0f, b.getHeight());
                        }
                    } finally {
                        mRenderNode.endRecording();
                    }
                }

                protected void onDraw(Canvas canvas) {
                    if (canvas.isHardwareAccelerated())
                        canvas.drawRenderNode(mRenderNode);
                    }
                }

                private void moveContentBy(int x) {
                     // This will move all the bitmaps recorded inside the display list
                     // by x pixels to the right and redraw this view. All the commands
                     // recorded in createDisplayList() won't be re-issued, only onDraw()
                     // will be invoked and will execute very quickly
                     mRenderNode.offsetLeftAndRight(x);
                     invalidate();
                }

某些属性最初可能看起来是冗余的，例如 #setElevation(float) 和 #setTranslationZ(float)。 这些重复项的原因是允许在静态和暂时性用法之间分离。 例如，假设按下时将引发 2dp 到 8dp 的按钮。 要实现此目的，应用程序可能决定 setElevation（2dip），然后按将 setTranslationZ 设置为 6dip。 结合这可实现最终所需的 8dip 值，但动画只需要关注从按下提升的动画，而无需知道初始起始值。 #setTranslationX(float) 并且 #setTranslationY(float) 同样为动画使用提供，尽管功能重叠 #setPosition(Rect)。

RenderNode 的转换矩阵在呈现时计算，如下所示：

Matrix transform = new Matrix();
                transform.setTranslate(renderNode.getTranslationX(), renderNode.getTranslationY());
                transform.preRotate(renderNode.getRotationZ(),
                        renderNode.getPivotX(), renderNode.getPivotY());
                transform.preScale(renderNode.getScaleX(), renderNode.getScaleY(),
                        renderNode.getPivotX(), renderNode.getPivotY());

然后，将转换为 RenderNode 位置的当前画布转换矩阵乘以 RenderNode 的转换矩阵。 因此，调用属性 setter 的顺序不会影响结果。 也就是说：

renderNode.setTranslationX(100);
                renderNode.setScaleX(100);

等效于：

renderNode.setScaleX(100);
                renderNode.setTranslationX(100);

<h3>线程</h3>

RenderNode 可以在任何线程上创建和使用，但它们不是线程安全的。 在任何给定时间，只有一个线程可以与 RenderNode 交互。 呈现节点仅在绘制它的同一线程上使用至关重要。 例如，将 RenderNode 与自定义视图配合使用时，必须仅从 UI 线程使用 RenderNode。

<h3>何时重新呈现</h3>

许多 RenderNode 突变方法（例如 #setTranslationX(float)）返回一个布尔值，该值是否实际更改。 这对于检测是否应呈现新帧非常有用。 典型的用法如下所示：

public void translateTo(int x, int y) {
                    boolean needsUpdate = myRenderNode.setTranslationX(x);
                    needsUpdate |= myRenderNode.setTranslationY(y);
                    if (needsUpdate) {
                        myOwningView.invalidate();
                    }
                }

这比执行更明确的前期检查快得多，因为通过将所需值与 #getTranslationX() 最小化 JNI 转换进行比较来更改该值。 请求呈现的新帧的实际机制取决于绘制此 RenderNode 的方式。 如果它被绘制到包含的视图（如上面的代码片段中所示），则只需使该视图失效即可。 相反，如果 RenderNode 直接绘制到画布，例如 Surface#lockHardwareCanvas() ，需要通过调用 Surface#lockHardwareCanvas()来绘制新框架，重新绘制根 RenderNode 或任何顶级内容，最后调用 Surface#unlockCanvasAndPost(Canvas)。 </p>

Java文档android.graphics.RenderNode。

本页的某些部分是根据 创建和共享的工作进行的修改，并根据 许可证中所述的条款使用。