graphic_standard

• 简介
• 目录
• 约束
• 编译构建
• 接口说明
• 使用说明
• 相关仓

简介

Graphic子系统 提供了图形接口能力和窗口管理接口能力，

其主要的结构如下图所示：

• Surface

  图形缓冲区管理接口，负责管理图形缓冲区和高效便捷的轮转缓冲区。

• Vsync

  垂直同步信号管理接口，负责管理所有垂直同步信号注册和响应。

• WindowManager

  窗口管理器接口，负责创建和管理窗口。

• WaylandProtocols

  窗口管理器和合成器的通信协议。

• Compositor

  合成器，负责合成各个图层。

• Renderer

  合成器的后端渲染模块。

• Wayland protocols

  Wayland 进程间通信协议

• Shell

  提供多窗口能力

• Input Manger

  多模输入模块，负责接收事件输入

目录

foundation/graphic/standard/
├── frameworks              # 框架代码目录
│   ├── bootanimation       # 开机动画目录
│   ├── surface             # Surface代码
│   ├── vsync               # Vsync代码
│   └── wm                  # WindowManager代码
├── interfaces              # 对外接口存放目录
│   ├── innerkits           # native接口存放目录
│   └── kits                # js/napi接口存放目录
└── utils                   # 小部件存放目录

约束

• 语言版本
  • C++11或以上

编译构建

可以依赖的接口有:

• graphic_standard:libwms_client
• graphic_standard:libsurface
• graphic_standard:libvsync_client

接口说明

WindowManager

Window

SubWindow

Surface

SurfaceBuffer

VsyncHelper

使用说明

具名服务-传递一个生产型Surface

注册

// 拿到一个消费型Surface
sptr<Surface> surface = Surface::CreateSurfaceAsConsumer();

// 拿出里面的生产者对象
sptr<IBufferProducer> producer = surface->GetProducer();

// 注册服务
auto sm = SystemAbilityManagerClient::GetInstance().GetSystemAbilityManager();
sm->AddSystemAbility(IPC_SA_ID, producer->AsObject());

客户端获得生产型Surface

// 获得远程对象
auto sm = SystemAbilityManagerClient::GetInstance().GetSystemAbilityManager();
sptr<IRemoteObject> robj = sm->GetSystemAbility(IPC_SA_ID);

// 构造Surface
sptr<IBufferProducer> bp = iface_cast<IBufferProducer>(robj);
sptr<Surface> surface = Surface::CreateSurfaceAsProducer(bp);

匿名服务-传递一个生产型Surface

场景: 在一次IPC过程中

发送

// 拿到一个消费型Surface
sptr<Surface> surface = CreateSurfaceAsConsumer();

// 拿出里面的生产者对象
sptr<IRemoteObject> producer = surface->GetProducer();

// 返回给客户端
parcel.WriteRemoteObject(producer);

接受并获得生产型Surface

// 获得远程对象
sptr<IRemoteObject> remoteObject = parcel.ReadRemoteObject();

// 构造Surface
sptr<IBufferProducer> bp = iface_cast<IBufferProducer>(robj);
sptr<Surface> surface = Surface::CreateSurfaceAsProducer(bp);

生产一个SurfaceBuffer

条件： 一个生产型Surface

BufferRequestConfig requestConfig = {
    .width = 1920, // 屏幕宽度
    .height = 1080, // 屏幕高度
    .strideAlignment = 8, // stride对齐字节
    .format = PIXEL_FMT_RGBA_8888, // 颜色格式
    .usage = HBM_USE_CPU_READ | HBM_USE_CPU_WRITE | HBM_USE_MEM_DMA, // 用法
    .timeout = 0, // 时延
};

sptr<SurfaceBuffer> buffer;
int32_t releaseFence;

SurfaceError ret = surface->RequestBuffer(buffer, releaseFence, requestConfig);
if (ret != SURFACE_ERROR_OK) {
    // failed
}

BufferFlushConfig flushConfig = {
    .damage = {                   // 重绘区域
        .x = 0,                   // 起点横坐标
        .y = 0,                   // 起点纵坐标
        .w = buffer->GetWidth(),  // 区域宽度
        .h = buffer->GetHeight(), // 区域高度
    },
    .timestamp = 0 // 给消费者看的时间，0为使用当前时间
};

ret = surface->FlushBuffer(buffer, -1, flushConfig);
if (ret != SURFACE_ERROR_OK) {
    // failed
}

消费一个SurfaceBuffer

条件： 一个消费型Surface

class TestConsumerListener : public IBufferConsumerListener {
public:
    void OnBufferAvailable() override {
        sptr<SurfaceBuffer> buffer;
        int32_t flushFence;

        SurfaceError ret = surface->AcquireBuffer(buffer, flushFence, timestamp, damage);
        if (ret != SURFACE_ERROR_OK) {
            // failed
        }

        // ...

        ret = surface->ReleaseBuffer(buffer, -1);
        if (ret != SURFACE_ERROR_OK) {
            // failed
        }
    }
};

sptr<IBufferConsumerListener> listener = new TestConsumerListener();
SurfaceError ret = surface->RegisterConsumerListener(listener);
if (ret != SURFACE_ERROR_OK) {
    // failed
}

给SurfaceBuffer带上自定义数据

sptr<SurfaceBuffer> buffer;
SurfaceError ret = buffer->SetInt32(1, 3);
if (ret != SURFACE_ERROR_OK) {
    // failed
}

int32_t val;
ret = buffer->GetInt32(1, val);
if (ret != SURFACE_ERROR_OK) {
    // failed
}

注册一个Vsync回调事件

用handler构造VsyncHelper

auto runner = AppExecFwk::EventRunner::Create(true);
auto handler = std::make_shared<AppExecFwk::EventHandler>(runner);
auto helper = new VsyncHelper(handler);
runner->Run();

struct FrameCallback cb = {
    .timestamp_ = 0,
    .userdata_ = nullptr,
    .callback_ = [](int64_t timestamp, void* userdata) {
    },
};

VsyncError ret = helper->RequestFrameCallback(cb);
if (ret != VSYNC_ERROR_OK) {
    // failed
}

在handler里用Current

auto runner = AppExecFwk::EventRunner::Create(true);
auto handler = std::make_shared<AppExecFwk::EventHandler>(runner);
handler->PostTask([]() {
    auto helper = VsyncHelper::Current();
    struct FrameCallback cb = {
        .timestamp_ = 0,
        .userdata_ = nullptr,
        .callback_ = [](int64_t timestamp, void* userdata) {
        },
    };

    VsyncError ret = helper->RequestFrameCallback(cb);
    if (ret != VSYNC_ERROR_OK) {
        // failed
    }
});

runner->Run();

相关仓

• graphic_standard
• ace_ace_engine
• aafwk_standard
• multimedia_media_standard
• multimedia_camera_standard