SurfaceControl（七）

题外话

"行百里者半九十"，是说步行一百里路，走过九十里，只能算是走了一半。因为步行越接近目的地，走起来越困难。借指凡事到了接近成功，往往是最吃力、最艰难的时段。劝人做事贵在坚持，有始容易，有终实难。

不多说了，希望自己能坚持写完这个系列 ......

1 前言

在前几篇文章中，你应该已经看到文中有冒出来比较多的陌生的类，比如 Surface/SurfaceControl/ANativeWindow/ANativeWindowBuffer，这些类有什么作用？它们之间有什么关系？以及它们和BufferQueue之间的关系是怎样的？我们带着这些问题，来开始这篇文章的讲解

♦ ANativeWindow

♦ Surface

♦ SurfaceControl

♦ ANativeWindowBuffer

2 几个常用类介绍

ANativeWindow

ANativeWindow 顾名思义，这个结构体是对一个本地窗口的抽象描述。老规矩先看代码：

其定义位于：/frameworks/native/libs/nativewindow/include/system/window.h

struct ANativeWindow
{
    // C++ 代码下会定义构造函数，并初始化common成员中的部分信息
#ifdef __cplusplus
    ANativeWindow()
        : flags(0), minSwapInterval(0), maxSwapInterval(0), xdpi(0), ydpi(0)
    {
        common.magic = ANDROID_NATIVE_WINDOW_MAGIC;
        common.version = sizeof(ANativeWindow);
        memset(common.reserved, 0, sizeof(common.reserved));
    }

    /* Implement the methods that sp<ANativeWindow> expects so that it
       can be used to automatically refcount ANativeWindow's. */
    void incStrong(const void* /*id*/) const {
        common.incRef(const_cast<android_native_base_t*>(&common));
    }
    void decStrong(const void* /*id*/) const {
        common.decRef(const_cast<android_native_base_t*>(&common));
    }
#endif
    // 结构体第一个成员，相当于继承自android_native_base_t，其主要用于引用计数，还有版本信息
    struct android_native_base_t common;

    /* flags describing some attributes of this surface or its updater */
    const uint32_t flags;

    /* min swap interval supported by this updated */
    const int   minSwapInterval;

    /* max swap interval supported by this updated */
    const int   maxSwapInterval;

    /* horizontal and vertical resolution in DPI */
    const float xdpi;
    const float ydpi;

    /* Some storage reserved for the OEM's driver. */
    intptr_t    oem[4];

    /* 设置swap间隔，跟踪源码可发现其最终调用了mGraphicBufferProducer->setAsyncMode,
       也就是设置Producer是同步or异步模式 */
    int     (*setSwapInterval)(struct ANativeWindow* window,
                int interval);

    /* 请求(出队列)一块buffer。执行后这块buffer就不是locked锁定状态，因此内容不能被修改。
       如果没有可用的buffer,这个方法会被阻塞。
       该方法已被弃用。*/
    int     (*dequeueBuffer_DEPRECATED)(struct ANativeWindow* window,
                struct ANativeWindowBuffer** buffer);

    /* 锁住buffer。在修改buffer中的内容前一定要先调用lock方法。
       这块buffer首先是dequeueBuffer请求到的。
       该方法已被弃用。*/
     */
    int     (*lockBuffer_DEPRECATED)(struct ANativeWindow* window,
                struct ANativeWindowBuffer* buffer);

    /* 当修改完buffer内容，调用这个方法，把buffer返回到队列中，用于后续显示输出。
       该方法已被弃用。*/
    int     (*queueBuffer_DEPRECATED)(struct ANativeWindow* window,
                struct ANativeWindowBuffer* buffer);

    /* 检索查询有关 native window 的信息 
       what指明要查询信息的类型，比如 NATIVE_WINDOW_WIDTH 、NATIVE_WINDOW_HEIGHT 查询宽高*/
    int     (*query)(const struct ANativeWindow* window,
                int what, int* value);

    /* 对surface执行各种操作，比如 NATIVE_WINDOW_SET_USAGE or NATIVE_WINDOW_CONNECT
       一般不会直接调用这个方法，而是使用辅助方法，比如 native_window_set_usage */
    int     (*perform)(struct ANativeWindow* window,
                int operation, ... );

    /* 取消已出队列的buffer。这个方法已被弃用 */
    int     (*cancelBuffer_DEPRECATED)(struct ANativeWindow* window,
                struct ANativeWindowBuffer* buffer);

    /* 请求(出队列)一块buffer。如果没有可用的buffer,这个方法会被阻塞。
       fenceFd是一个fence文件描述符，可以简单理解为一个资源同步锁
       当发出fence信号后才可以写buffer */
    int     (*dequeueBuffer)(struct ANativeWindow* window,
                struct ANativeWindowBuffer** buffer, int* fenceFd);

    /* 入队列一块buffer */
    int     (*queueBuffer)(struct ANativeWindow* window,
                struct ANativeWindowBuffer* buffer, int fenceFd);

    /* 取消一块已经dequeue的buffer */
    int     (*cancelBuffer)(struct ANativeWindow* window,
                struct ANativeWindowBuffer* buffer, int fenceFd);
};

在/frameworks/native/libs/nativewindow/include/system/window.h这个头文件中，还定义很多enum常量，这些常量的作用这源码中都有详细的英文注释，建议直接阅读理解。

用于query()函数检索信息的常量

/* attributes queriable with query() */
enum {
    NATIVE_WINDOW_WIDTH = 0,
    NATIVE_WINDOW_HEIGHT = 1,
    NATIVE_WINDOW_FORMAT = 2,
    NATIVE_WINDOW_MIN_UNDEQUEUED_BUFFERS = ANATIVEWINDOW_QUERY_MIN_UNDEQUEUED_BUFFERS,
    NATIVE_WINDOW_QUEUES_TO_WINDOW_COMPOSER = 4,
    NATIVE_WINDOW_CONCRETE_TYPE = 5,
    NATIVE_WINDOW_DEFAULT_WIDTH = ANATIVEWINDOW_QUERY_DEFAULT_WIDTH,
    NATIVE_WINDOW_DEFAULT_HEIGHT = ANATIVEWINDOW_QUERY_DEFAULT_HEIGHT,
    NATIVE_WINDOW_TRANSFORM_HINT = ANATIVEWINDOW_QUERY_TRANSFORM_HINT,
    NATIVE_WINDOW_CONSUMER_RUNNING_BEHIND = 9,
    NATIVE_WINDOW_CONSUMER_USAGE_BITS = 10, /* deprecated */
    NATIVE_WINDOW_STICKY_TRANSFORM = 11,
    NATIVE_WINDOW_DEFAULT_DATASPACE = 12,
    NATIVE_WINDOW_BUFFER_AGE = ANATIVEWINDOW_QUERY_BUFFER_AGE,
    NATIVE_WINDOW_LAST_DEQUEUE_DURATION = 14,
    NATIVE_WINDOW_LAST_QUEUE_DURATION = 15,
    NATIVE_WINDOW_LAYER_COUNT = 16,
    NATIVE_WINDOW_IS_VALID = 17,
    NATIVE_WINDOW_FRAME_TIMESTAMPS_SUPPORTS_PRESENT = 18,
    NATIVE_WINDOW_CONSUMER_IS_PROTECTED = 19,
    NATIVE_WINDOW_DATASPACE = 20,
    NATIVE_WINDOW_MAX_BUFFER_COUNT = 21,
};

用于(*perform)()的标识各种操作的常量

deprecated标记的可能已被弃用或被其他功能函数取代

标记为“私有”的值应被视为框架私有。可以访问ANativeWindow的HAL实现代码不应该使用这些，因为它可能无法与框架对ANativeWindow的使用进行正确的交互。

/* Valid operations for the (*perform)() hook. */
enum {
    // clang-format off
    NATIVE_WINDOW_SET_USAGE                       =  ANATIVEWINDOW_PERFORM_SET_USAGE,   /* deprecated */
    NATIVE_WINDOW_CONNECT                         =  1,   /* deprecated */
    NATIVE_WINDOW_DISCONNECT                      =  2,   /* deprecated */
    NATIVE_WINDOW_SET_CROP                        =  3,   /* private */

    // 完整内容，请参考源码    
}

用于NATIVE_WINDOW_[API_][DIS]CONNECT的参数

关注公众号 Android元宇宙继续阅读相关文章！

posted on 2022-03-17 11:43 二的次方阅读(8230) 评论(3) 编辑收藏举报

Android 12(S) 图像显示系统 - 初识ANativeWindow/Surface/SurfaceControl（七）

1 前言

2 几个常用类介绍

ANativeWindow

关注公众号 Android元宇宙 继续阅读相关文章！

关注公众号 Android元宇宙继续阅读相关文章！