Framebuffer编程How-to
http://xotianhu.bokee.com/2386074.html
7.1. framebuffer设备介绍
这是一个关于如何编程的文档，因此，请在你编译或执行例子之前，正确配置你的framebuffer设备。
用framebuffer设备，你可以把你的计算机屏幕当成一个真正的图形设备。你可以修改分辨率，刷新率，色彩深度等。最好的一点是，你可以把像素点绘在任何你想要的地方。framebuffer设备不是一个图形库，而更确切的是一个低级的通用设备。这样创造了巨大的灵活性，但同时也有它的缺点。想使用framebuffer设备，你应该做以下事情：
- 断定出你使用的设备
- 打开设备
- 取回或改变屏幕设置
- 映射（Map）屏幕内存
通常要打开的设备是/dev/fb0，但是如果用户有多个视频卡和监视器的话，设备也可能不同。大多数应用通过读取环境变量FRAMEBUFFER (用getenv();)
来决定该使用哪个设备。如果该环境变量不存在，那么就用/dev/fb0。
通过open()调用打开设备，读设备意味着读取屏幕内存（可称之为显存）。用$cat /dev/fb0 >screenshot将屏幕内存导入一个文件，恢复刚才的屏幕截图则可使用：$cat
screenshot >/dev/fb0。
7.2.?设备的基本用法
显然，用上述方法使用屏幕内存并不经济方便。在读或写之前持续的寻址（见man
lseek）将会导致很多的开销。这就是为什么你要映射你的屏幕内存。当你将屏幕内存映射到你的应用程序时，你将得到一个直接指向屏幕内存的指针。
在我们可以映射屏幕内存之前，我们需要知道我们能够映射多少，以及我们需要映射多少。第一件要做的事情就是从我们新得到的framebuffer设备取回信息。有两个结构包含着我们需要的信息，第一个包含固定的屏幕信息，这部分是由硬件和驱动的能力决定的；第二个包含着可变的屏幕信息，这部分是由硬件的当前状态决定的，可以由用户空间的程序调用ioctl()来改变。
struct fb_fix_screeninfo {
char id[16]; ??????????????????????? /*
identification string eg "TT Builtin" */
unsigned long smem_start; /*
Start of frame buffer mem */
/* (physical address) */
__u32 smem_len; /* Length of frame buffer mem */
__u32 type; /* see FB_TYPE_* */
__u32 type_aux; /* Interleave for interleaved Planes
*/
__u32 visual; /* see FB_VISUAL_* */
__u16 xpanstep; /* zero if no hardware panning?
*/
__u16 ypanstep; /* zero if no hardware panning?
*/
__u16 ywrapstep; /* zero if no hardware ywrap???
*/
__u32 line_length; /* length of a line in bytes???
*/
unsigned long mmio_start; /*
Start of Memory Mapped I/O?? */
/* (physical address) */
__u32 mmio_len; /* Length of Memory Mapped I/O?
*/
__u32 accel; /* Type of acceleration available */
__u16 reserved[3]; /* Reserved for future compatibility
*/
};
在这里非常重要的域是smem_len和line-length。smem-len告诉我们framebuffer设备的大小，第二个域告诉我们指针应该前进多少字节去得到下一行的数据。第二个结构则要有意思的多，它给了我们可以改变的信息。
/* more kernel header files copied shamelessly */
struct fb_bitfield {
__u32 offset; /* beginning of bitfield */
__u32 length; /* length of bitfield */
__u32 msb_right; /* != 0 : Most significant bit is */
/* right */
};
struct fb_var_screeninfo {
__u32 xres; /* visible resolution */
__u32 yres;
__u32 xres_virtual; /* virtual resolution */
__u32 yres_virtual;
__u32 xoffset; /* offset from virtual to visible */
__u32 yoffset; /* resolution */
__u32 bits_per_pixel; /* guess what */
__u32 grayscale; /* != 0 Graylevels instead of colors
*/
struct fb_bitfield red; /*
bitfield in fb mem if true color, */
struct fb_bitfield green; /*
else only length is significant */
struct fb_bitfield blue;
struct fb_bitfield transp; /*
transparency */
__u32 nonstd; /* != 0 Non standard pixel format */
__u32 activate; /* see FB_ACTIVATE_* */
__u32 height; /* height of picture in mm???
*/
__u32 width; /* width of picture in mm????
*/
__u32 accel_flags; /* acceleration flags (hints) */
/* Timing: All values in pixclocks, except pixclock (of
course) */
__u32 pixclock; /* pixel clock in ps (pico seconds) */
__u32 left_margin; /* time from sync to picture */
__u32 right_margin; /* time from picture to sync */
__u32 upper_margin; /* time from sync to picture */
__u32 lower_margin;
__u32 hsync_len; /* length of horizontal sync */
__u32 vsync_len; /* length of vertical sync */
__u32 sync; /* see FB_SYNC_* */
__u32 vmode; /* see FB_VMODE_* */
__u32 reserved[6]; /* Reserved for future compatibility
*/
};
前几个成员决定了分辨率。xres和yres是在屏幕上可见的实际分辨率，在通常的vga模式将为640和400（也许是480，byhighbar）。*res-virtual决定了构建屏幕时视频卡读取屏幕内存的方式。当实际的垂直分辨率为400，虚拟分辨率可以是800。这意味着800行的数据被保存在了屏幕内存区中。因为只有400行可以被显示，决定从那一行开始显示就是你的事了。这个可以通过设置*offset来实现。给yoffset赋0将显示前400行，赋35将显示第36行到第435行，如此重复。这个功能在许多情形下非常方便实用。它可以用来做双缓冲。双缓冲就是你的程序分配了可以填充两个屏幕的内存。将offset设为0，将显示前400行（假设是标准的vga），同时可以秘密的在400行到799行构建另一个屏幕，当构建结束时，将yoffset设为400，新的屏幕将立刻显示出来。现在将开始在第一块内存区中构建下一个屏幕的数据，如此继续。这在动画中十分有用。
另外一个应用就是用来平滑的滚动整个屏幕。就像在前面屏幕中一样，在内存分配800行的空间。每隔10毫秒设定一个定时器（timer，见man settimer和man
signal / man sigaction），将offset设为1或是比上次更多，瞧，你看到了一个平滑滚动的屏幕。确保你的信号（signal）不要因为最佳输出的原因被信号处理程序阻塞。
将
bits_per_pixel设为1，2，4，8，16，24或32来改变颜色深度（colordepth）。不是所有的视频卡和驱动都支持全部颜色深度。当颜色深度改变，驱动将自动改变fb-bitfields。这些指出，在一个特定的颜色基准上，多少和哪些比特被哪种颜色使用。如果bits-per-pixel小于8，则fb-bitfields将无定义而且颜色映射将启用。
在fb-var-screeninfo结构结尾的定时的设置是当你选择一个新的分辨率的时候用来设定视频定时的。（
EXAMINE AND EXPLAIN TIMINGS! ）
现在我们知道了结构的细节了，但还不清楚如何去获得或设置它们。这里有一些ioctl的命令可以参考。
- #include
- int main () {
- int framebuffer_handler;
- struct fb_fix_screeninfo fixed_info;
- struct fb_var_screeninfo variable_info;
- open ("/dev/fb0", O_RDWR); /*in real life, check every ioctl if it returns -1 */
- ioctl (framebuffer_handler,FBIOGET_VSCREENINFO, &variable_info); variable_info.bits_per_pixel = 32;
- ioctl(framebuffer_handler, FBIOPUT_VSCREENINFO, &variable_info);
- ioctl (framebuffer_handler,FBIOGET_FSCREENINFO, &fixed_info);
- variable_info.yoffset = 513;
- ioctl (framebuffer_handler,FBIOPAN_DISPLAY, &variable_info);
- }
这些 FBIOGET_*?的ioctl命令将请求的信息写入最后一个变量所指向的结构体中。FBIOPUT_VSCREENINFO将所有提供的信息复制回内核。如果内核不能激活新的设置，将返回-1。而
FBIOPAN_DISPLAY 也从用户复制信息，但并不重新初始化视频模式。最好在只有xoffset或yoffset改变时使用。
7.3. 显示内存管理
去访问内存本身，它可以被映射，然后直接访问。但这些需要一些步骤：
-
计算出需要映射多少
-
映射内存
-
决定如何构建屏幕
-
向屏幕中写入数据
这里有一个样例：
- #include
- #include
- #include
- #include
- #include
- #include
- #include
- int main() {
- int framebuffer_device;
- int line_size,buffer_size, *i;
- int *screen_memory;
- struct fb_var_screeninfo var_info;
- framebuffer_device = open ( "/dev/fb0" , O_RDWR);
- ioctl (framebuffer_device, FBIOGET_VSCREENINFO, &var_info);
- line_size = var_info.xres * var_info.bits_per_pixel / 8;
- buffer_size = line_size * var_info.yres;
- var_info.xoffset = 0;
- var_info.yoffset = 0;
- ioctl (framebuffer_device, FBIOPAN_DISPLAY,&var_info) == -1);
- screen_memory = (char *) mmap (513, buffer_size, PROT_READ | PROT_WRITE, MAP_SHARED, framebuffer_device, 0);
- for (i=0;i < buffer_size ; i++ )
- {
- *(screen_memory+i) = i%236;
- }
- sleep(2);
- return 0;
- }
你可以看到我们采用了从上一部分提到的信息取回，在这一部分新用到的是mmap函数。第一个变量在这种情形下可以忽略，第二个是映射的内存大小，第三个变量声明我们将共享内存进行读和写。第四个变量表示这段内存将和其他进程共享。在framebuffer上面建一个MAP_PRIVATE是不可能的。 通常这意味着你需要中断控制台的切换去备份和恢复屏幕内容，而且不在自己没有权利的时候向屏幕内存写东西。
关于mmap的更多信息请见man mmap.
highbar,2005-05-01,2:14