DirectFB学习笔记一

本文记录directfb程序的基本操作流程。

1、首先创建一个directfb对象：DirectFBInit（&argc，&argv）初始化然后创建DirectFBCreate(&dfb)。

2、由directfb对象创建界面surface：dfb->CreateSurface(dfb,&dsc,&primary),primary就是我们的绘图面。

3、绘图：首先要画一个背景，一般是primary->FillRectangle然后在背景上画图。每次画图前最好都要setcolor一下，改变画笔的颜色。

4、将图画展现出来：flip函数将画面显示到界面上。

参考示例：画一条直线

转至http://blog.csdn.net/wangjijian/article/details/6150808

Simple fullscreen application that draws a horizontal line.

代码如下：

#include <stdio.h>

#include <unistd.h>

#include <directfb.h>

static IDirectFB *dfb = NULL;

static IDirectFBSurface *primary = NULL;

static int screen_width = 0;

static int screen_height = 0;

#define DFBCHECK(x...)                                                  /

{                                                                       /

DFBResult err = x;                                              /

/

if (err != DFB_OK)                                              /

{                                                               /

fprintf( stderr, "%s <%d>:/n/t", __FILE__, __LINE__ );  /

DirectFBErrorFatal( #x, err );                          /

}                                                               /

}

int main(int argc, char **argv)

{

DFBSurfaceDescription dsc;

DFBCHECK (DirectFBInit (&argc, &argv));

DFBCHECK (DirectFBCreate (&dfb));

DFBCHECK (dfb->SetCooperativeLevel (dfb, DFSCL_FULLSCREEN));

dsc.flags = DSDESC_CAPS;

dsc.caps = DSCAPS_PRIMARY | DSCAPS_FLIPPING;

DFBCHECK (dfb->CreateSurface( dfb, &dsc, &primary ));

DFBCHECK (primary->GetSize (primary, &screen_width, &screen_height));

DFBCHECK (primary->FillRectangle (primary, 0, 0, screen_width, screen_height));

DFBCHECK (primary->SetColor (primary, 0x80, 0x80, 0xff, 0xff));

DFBCHECK (primary->DrawLine (primary,

0, screen_height / 2,

screen_width - 1, screen_height / 2));

DFBCHECK (primary->Flip (primary, NULL, 0));

sleep(5);

primary->Release(primary);

dfb->Release(dfb);

return 23;

}

下面我们来看这个程序，前三行：

#include <stdio.h>

#include <unistd.h>

#include <directfb.h>

为头文件包含。第5到第8行：

static IDirectFB *dfb = NULL;

static IDirectFBSurface *primary = NULL;

static int screen_width = 0;

static int screen_height = 0;

为全局变量定义。第10到第19行为出错处理宏：

#define DFBCHECK(x...)                                                  /

{                                                                       /

DFBResult err = x;                                              /

/

if (err != DFB_OK)                                              /

{                                                               /

fprintf( stderr, "%s <%d>:/n/t", __FILE__, __LINE__ );  /

DirectFBErrorFatal( #x, err );                          /

}                                                               /

}

此宏定义在官方给的程序中很常见，确实也挺好用。第21到46行为主程序代码段。

其中，第23行：

DFBSurfaceDescription dsc;

为局部变量定义，dsc为平面属性描述变量，用以创建与其相匹配的平面。

第25到26行：

DFBCHECK (DirectFBInit (&argc, &argv));

DFBCHECK (DirectFBCreate (&dfb));

为DirectFB初始化函数，第25行用以初始化命令行参数，而第26行用以创建DirectFB的主接口。

第28到30行对平面属性进行了初始化，其中第28行：

DFBCHECK (dfb->SetCooperativeLevel (dfb, DFSCL_FULLSCREEN));

设置了DirectFB的主接口的同步等级，DFSCL_FULLSCREEN与DFSCL_EXCLUSIVE相同，均为非共享的同步等级，在总接口使用CreateSurface方法创建平面时，将创建全屏平面。

第29到30行：

dsc.flags = DSDESC_CAPS;

dsc.caps = DSCAPS_PRIMARY | DSCAPS_FLIPPING;

说明了即将创建的平面的属性，在本例中，我们要创建一个可flip的主平面。

第32到34行：

DFBCHECK (dfb->CreateSurface( dfb, &dsc, &primary ));

DFBCHECK (primary->GetSize (primary, &screen_width, &screen_height));

DFBCHECK (primary->FillRectangle (primary, 0, 0, screen_width, screen_height));

创建了一个平面，并对此平面作了相应的初始化操作。第33行获取了此平面（全屏主平面）的宽高值，第34行在平面上画了一个黑色（DirectFB系统默认颜色）的屏幕大小矩形，此函数是受stb225平台硬件加速支持的。

第36到41行：

DFBCHECK (primary->SetColor (primary, 0x80, 0x80, 0xff, 0xff));

DFBCHECK (primary->DrawLine (primary,

0, screen_height / 2,

screen_width - 1, screen_height / 2));

DFBCHECK (primary->Flip (primary, NULL, 0));

sleep(5);

的功能为在屏幕正中心画一条横线，并显示5秒钟。第36行设置了线的颜色，第37到39行进行画线操作，将36行所设置颜色的线画到primary平面上，第40行将画有横线的平面显示出来，第41行，程序休眼5秒，即此线在屏幕上显示5秒。

第43到45行：

primary->Release(primary);

dfb->Release(dfb);

return 23;

程序作了相应的清理操作，而后退出。

DirectFB程序中，如果定义了接口，则一定需要使用相应的Release方法将此接口进行释放，否则可能引起内存泄漏问题，甚至可能破坏程序的稳定性。