Changes between Version 33 and Version 34 of GraphicsApi

Timestamp:

Aug 21, 2012, 2:41:05 AM (12 years ago)

Author:

charlief

Comment:

--

GraphicsApi

@@ -197 +197 @@
 in this case, the BOINC Manager's '''Show Graphics''' button will
 open a Web browser window to this URL.
+
+== Displaying text ==
+
+Older versions of the BOINC graphics API library included support for ''texture fonts'' in files of the form ''*.txf''.  These are no longer supported, but we have added support for displaying !TrueType fonts in BOINC graphics applications.
+ * Add the files `api/ttfont.cpp` and `api/ttfont.h` to your application (they are not included in any BOINC library.)
+ * You will need to build and link with the [http://www.freetype.org FreeType2] and [http://sourceforge.net/projects/ftgl/files/FTGL%20Source/ FTGL] libraries.  Depending on how you build the FreeType2 library, FreeType2 may require the libz and libbz2 libraries.
+ * We have put copies of the free Liberation fonts in the `api/ttf/` directory.  If you wish to use other !TrueType fonts, you will need to adjust the list of font names in `ttfont.cpp`.
+ * Download the desired !TrueType fonts to the client where they are available to your graphics application.
+
+For examples, please see the `clientscr/ss_app.cpp` and `samples/exampple_app/uc2_graphics.cpp` in the BOINC SVN trunk.
+
+If your graphics application currently uses the older ''texture fonts'' , note that the ttf_load_fonts() and txf_render_string() APIs are slightly different from the old txf_load_fonts() and txf_render_string() APIs.  Please see the `ttfont.cpp` and `ttfont.h` files for details.