1 wxWidgets for DirectFB installation
2 ===================================
6 wxDFB is currently incomplete and some parts of the wxWidgets library
7 don't yet compile and must be disabled during configuration. In particular,
8 the coverage of wxDC API is limited.
14 wxDFB requires the DirectFB library (http://www.directfb.org), which must
15 be installed before compiling wxDFB.
21 Compilation is done in the standard Unix fashion, using configure and make.
22 Please refer to e.g. wxGTK's install.txt for details if you are unfamiliar
25 When configuring, use the --with-directfb option instead of e.g. --with-gtk
26 to specify that the wxDFB port should be built. You'll also need to disable
27 wxWidgets features that don't work in wxDFB yet:
29 $ ./configure --with-directfb \
42 --disable-choicebook \
46 --disable-filepicker \
48 --disable-fontpicker \
59 DirectFB doesn't have native fonts configuration mechanism (such as
60 fontconfig used by GTK+) and so wxDFB implements a simple configuration
63 No fonts are installed and configured by "make install", you have to manually
64 configure fonts after you install the library.
66 wxDFB looks the fonts up in directories specified in the WXDFB_FONTPATH
67 environment variable (separated with :, similarly to the PATH variable). If
68 the variable is not set, $prefix/share/wx/fonts directory is used. All
69 subdirectories of the directories on the path are scanned for FontsIndex
70 files. These files are parsed and fonts defined in them are added to the fonts
73 The FontsIndex file is standard wxFileConfig file text file. Each toplevel
74 group specifies one font bundle, font's name is the name of group. Group's
75 entries look like this:
78 # font files (at least one of them must be present):
79 Regular=RegularFaceFile.ttf
80 Italic=ItalicFaceFile.ttf
82 BoldItalic=BoldItalicFaceFile.ttf
83 # optional tag indicating this font is fixed-with (default is false):
86 Additionally, there may be DefaultXXX entries at the toplevel for every family
87 XXX and a Default entry that is shortcut for setting all families' default,
88 their value is name of the default font:
90 # optional tags indicating the default font for given family:
91 DefaultDecorative=Font Name
92 DefaultRoman=Font Name
93 DefaultScript=Font Name
94 DefaultSwiss=Font Name
95 DefaultModern=Font Name
96 DefaultTeletype=Font Name
97 # indicate the font that is default for all families (optional):
100 Any font formats supported by DirectFB (which typically includes formats
101 supported by the FreeType library) can be used.
107 Please send bug reports with a description of your environment,
108 compiler and the error message(s) to the wxwin-developers mailing list at:
110 wx-dev@lists.wxwidgets.org