directfbrc是DirectFB的配置文件。它被所有的DirectFB应用程序在启动时读取，有两个这样的文件，一个是存放在/etc/direcfbrc，是个全局的，另一个是存放在$HOME/.directfbrc，它是个局部的，可以覆盖系统的设置。

需要注意的是，这两个文件都不是默认存在的，是需要你自己建立的，不要象我一样，刚开始的时候到处找也没有找到，呵呵。

在directfbrc使用的参数也可以在命令行里传递给DirectFB应用程序，只需要加上前缀：--dfb:

相关语法：

directfbrc文件每一行包含一个变量。注释行以井号“#”开始，一直到行尾。空行被忽略。

许多参数只是一种开关，控制着一些特性的开/关。这些开关选项有一个no-变量，可以关闭相应的特性。下面介绍一些实用的参数和一些默认的参数。

参数：

以下参数可以在directfbrc文件中设定

system=<system>

       设定使用的图形系统。默认使用Linux frame buffer (fbdev)，但你也可以在SDL（sdl）上运行DirectFB应用程序。其它的系统在将来可能会被扩展近来。

fbdev=<device>

打开指定的frame buffer设备，而不是默认的/dev/fb0。

mode=<width>x<height>

设定默认的屏幕显示。如果不设定，DirectFB将使用/etc/fb.modes 的第一个设定值。一些frame buffer设备(如 vesafb) 不支持模式切换，而只能使用启动时设定的值。

depth=<pixeldepth>

使用二进制位数设置每像素默认的像素深度。如果没有指定，DirectFB将使用/etc/fb.modes里面的第一个指定的深度值。DirectFB 支持8, 15, 16, 24和32位的颜色深度（color depths），这些值依赖于你使用的frame buffer设备是否支持。一些frame buffer设备(如： vesafb) 根本就不支持模式切换，只能使用在启动时设定的像素深度值。

pixelformat=<pixelformat>

设置默认的像素格式。和上面描述的深度参数类似但允许更精细的控制。Pixelformat的值可以为LUT8, RGB332, RGB16, RGB24和RGB32。一些设备可能还支持更奇怪的A8, ALUT44, ARGB, ARGB1555, I420, UYVY, YUY2 和YV12像素格式。

session=<num>

选择被添加或创建的多应用程序。开始为0，如果强行设置为负值，则使用一个可用的最小值。设定的值将覆盖环境变量“DIRECTFB_SESSION”的值。

primary-layer=<id>

选定哪一个层为“主层”（primary layer），默认的是第一个。查看‘dfbinfo’可以找到你的硬件支持的层列表。

tmpfs=<directory>

使用给定的文件夹（tmpfs挂载点）来多应用程序模式下创建共享内存文件。这个选项只在自动检测失败或者渴望非tmpfs存储时才有用。

memcpy=<method>

使用这个选项，对memcpy()程序（routines）的探测会被忽略，节省了不少启动时间。传递“help”参数可以看到一系列的可能值。

quiet

禁止从DirectFB控制台（console）输出。只显示错误信息。

[no-]banner

启动时使输出DirectFB标志（banner）有效。默认有效。

[no-]debug

使debug输出有效。默认有效，但是除非你编译DirectFB时支持debug选项，否则，你不会不看到任何错误输出。

force-windowed

强制主表面（primary surface）为一个窗口。这样可以使设计成全屏显示的应用程序在一个窗口上运行。

force-desktop

强制使主表面（primary surface）成为桌面的后台表面（background surface）。

[no-]hardware

置硬件加速为有效。默认会自动探测硬件加速。如果你置它为无效，则显卡驱动虽然也会被加载并可以访问其它的显示层（如果有的话），但是，所有的图形操作将被软件来渲染（renderer）。

[no-]sync

初始化DirectFB之前清空所有的硬盘缓冲区（disk buffers） 。当你工作环境为实验性的设备驱动和预计会出现冲突（crashes）时比较有用。默认此功能为无效。

[no-]mmx

选相no-mmx使得即使检测到有MMX的支持也不能使用MMX程序（routines）。如果提供了MMX并在编译时加入了MMX的支持，默认该选相有效。

[no-]argb-font

向ARGB面载入字的轮廓（glyphs），而不是使用A8面（alpha masks）。该设置使用了更多的内存，但是一些显卡在使用A8面时会出现一些诡异现象。如果你的字体看起来比较奇怪，试试该选项。

[no-]a1-font

向A1平面载入字的轮廓（glyphs），而不是使用A8平面（alpha masks）。如果图形驱动不支持彩色+混合平移（blit，译者注，blit此处翻译成平移，具体的含义见附录），该选项可以加速字体渲染，但会影响质量。一般情况下你根本不需要使用该选项，因为基于A8字体的软件已经是高度优化和足够快了。

[no-]sighandler

默认情况下，DirectFB为一些信号量（signal）安装了一个可以使应用程序退出的信号量句柄（handler）。这个信号量句柄试图在退出应用程序前解除初始化的DirectFB引擎。使用该选项可以开/关此特性。

dont-catch=<num>[[,<num>]...]

和上面对sighandler选项描述类似。使用该选项你可以对不能使用该方式被处理的信号量列出一个详细的清单。

[no-]deinit-check

默认情况下，DirectFB在退出时会检查所有已释放所分配的资源，如果没有，它将在应用程序退出后释放之。该选项可以开/关此功能。

block-all-signals

该选项可以阻塞所有的信号量，对DirectFB daemons有用（DirectFB master应用程序除了是一个master外，什么也不做）。

[no-]vt-switch

默认情况下，DirectFB会分配一个新的虚拟终端并转向使用它。

[no-]vt-switching

可以使用<Ctrl>+<Alt>+<F?>来切换虚拟终端。这是一个实验特性，经常无效，你看着办吧。

[no-]graphics-vt

使虚拟终端转为图形模式。有如下优点：当DirectFB应用程序运行时，内核的消息不会在屏幕上显示。

[no-]motion-compression

DirectFB常常压缩（compresse）鼠标移动事件。也就是说，一系列的鼠标移动事件被看作一个简单的鼠标移动事件。这样可以达到更快的响应但是鼠标处理的精确度会受到影响。

mouse-protocol=<protocol>

为一个串口鼠标指定使用的协议。以下的协议被支持：

MS使用微软鼠标协议的两个按钮的鼠标；

MS3使用扩展的微软鼠标协议的三按钮鼠标；

MouseMan使用一种Logitech开发的另一种扩展的微软鼠标协议的三按钮的鼠标；

MouseSystems广泛使用的三按钮鼠标。

串口鼠标所使用的协议的详细信息可参考相关资料。

[no-]lefty

切换鼠标左右按键，对“左撇子”（^_^）比较有用。

[no-]capslock-meta

把CapsLock键映射到Meta。对建在WM的用户有用，因为键盘上没有Meta键（例如Window键）。

[no-]cursor

默认情况下，DirectFB在使用窗口时显示一个鼠标箭头。该选项允许彻底关闭鼠标箭头。即使在应用程序里也不能让它再出现。

disable-module=<modulename>

禁止该模块的载入。模块的名字为文件名，但不能带有libdirectfb前缀也不能是其扩展（例如，若文件名为keyboard，则键盘输入模块载入被禁止）。

bg-none

使背景处理完全无效。不要设置给选项，否则鼠标和窗口移动时会在背景留下难看的痕迹。

bg-color=AARRGGBB

控制背景的颜色。颜色的值为十六进制值。默认的alpha值为完全不透明并可能被忽略。例如，设定背景色为红紫色（magenta），可以使用bg-color=FF00FF。

bg-image=<filename>

使用给定的文件中的图象充填背景。图象会被伸缩（stretch）以适应屏幕的尺寸。

bg-tile=<filename>

类似bg-image，这里使用图象的图快（tile）方式在屏幕的尺寸显示，而不是伸缩方式。

[no-]translucent-windows

默认情况下，DirectFB窗口可能是半透明的。如果你使该选项无效，则窗口会被强制为完全不透明或者是全透明。当你的显卡不支持alpha 半透明图快（alpha-transparent blit）时，该选项比较有用。

videoram-limit=<amount>

限制DirectFB使用的视频RAM。视频RAM大小的单位为K字节数。

matrox-tv-standard=[pal|ntsc]

控制由Matrox卡的TV输出产生的信号。

[no-]matrox-sgram

一些老的Matrox G400卡有SGRAM 并且如果设定该选项，一些图形操作在这些卡上执行相当快。如果你的卡上没有SGRAM，不要试图选中该选项，否则，你不得不重起。

[no-]matrox-crtc2

如果你有个双重的head G400/G450/G550，你可是使用该选项利用第二个head驱动附加层。

screenshot-dir=<directory>

如果选定该选项，当你按下<Print>键，DirectFB 将把屏幕的内容以PPM格式放到这个指定的目录。

window-surface-policy=<policy>

控制窗口平面存放的位置。<policy>的值可以是：

auto DirectFB依据硬件特性自动判断，默认为该选项；

videohigh以高优先级方式切换（swap）系统/视频内存；

videolow以低优先级方式切换（swap）系统/视频内存；

systemonly窗口平面保存在系统内存中；

videoonly窗口平面保存在视频内存中。

desktop-buffer-mode=<mode>

控制桌面缓冲区模式。无论何时，窗口在移动、打开、关闭、调整大小或者变换内容，DirectFB将在受影响的范围内重新合成窗口堆栈，这是通过和平移（blit）在该范围的窗口一起来完成的。不通明窗口被直接平移，而半透明的窗口则使用alpha混合或颜色键来平移。如果有后端缓冲区（back buffer）的话，合成是不可见的，因为只有最终的结果会被拷贝到前端缓冲区（front buffer）。如果没有后端缓冲区，合成的每一步都是可见的，这将导致明显的闪烁，除非所有的窗口都是非透明的。

<mode>的可选值有：

auto DirectFB依据硬件特性来判断，为默认值。如果硬件支持简单blit（从后端向前端缓冲区中拷贝）操作，DirectFB会在视频缓冲区中选取一个后端缓冲区。如果没有加速功能，会在系统内存中开辟一个后端缓冲区，因为这样软件里的alpha混合合成操作可以执行地更好，并可以避免在结果已经拷贝到前端缓冲区中的情况下，再重新从视频缓冲区中读取。

backsystem在系统内存中开辟一个后端缓冲区。如果你的硬件支持简单blitting但却没有alpha混合，这是推荐选择，你将得到许多alpha混合窗口。

backvideo在视频内存中分配前端和后端缓冲区。该值特别不建议设定，因为如果blit被加速的话，‘auto’模式下会选择该值。没有加速的blit操作，该值不推荐使用。

frontonly没有后端缓冲区。如果你仅仅使用不透明窗口并且不使用任何颜色键，这是一个最佳选择。

vsync-after

flip操作后等待垂直折回（vertical retrace）。默认情况下在做flip操作前等待。

vsync-none

对垂直折回（vertical retrace）关闭polling操作。