minigui 3.2.0:直接访问framebuffer的方法及示例

在做嵌入式应用程序开发时，有的场景下因为要追求图像显示效率，需要直接访问Frame Buffer,比如更流畅的视频显示。基于minigui框架的应用程序该如何访问Frame Buffer呢?
最近就在为这个事儿头疼， 之前在设计时，视频输出是将一帧图像解码为BITMAP后作为窗口的背景画到屏幕上，这在PC模拟器上跑没啥问题，等到直接上开发板跑的时候，问题就来了----太慢。毕竟通过minigui这个框架要把一个BITMAP刷到屏幕上要经过好多个环节。所以肯定不如直接写Frame Buffer来得快呀。

于是就在想如何在MiniGUI的框架下直接读写Frame Buffer呢，翻遍了minigui公开的接口函数，没有提供这种直接读写Frame Buffer的方法。
不死心，在minigui源码中从BitBlt函数的实现代码开始一层层往下查。又倒过来从fbcon图形引擎的实现代码向上查。最终找到了GAL_Surface这个结构，这是NEWGAL的一个数据结构，定义在libminigui-3.2.0/src/include/newgal.h,如下（请关注本文作者添加了中文注释的字段）

/* This structure should be treated as read-only, except for 'pixels',
   which, if not NULL, contains the raw pixel data for the surface.
*/
typedef struct GAL_Surface {
    Uint32 flags;                       /* Read-only */
    GAL_PixelFormat *format;            /* 描述FrameBuffer的像素格式(RGB24,RGB565)的数据结构 */
    void *video;                        /* Read-only */
    int w, h;                           /* FrameBuffer宽高(像素) */
    /* VW[2018-01-18]: For 64b, use signed int instead of Uint32 for pitch. */
    int pitch;                          /* 每行像素的长度(字节) */
    void *pixels;                       /* FrameBuffer的起始地址 */
    int offset;                         /* Private */

    /* Hardware-specific surface info */
    struct private_hwdata *hwdata;

    /* clipping information */
    GAL_Rect clip_rect;                 /* Read-only */

    /* info for fast blit mapping to other surfaces */
    struct GAL_BlitMap *map;             /* Private */

    /* format version, bumped at every change to invalidate blit maps */
    unsigned int format_version;        /* Private */

    /* Reference count -- used when freeing surface */
    int refcount;                       /* Read-mostly */
} GAL_Surface;

不管结构中的其他字段，有了上面这个对象所提供的Frame Buffer的宽高(w,h),起始地址(pixels),行步长(pitch)信息,像素格式(GAL_PixelFormat 结构中的BitsPerPixel,BytesPerPixel字段)，已经可以直接操作Frame Buffer了.

那么如何获取当前图形引擎的GAL_Surface 对象呢？还是要看libminigui-3.2.0/src/include/newgal.h这个头文件,如下：

/*
 * This function returns a pointer to the current display surface.
 * If GAL is doing format conversion on the display surface, this
 * function returns the publicly visible surface, not the real video
 * surface.
 */
extern GAL_Surface * GAL_GetVideoSurface (void);

好了，有了GAL_GetVideoSurface函数可以得到GAL_Surface, 但你会发现 libminigui-3.2.0/src/include/newgal.h这个头文件并没有出现在MiniGUI的release清单中，是未公开的。所以要把这个头文件复制到自己的项目中才能引用其中的函数。(记得要把newgal.h中的#include "gdi.h"改为#include <minigui/gdi.h>,否则编译通不过)
下面是关于从GAL_Surface直接访问Frame Buffer的简单示例

#include <string.h>
#include "newgal.h"
/**
 * 图像顺时针旋转90度并缩放到目标BITMAP的尺寸
 * @param src 原图像
 * @param [out] dst　缩放旋转后的图像
 */
static void scaledBitmap_Rotate90 (const PBITMAP src,PBITMAP dst)
{
	uint8_t* dst_line=  dst->bmBits;
	uint32_t sx,sy,st;
	uint8_t* spixel;
	// x,y缩放比例
	float ratex = (float)src->bmHeight/dst->bmWidth,ratey = (float)src->bmWidth/dst->bmHeight;
	for(int dy=0; dy < dst->bmHeight; ++dy)
	{
		for(int dx=0; dx < dst->bmWidth; ++dx)
		{
			// 坐标缩放
			sx = (uint32_t)(int)(dx * ratex),sy = (uint32_t)(int)(dy * ratey);
			// 坐标旋转
			st = sx,sx = sy,sy= src->bmHeight - st;
			// 目标像素的原始图像中的位置
			spixel = src->bmBits + sy*src->bmPitch + sx*src->bmBytesPerPixel;
			switch(dst->bmBytesPerPixel)
			{
			case 1:
				*(dst_line +dx) = *spixel;
				break;
			case 2:
				*((uint16_t*)(dst_line + dx*dst->bmBytesPerPixel)) = *((uint16_t*)spixel);
				break;
			case 4:
				*((uint32_t*)(dst_line + dx*dst->bmBytesPerPixel)) = *((uint32_t*)spixel);
				break;
			case 3:
			default:
				memcpy(dst_line+dx*dst->bmBytesPerPixel,spixel,dst->bmBytesPerPixel);
				break;
			}

		}
		dst_line += dst->bmPitch;
	}
}
void test()
{
	//　指向 frame buffer的 BITMAP
	BITMAP fb_bmp;
	// 获取当前图像引擎的GAL_Surface对象
	GAL_Surface* sf = GAL_GetVideoSurface();
	printf("GAL_Surface:%d x %d,BitsPerPixel %d,pitch %d",
			sf->w,sf->h,sf->format->BitsPerPixel,sf->pitch);
	// 根据GAL_Surface的参数将fb_bmp初始化为一个映射到FrameBuffer的BITMAP.
	if(!InitBitmap(HDC_SCREEN,sf->w,sf->h,sf->pitch,(BYTE*)sf->pixels,&fb_bmp))
	{
		printf("InitBitmap fail :%dx%d",sf->w,sf->h);
		return ;
	}
	// 将要显示的图像pbmp直接输出到frame buffer
	// 这个只是示例，你可以向代表frame buffer的fb_bmp写入任何数据，都会直接在屏幕显示
	scaledBitmap_Rotate90 (pbmp,&fb_bmp);
}