[Scummvm-cvs-logs] scummvm master -> b6f32028e1e7457cedc49423df017bdeedfeabaa

[lordhoto]

This automated email contains information about 1 new commit which have been
pushed to the 'scummvm' repo located at https://github.com/scummvm/scummvm .

Summary:
b6f32028e1 GRAPHICS: Document loadTTFFont a bit.


Commit: b6f32028e1e7457cedc49423df017bdeedfeabaa
    https://github.com/scummvm/scummvm/commit/b6f32028e1e7457cedc49423df017bdeedfeabaa
Author: Johannes Schickel (lordhoto at scummvm.org)
Date: 2013-12-08T11:11:59-08:00

Commit Message:
GRAPHICS: Document loadTTFFont a bit.

Changed paths:
    graphics/fonts/ttf.h



diff --git a/graphics/fonts/ttf.h b/graphics/fonts/ttf.h
index e1464b1..65aba32 100644
--- a/graphics/fonts/ttf.h
+++ b/graphics/fonts/ttf.h
@@ -32,6 +32,24 @@
 namespace Graphics {
 
 class Font;
+
+/**
+ * Loads a TTF font file from a given data stream object.
+ *
+ * @param stream     Stream object to load font data from.
+ * @param size       The point size to load.
+ * @param dpi        The dpi to use for size calculations, by default 72dpi
+ *                   are used.
+ * @param monochrome Whether the font should be loaded in pure monochrome
+ *                   mode. In case this is true no aliasing is used.
+ * @param mapping    A mapping from code points 0-255 into UTF-32 code points.
+ *                   This can be used to support various 8bit character sets.
+ *                   In case the msb of the UTF-32 code point is set the font
+ *                   loading fails in case no glyph for it is found. When this
+ *                   is non-null only characters given in the mapping are
+ *                   supported.
+ * @return 0 in case loading fails, otherwise a pointer to the Font object.
+ */
 Font *loadTTFFont(Common::SeekableReadStream &stream, int size, uint dpi = 0, bool monochrome = false, const uint32 *mapping = 0);
 
 void shutdownTTF();