Types [DirectFB Reference Manual]

	DFB_OK	No error occured. 没有错误发生
	DFB_FAILURE	A general or unknown error occured. 发生了一般或未知错误
	DFB_INIT	A general initialization error occured. 发生了一般初始化错误
	DFB_BUG	Internal bug or inconsistency has been detected. 检测到内部错误或不相容错误
	DFB_DEAD	Interface has a zero reference counter (available in debug mode). 接口总数为零（在调试模式时有效）
	DFB_UNSUPPORTED	The requested operation or an argument is (currently) not supported. 被请求的选项或参数（目前）不被支持
	DFB_UNIMPLEMENTED	The requested operation is not implemented, yet. 被请求的选项或参数还没有完成
	DFB_ACCESSDENIED	Access to the resource is denied. 访问资源被拒绝
	DFB_INVARG	An invalid argument has been specified. 指定的参数无效
	DFB_NOSYSTEMMEMORY	There's not enough system memory. 没有足够的系统内存
	DFB_NOVIDEOMEMORY	There's not enough video memory. 没有足够视频内存
	DFB_LOCKED	The resource is (already) locked. 资源被（己经）锁定
	DFB_BUFFEREMPTY	The buffer is empty. 缓冲为空
	DFB_FILENOTFOUND	The specified file has not been found. 找不到指定的文件
	DFB_IO	A general I/O error occured. 一般的I/O错误发生
	DFB_BUSY	The resource or device is busy. 资源或设备繁忙
	DFB_NOIMPL	No implementation for this interface or content type has been found. 没有完成这个接口或内容已经被找到
	DFB_MISSINGFONT	No font has been set. 没有设置字体
	DFB_TIMEOUT	The operation timed out. 操作超时
	DFB_MISSINGIMAGE	No image has been set. 没有设置图像
	DFB_THIZNULL	'thiz' pointer is NULL. 'thiz'指针为空
	DFB_IDNOTFOUND	No resource has been found by the specified id. 没有找到指定的资源
	DFB_INVAREA	An invalid area has been specified or detected. 指定或检测到一个无效域
	DFB_DESTROYED	The underlying object (e.g. a window or surface) has been destroyed .基础对象（例如：窗口或平面）已摧毁
	DFB_FUSION	Internal fusion error detected, most likely related to IPC resources. 检测到内部fusion 错误，大多像与IPC相关的资源
	DFB_BUFFERTOOLARGE	Buffer is too large. 缓冲过大
	DFB_INTERRUPTED	The operation has been interrupted. 操作台已经被终止
	DFB_NOCONTEXT	No context available. 没有效的内容
	DFB_TEMPUNAVAIL	Temporarily unavailable. 临时失效
	DFB_LIMITEXCEEDED	Attempted to exceed limit, i.e. any kind of maximum size, count etc. 执行意思被限制例如。任何类型的最大数，总数等等
	DFB_NOSUCHMETHOD	Requested method is not known to remote site. 请求的方法不被远程站点识别
	DFB_NOSUCHINSTANCE	Requested instance is not known to remote site. 请求的实例不被远程站点识别
	DFB_ITEMNOTFOUND	No such item found. 没有此类条目
	DFB_VERSIONMISMATCH	Some versions didn't match. 一些版本不匹配
	DFB_NOSHAREDMEMORY	There's not enough shared memory. 没有足够的共享内存
	DFB_EOF	Reached end of file. 查找了文件的结尾
	DFB_SUSPENDED	The requested object is suspended. 请求的对象已经被挂起
	DFB_INCOMPLETE	The operation has been executed, but not completely. 操作已经执行，但还没有完成

int	x;	X coordinate of its top-left point
int	y;	Y coordinate of its top-left point
int	w;	width of it
int	h;	height of it

float	x;	normalized X coordinate
float	y;	normalized Y coordinate
float	w;	normalized width
float	h;	normalized height

int	x1;	X coordinate of top-left point
int	y1;	Y coordinate of top-left point
int	x2;	X coordinate of lower-right point
int	y2;	Y coordinate of lower-right point

int	l;	distance from left edge
int	t;	distance from top edge
int	r;	distance from right edge
int	b;	distance from bottom edge

int	x1;	X coordinate of first edge
int	y1;	Y coordinate of first edge
int	x2;	X coordinate of second edge
int	y2;	Y coordinate of second edge
int	x3;	X coordinate of third edge
int	y3;	Y coordinate of third edge

u8	a;	alpha channel
u8	r;	red channel
u8	g;	green channel
u8	b;	blue channel

	DFSCL_NORMAL	Normal shared access, primary surface will be the buffer of an implicitly created window at the resolution given by SetVideoMode().
	DFSCL_FULLSCREEN	Application grabs the primary layer, SetVideoMode automates layer control. Primary surface is the primary layer surface.
	DFSCL_EXCLUSIVE	All but the primary layer will be disabled, the application has full control over layers if desired, other applications have no input/output/control. Primary surface is the primary layer surface.

	DLCAPS_NONE
	DLCAPS_SURFACE	The layer has a surface that can be drawn to. This may not be provided by layers that display realtime data, e.g. from an MPEG decoder chip. Playback control may be provided by an external API.
	DLCAPS_OPACITY	The layer supports blending with layer(s) below based on a global alpha factor.
	DLCAPS_ALPHACHANNEL	The layer supports blending with layer(s) below based on each pixel's alpha value.
	DLCAPS_SCREEN_LOCATION	The layer location on the screen can be changed, this includes position and size as normalized values. The default is 0.0f, 0.0f, 1.0f, 1.0f.
	DLCAPS_FLICKER_FILTERING	Flicker filtering can be enabled for smooth output on interlaced display devices.
	DLCAPS_DEINTERLACING	The layer provides optional deinterlacing for displaying interlaced video data on progressive display devices.
	DLCAPS_SRC_COLORKEY	A specific color can be declared as transparent.
	DLCAPS_DST_COLORKEY	A specific color of layers below can be specified as the color of the only locations where the layer is visible.
	DLCAPS_BRIGHTNESS	Adjustment of brightness is supported.
	DLCAPS_CONTRAST	Adjustment of contrast is supported.
	DLCAPS_HUE	Adjustment of hue is supported.
	DLCAPS_SATURATION	Adjustment of saturation is supported.
	DLCAPS_LEVELS	Adjustment of the layer's level (z position) is supported.
	DLCAPS_FIELD_PARITY	Field parity can be selected
	DLCAPS_WINDOWS	Hardware window support.
	DLCAPS_SOURCES	Sources can be selected.
	DLCAPS_ALPHA_RAMP	Alpha values for formats with one or two alpha bits can be chosen, i.e. using ARGB1555 or ARGB2554 the user can define the meaning of the two or four possibilities. In short, this feature provides a lookup table for the alpha bits of these formats. See also IDirectFBSurface::SetAlphaRamp().
	DLCAPS_PREMULTIPLIED	Surfaces with premultiplied alpha are supported.
	DLCAPS_SCREEN_POSITION
	DLCAPS_SCREEN_SIZE
	DLCAPS_CLIP_REGIONS	Supports IDirectFBDisplayLayer::SetClipRegions().
	DLCAPS_ALL

	DSCCAPS_NONE
	DSCCAPS_VSYNC	Synchronization with the vertical retrace supported.
	DSCCAPS_POWER_MANAGEMENT	Power management supported.
	DSCCAPS_MIXERS	Has mixers.
	DSCCAPS_ENCODERS	Has encoders.
	DSCCAPS_OUTPUTS	Has outputs.
	DSCCAPS_ALL

	DLOP_NONE	None of these.
	DLOP_ALPHACHANNEL	Make usage of alpha channel for blending on a pixel per pixel basis.
	DLOP_FLICKER_FILTERING	Enable flicker filtering.
	DLOP_DEINTERLACING	Enable deinterlacing of an interlaced (video) source.
	DLOP_SRC_COLORKEY	Enable source color key.
	DLOP_DST_COLORKEY	Enable dest. color key.
	DLOP_OPACITY	Make usage of the global alpha factor set by SetOpacity.
	DLOP_FIELD_PARITY	Set field parity

	DLBM_UNKNOWN
	DLBM_FRONTONLY	no backbuffer
	DLBM_BACKVIDEO	backbuffer in video memory
	DLBM_BACKSYSTEM	backbuffer in system memory
	DLBM_TRIPLE	triple buffering
	DLBM_WINDOWS	no layer buffers at all, using buffer of each window

	DSDESC_NONE	none of these
	DSDESC_CAPS	caps field is valid
	DSDESC_WIDTH	width field is valid
	DSDESC_HEIGHT	height field is valid
	DSDESC_PIXELFORMAT	pixelformat field is valid
	DSDESC_PREALLOCATED	Surface uses data that has been preallocated by the application. The field array 'preallocated' has to be set using the first element for the front buffer and eventually the second one for the back buffer.
	DSDESC_PALETTE	Initialize the surfaces palette with the entries specified in the description.
	DSDESC_ALL	all of these

	DPDESC_CAPS	Specify palette capabilities.
	DPDESC_SIZE	Specify number of entries.
	DPDESC_ENTRIES	Initialize the palette with the entries specified in the description.

	DSCAPS_NONE	None of these.
	DSCAPS_PRIMARY	It's the primary surface.
	DSCAPS_SYSTEMONLY	Surface data is permanently stored in system memory. There's no video memory allocation/storage.
	DSCAPS_VIDEOONLY	Surface data is permanently stored in video memory. There's no system memory allocation/storage.
	DSCAPS_DOUBLE	Surface is double buffered
	DSCAPS_SUBSURFACE	Surface is just a sub area of another one sharing the surface data.
	DSCAPS_INTERLACED	Each buffer contains interlaced video (or graphics) data consisting of two fields. Their lines are stored interleaved. One field's height is a half of the surface's height.
	DSCAPS_SEPARATED	For usage with DSCAPS_INTERLACED. DSCAPS_SEPARATED specifies that the fields are NOT interleaved line by line in the buffer. The first field is followed by the second one.
	DSCAPS_STATIC_ALLOC	The amount of video or system memory allocated for the surface is never less than its initial value. This way a surface can be resized (smaller and bigger up to the initial size) without reallocation of the buffers. It's useful for surfaces that need a guaranteed space in video memory after resizing.
	DSCAPS_TRIPLE	Surface is triple buffered.
	DSCAPS_PREMULTIPLIED	Surface stores data with premultiplied alpha.
	DSCAPS_DEPTH	A depth buffer is allocated.
	DSCAPS_ALL	All of these.

	DSDRAW_NOFX	uses none of the effects
	DSDRAW_BLEND	uses alpha from color
	DSDRAW_DST_COLORKEY	write to destination only if the destination pixel matches the destination color key
	DSDRAW_SRC_PREMULTIPLY	multiplies the color's rgb channels by the alpha channel before drawing
	DSDRAW_DST_PREMULTIPLY	modulates the dest. color with the dest. alpha
	DSDRAW_DEMULTIPLY	divides the color by the alpha before writing the data to the destination
	DSDRAW_XOR	bitwise xor the destination pixels with the specified color after premultiplication

	DSBLIT_NOFX	uses none of the effects
	DSBLIT_BLEND_ALPHACHANNEL	enables blending and uses alphachannel from source
	DSBLIT_BLEND_COLORALPHA	enables blending and uses alpha value from color
	DSBLIT_COLORIZE	modulates source color with the color's r/g/b values
	DSBLIT_SRC_COLORKEY	don't blit pixels matching the source color key
	DSBLIT_DST_COLORKEY	write to destination only if the destination pixel matches the destination color key
	DSBLIT_SRC_PREMULTIPLY	modulates the source color with the (modulated) source alpha
	DSBLIT_DST_PREMULTIPLY	modulates the dest. color with the dest. alpha
	DSBLIT_DEMULTIPLY	divides the color by the alpha before writing the data to the destination
	DSBLIT_DEINTERLACE	deinterlaces the source during blitting by reading only one field (every second line of full image) scaling it vertically by factor two
	DSBLIT_SRC_PREMULTCOLOR	modulates the source color with the color alpha
	DSBLIT_XOR	bitwise xor the destination pixels with the source pixels after premultiplication
	DSBLIT_INDEX_TRANSLATION	do fast indexed to indexed translation, this flag is mutual exclusive with all others

	DFXL_NONE	None of these.
	DFXL_FILLRECTANGLE	FillRectangle() is accelerated.
	DFXL_DRAWRECTANGLE	DrawRectangle() is accelerated.
	DFXL_DRAWLINE	DrawLine() is accelerated.
	DFXL_FILLTRIANGLE	FillTriangle() is accelerated.
	DFXL_BLIT	Blit() and TileBlit() are accelerated.
	DFXL_STRETCHBLIT	StretchBlit() is accelerated.
	DFXL_TEXTRIANGLES	TextureTriangles() is accelerated.
	DFXL_DRAWSTRING	DrawString() and DrawGlyph() are accelerated.
	DFXL_ALL	All drawing/blitting functions.

	DLTF_NONE	Unclassified, no specific type.
	DLTF_GRAPHICS	Can be used for graphics output.
	DLTF_VIDEO	Can be used for live video output.
	DLTF_STILL_PICTURE	Can be used for single frames.
	DLTF_BACKGROUND	Can be used as a background layer.
	DLTF_ALL	All type flags set.

	DIDTF_NONE	Unclassified, no specific type.
	DIDTF_KEYBOARD	Can act as a keyboard.
	DIDTF_MOUSE	Can be used as a mouse.
	DIDTF_JOYSTICK	Can be used as a joystick.
	DIDTF_REMOTE	Is a remote control.
	DIDTF_VIRTUAL	Is a virtual input device.
	DIDTF_ALL	All type flags set.

	DICAPS_KEYS	device supports key events
	DICAPS_AXES	device supports axis events
	DICAPS_BUTTONS	device supports button events
	DICAPS_ALL	all capabilities

	DIBI_LEFT	left mouse button
	DIBI_RIGHT	right mouse button
	DIBI_MIDDLE	middle mouse button
	DIBI_FIRST	other buttons: DIBI_FIRST + zero based index
	DIBI_LAST	32 buttons maximum

	DIAI_X	X axis
	DIAI_Y	Y axis
	DIAI_Z	Z axis
	DIAI_FIRST	other axis: DIAI_FIRST + zero based index
	DIAI_LAST	32 axes maximum

	DWDESC_CAPS	caps field is valid
	DWDESC_WIDTH	width field is valid
	DWDESC_HEIGHT	height field is valid
	DWDESC_PIXELFORMAT	pixelformat field is valid
	DWDESC_POSX	posx field is valid
	DWDESC_POSY	posy field is valid
	DWDESC_SURFACE_CAPS	Create the window surface with special capabilities.

	DBDESC_FILE	Create a static buffer for the specified filename.
	DBDESC_MEMORY	Create a static buffer for the specified memory area.

	DWCAPS_NONE	None of these.
	DWCAPS_ALPHACHANNEL	The window has an alphachannel for pixel-per-pixel blending.
	DWCAPS_DOUBLEBUFFER	The window's surface is double buffered. This is very useful to avoid visibility of content that is still in preparation. Normally a window's content can get visible before an update if there is another reason causing a window stack repaint.
	DWCAPS_INPUTONLY	The window has no surface. You can not draw to it but it receives events
	DWCAPS_NODECORATION	The window won't be decorated.
	DWCAPS_ALL	All valid flags.

	DFFA_NONE	none of these flags
	DFFA_NOKERNING	don't use kerning
	DFFA_NOHINTING	don't use hinting
	DFFA_MONOCHROME	don't use anti-aliasing
	DFFA_NOCHARMAP	no char map, glyph indices are specified directly
	DFFA_FIXEDCLIP	width fixed advance, clip to it

	DFDESC_ATTRIBUTES	attributes field is valid
	DFDESC_HEIGHT	height is specified
	DFDESC_WIDTH	width is specified
	DFDESC_INDEX	index is specified
	DFDESC_FIXEDADVANCE	specify a fixed advance overriding any character advance of fixed or proportional fonts
	DFDESC_FRACT_HEIGHT	fractional height is set
	DFDESC_FRACT_WIDTH	fractional width is set

	DFBFontDescriptionFlags	flags;
	DFBFontAttributes	attributes;
	int	height;
	int	width;
	unsigned int	index;
	int	fixed_advance;
	int	fract_height;
	int	fract_width;

	DSPF_UNKNOWN	unknown or unspecified format
	DSPF_ARGB1555	16 bit ARGB (2 byte, alpha 1@15, red 5@10, green 5@5, blue 5@0)
	DSPF_RGB16	16 bit RGB (2 byte, red 5@11, green 6@5, blue 5@0)
	DSPF_RGB24	24 bit RGB (3 byte, red 8@16, green 8@8, blue 8@0)
	DSPF_RGB32	24 bit RGB (4 byte, nothing@24, red 8@16, green 8@8, blue 8@0)
	DSPF_ARGB	32 bit ARGB (4 byte, alpha 8@24, red 8@16, green 8@8, blue 8@0)
	DSPF_A8	8 bit alpha (1 byte, alpha 8@0), e.g. anti-aliased glyphs
	DSPF_YUY2	16 bit YUV (4 byte/ 2 pixel, macropixel contains CbYCrY [31:0])
	DSPF_RGB332	8 bit RGB (1 byte, red 3@5, green 3@2, blue 2@0)
	DSPF_UYVY	16 bit YUV (4 byte/ 2 pixel, macropixel contains YCbYCr [31:0])
	DSPF_I420	12 bit YUV (8 bit Y plane followed by 8 bit quarter size U/V planes)
	DSPF_YV12	12 bit YUV (8 bit Y plane followed by 8 bit quarter size V/U planes)
	DSPF_LUT8	8 bit LUT (8 bit color and alpha lookup from palette)
	DSPF_ALUT44	8 bit ALUT (1 byte, alpha 4@4, color lookup 4@0)
	DSPF_AiRGB	32 bit ARGB (4 byte, inv. alpha 8@24, red 8@16, green 8@8, blue 8@0)
	DSPF_A1	1 bit alpha (1 byte/ 8 pixel, most significant bit used first)
	DSPF_NV12	12 bit YUV (8 bit Y plane followed by one 16 bit quarter size CbCr [15:0] plane)
	DSPF_NV16	16 bit YUV (8 bit Y plane followed by one 16 bit half width CbCr [15:0] plane)
	DSPF_ARGB2554	16 bit ARGB (2 byte, alpha 2@14, red 5@9, green 5@4, blue 4@0)
	DSPF_ARGB4444	16 bit ARGB (2 byte, alpha 4@12, red 4@8, green 4@4, blue 4@0)
	DSPF_NV21	12 bit YUV (8 bit Y plane followed by one 16 bit quarter size CrCb [15:0] plane)
	DSPF_AYUV	32 bit AYUV (4 byte, alpha 8@24, Y 8@16, Cb 8@8, Cr 8@0)
	DSPF_A4	4 bit alpha (1 byte/ 2 pixel, more significant nibble used first)
	DSPF_ARGB1666	1 bit alpha (3 byte/ alpha 1@18, red 6@16, green 6@6, blue 6@0)
	DSPF_ARGB6666	6 bit alpha (3 byte/ alpha 6@18, red 6@16, green 6@6, blue 6@0)
	DSPF_RGB18	6 bit RGB (3 byte/ red 6@16, green 6@6, blue 6@0)
	DSPF_LUT2	2 bit LUT (1 byte/ 4 pixel, 2 bit color and alpha lookup from palette)
	DSPF_RGB444	16 bit RGB (2 byte, nothing @12, red 4@8, green 4@4, blue 4@0)
	DSPF_RGB555	16 bit RGB (2 byte, nothing @15, red 5@10, green 5@5, blue 5@0)