Index: ppapi/c/dev/ppb_font_dev.h |
=================================================================== |
--- ppapi/c/dev/ppb_font_dev.h (revision 86427) |
+++ ppapi/c/dev/ppb_font_dev.h (working copy) |
@@ -56,18 +56,31 @@ |
struct PP_FontDescription_Dev { |
/** |
* Font face name as a string. This can also be an undefined var, in which |
- * case the generic family will be obeyed. |
+ * case the generic family will be obeyed. If the face is not available on |
+ * the system, the browser will attempt to do font fallback or pick a default |
+ * font. |
*/ |
struct PP_Var face; |
/** |
- * When face is an undefined var, this specifies the generic font family type |
- * to use. If the face is specified, this will be ignored. |
+ * When Create()ing a font and the face is an undefined var, the family |
+ * specifies the generic font family type to use. If the face is specified, |
+ * this will be ignored. |
+ * |
+ * When Describe()ing a font, the family will be the value you passed in when |
+ * the font was created. In other words, if you specify a face name, the |
+ * family will not be updated to reflect whether the font name you requested |
+ * is serif or sans serif. |
*/ |
PP_FontFamily_Dev family; |
/** |
* Size in pixels. |
+ * |
+ * You can specify 0 to get the default font size. The default font size |
+ * may vary depending on the requested font. The typical example is that |
+ * the the user may have a different font size for the default monospace font |
yzshen1
2011/05/25 23:40:11
Please remove one 'the' at the beginning.
|
+ * to give it a similar optical size to the proportionally spaced fonts. |
*/ |
uint32_t size; |