install.txt 2.9 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788
  1. wxWidgets for DirectFB installation
  2. ===================================
  3. IMPORTANT NOTE:
  4. wxDFB is currently incomplete and some parts of the wxWidgets library
  5. don't yet compile and must be disabled during configuration. In particular,
  6. the coverage of wxDC API is limited.
  7. Dependencies
  8. ------------
  9. wxDFB requires the DirectFB library (http://www.directfb.org), which must
  10. be installed before compiling wxDFB.
  11. Compiling
  12. ---------
  13. Compilation is done in the standard Unix fashion, using configure and make.
  14. Please refer to e.g. wxGTK's install.txt for details if you are unfamiliar
  15. with configure.
  16. When configuring, use the --with-directfb option instead of e.g. --with-gtk
  17. to specify that the wxDFB port should be built. You may also need to disable
  18. wxUniv themes that don't work in wxDFB yet (alternatively you can set the
  19. WXTHEME environment variable to "mono"):
  20. $ ./configure --with-directfb --with-themes=mono
  21. $ make
  22. Configuring fonts
  23. -----------------
  24. DirectFB doesn't have native fonts configuration mechanism (such as
  25. fontconfig used by GTK+) and so wxDFB implements a simple configuration
  26. mechanism itself.
  27. No fonts are installed and configured by "make install", you have to manually
  28. configure fonts after you install the library.
  29. wxDFB looks the fonts up in directories specified in the WXDFB_FONTPATH
  30. environment variable (separated with :, similarly to the PATH variable). If
  31. the variable is not set, $prefix/share/wx/fonts directory is used. All
  32. subdirectories of the directories on the path are scanned for FontsIndex
  33. files. These files are parsed and fonts defined in them are added to the fonts
  34. list.
  35. The FontsIndex file is standard wxFileConfig file text file. Each toplevel
  36. group specifies one font bundle, font's name is the name of group. Group's
  37. entries look like this:
  38. [Font Name]
  39. # font files (at least one of them must be present):
  40. Regular=RegularFaceFile.ttf
  41. Italic=ItalicFaceFile.ttf
  42. Bold=BoldFaceFile.ttf
  43. BoldItalic=BoldItalicFaceFile.ttf
  44. # optional tag indicating this font is fixed-with (default is false):
  45. IsFixed=1
  46. Additionally, there may be DefaultXXX entries at the toplevel for every family
  47. XXX and a Default entry that is shortcut for setting all families' default,
  48. their value is name of the default font:
  49. # optional tags indicating the default font for given family:
  50. DefaultDecorative=Font Name
  51. DefaultRoman=Font Name
  52. DefaultScript=Font Name
  53. DefaultSwiss=Font Name
  54. DefaultModern=Font Name
  55. DefaultTeletype=Font Name
  56. # indicate the font that is default for all families (optional):
  57. Default=Font Name
  58. Any font formats supported by DirectFB (which typically includes formats
  59. supported by the FreeType library) can be used.
  60. Bug reports
  61. -----------
  62. Please send bug reports with a description of your environment,
  63. compiler and the error message(s) to the wxwin-developers mailing list at:
  64. wx-dev@lists.wxwidgets.org