gralloc的layer count字段

原创于 2025-04-29 11:27:58 发布 · 830 阅读

10 ·

CC 4.0 BY-SA版权

文章标签：

#display

简单来说，layer count 是描述一个 buffer 里面有多少层图像**的概念。
它最常见的用途是 3D图像、立体显示，或者 多平面图像（multi-plane image） 的场景。

详细解释一下：

平时我们用的普通 2D 图片、视频帧，都是单层（Layer Count = 1）。
但有些场景下，一个 buffer 可以代表多个图像层，比如：
- VR/AR中的双目立体图像（左眼 + 右眼），一个 buffer 装两张图。
- 高级拍照或者多帧融合（ZSL，Zero Shutter Lag）里，一块内存同时存储多帧快照。
- 特定场景下的 GPU 渲染 buffer，比如 multi-layer composition。
- 特别是高通，某些 Display HAL / Camera HAL 会用 Layer Count > 1 来做性能优化（比如减少 buffer copy）。

举个例子：

Layer Count	代表含义
1	正常单层图像，比如普通 app 界面，普通照片
2	可能是左眼图+右眼图（VR）、或者 ZSL 两帧图
3+	复杂合成，比如 HDR 合成、AR场景，或者自定义算法处理

在实际代码里的体现（比如高通 gralloc HAL）：

layer_count 这个字段通常是在 buffer 分配（比如 gralloc_alloc）时传进去的。
它被记录在 buffer metadata 中，供 GPU/Display/Camera 等下游模块识别和使用。
有些硬件（比如高通的 GPU、Display Controller）直接支持读取多 layer 的 buffer，能省一次拷贝，性能更好。

为什么之前没怎么见到？

因为：

绝大多数 Android 应用用的是 Layer Count = 1。
只有在 VR、Camera 多帧处理、高端 Display 合成这些偏底层/高端场景，才会看到 Layer Count > 1。
所以这其实是给底层优化或者未来应用场景预留的机制。

小结一句：

gralloc buffer 的 layer count 表示这块内存里有多少“逻辑图像层”。常规是1层，高端场景（VR/AR/ZSL/Display合成）可以有多层。

如果 layer count > 1，GPU/Display HAL 是怎么用它的？

我给你分成两块来说：
➊ gralloc buffer 分配时怎么设置 layer count，
➋ GPU/Display/Camera HAL 碰到 layer count >1 时会怎么处理。

➊ 【gralloc 分配时设置 layer count】

在 Qualcomm 或 AOSP 通用 gralloc 代码里，分配 buffer 的时候一般会用一个结构体（比如 buffer_descriptor_t）来描述要分配的 buffer，各种属性比如宽高、format、usage、layer_count 都可以设置。

通常像这样（伪代码）：

buffer_descriptor_t desc = {};
desc.width = 1920;
desc.height = 1080;
desc.format = HAL_PIXEL_FORMAT_RGBA_8888;
desc.layer_count = 2;  // 注意这里设置了2层
desc.usage = GRALLOC_USAGE_HW_COMPOSER | GRALLOC_USAGE_GPU_RENDER_TARGET;

gralloc_module->allocate(descriptor, &out_handle);

也就是说，分配内存的时候就告诉 gralloc：

我要一块 buffer，
里面有两层图像，
每层是 1920x1080，RGBA8888 格式。

gralloc 会在内部记录 layer_count，并在 buffer handle 里打好标记，方便后续模块识别。

➋ 【GPU / Display HAL 碰到 layer count > 1 时怎么用】

当 GPU、Display、或者 Camera 处理这些 buffer 时，一般会这样分情况：

情况1：按 layer 直接寻址

有些硬件（比如高通的一些 GPU、Display Controller）支持 multi-layer buffer。
比如，它知道：
- 每一层的起始地址是 base_addr + layer_size * layer_index。
- 所以可以直接取第0层、第1层分别去做渲染或显示。

比如在 Qualcomm Display HAL（像 hwc_display.cpp、qdutils.cpp）里，会看到类似这样的操作：

void* layer0 = buffer_base;
void* layer1 = buffer_base + layer_stride * layer_height;

（简化了，实际可能还有格式对齐等处理）

情况2：一层一层提交到 Display Pipeline

Display Controller（比如 MDP、DPU）是支持多图层混合的。
它可以把一个 buffer 的不同 layer，当作多个独立的 layer 提交给硬件合成。

比如在 Qualcomm HAL，可能这样处理：

for (int i = 0; i < layer_count; ++i) {
    Layer layer;
    layer.src_buffer = buffer_handle;
    layer.src_offset = i * per_layer_size;
    hwc_layers.push_back(layer);
}

每一层生成一个 Layer，
设置不同的 offset / stride，
最后交给硬件合成（Overlay engine）。

情况3：Camera HAL / Video HAL特殊处理

在 Camera 多帧捕捉（比如 ZSL Fusion）场景里：

一块 buffer 装多帧数据，
Camera HAL 拿到以后按 layer 拆开处理，
后续送给图像算法处理，比如曝光融合、降噪等等。

总结一句：

项目	行为
gralloc 分配时	设置 `layer_count > 1`
GPU/Display HAL 处理	按层访问内存、分别渲染、或者合成
Camera HAL 处理	多帧捕捉，按 layer 拆开处理

本质：layer count > 1 只是一种优化手段，让一次分配的内存能承载更多数据，减少多次分配和管理的开销。

补充点小细节（更高级的东西）

有的硬件支持 plane compression，比如 AFBC（ARM Frame Buffer Compression），Layer Count 和 Plane Count 不完全等价，但相关。
高通 display stack (mdss/mdp/dpu) 里，layer count 大了还要注意 format，比如 RGBA8888 和 YUV 格式的处理方式不一样。

layer count > 1 并不是高通专门定制的属性，而是 Android 原生 gralloc 和图形系统中就支持的一种机制，它是为了支持某些特定的图像使用场景而设计的。

一、`layer count` 是什么？

在 AHardwareBuffer 或 gralloc 的描述结构体中，会有一个字段叫 layerCount，它的作用是：

表示这个 buffer 中有几层图像数据（layers），不是多张帧，而是 一个 buffer 内的多个图层（slices）。

二、哪些场景会用到 layerCount > 1？

1. 3D Textures / Texture Arrays

OpenGL / Vulkan 里常见，比如一个纹理数组。
一般用于多层贴图、光照数据等。

2. Multi-plane Video Frame（YUV）

比如使用 AHardwareBuffer + Vulkan，有时为了性能或者格式支持，会把 Y、U、V 平面“打包”成多层存储。

3. Camera 相关 buffer（例如 ZSL fusion）

某些 HDR 或多帧融合场景下，会在一个 buffer 中装入多个 layer，每层是一帧。

4. XR（AR/VR）多视图渲染

像双目 VR，或者 3D display，可能一个 buffer 中就存了左眼、右眼两个图层。

三、那高通 HAL 里使用 `layerCount` 是为什么？

如果你看到高通 HAL 代码在处理 layerCount > 1 的 buffer，通常是为了做兼容或者特殊处理，例如：

在分配或导出 buffer 的时候加上特定的 ION_HEAP 标志。
某些模块（比如 DSP 或 GPU）能直接读取多个图层。
处理多个相机帧时，压缩成一个 buffer 传输。

他们可能会结合 layerCount 和 usage 字段做特殊分支处理，但这个字段本身是 AOSP 支持的，不是他们私有的。

举个例子

AHardwareBuffer_Desc desc = {};
desc.width = 1920;
desc.height = 1080;
desc.layers = 2;  // <-- 两个图层
desc.format = AHARDWAREBUFFER_FORMAT_R8G8B8A8_UNORM;
desc.usage = AHARDWAREBUFFER_USAGE_GPU_SAMPLED_IMAGE;

你可以通过 Vulkan 将这两个 layer 作为 texture array 的两个 slice 使用。

总结一下

属性	来源	说明
`layerCount`	AOSP 原生	表示一个 buffer 包含几个图层（非帧数）
高通是否定制	否（字段原生支持），但可能有定制用法	会结合使用场景（如 Camera、VR）做一些定制处理
常见用途	多视图、Texture Array、ZSL、多平面图像等