Add new entry point that supports fallback font selection based on language.

include/ports/SkTypeface_android.h

Index: include/ports/SkTypeface_android.h
diff --git a/include/ports/SkTypeface_android.h b/include/ports/SkTypeface_android.h
index 655670fb6b4625718c24f2df931cc7abba1cfc87..230d463c1dd8795f39cf76ed3e2716cb03c5bc31 100644
--- a/include/ports/SkTypeface_android.h
+++ b/include/ports/SkTypeface_android.h
@@ -17,11 +17,28 @@ class SkPaintOptionsAndroid;
 
 /**
  *  Get the family name of the font in the fallback font list containing
- *  the specified character. if no font is found, returns false.
+ *  the specified character using the system's default language.
+ *
+ *  @param uni  The unicode character to use for the lookup.
+ *  @param name The family name of the font file containing the unicode character
+ *              in the default language
+ *  @return     true if a font is found and false otherwise
  */
 SK_API bool SkGetFallbackFamilyNameForChar(SkUnichar uni, SkString* name);
 
 /**
+ *  Get the family name of the font in the fallback font list containing
+ *  the specified character taking into account the provided language.
+ *
+ *  @param uni  The unicode character to use for the lookup.
+ *  @param lang The BCP 47 language identifier for the preferred language
+ *  @param name The family name of the font file containing the unicode character
+ *              in the preferred language
+ *  @return     true if a font is found and false otherwise
+ */
+SK_API bool SkGetFallbackFamilyNameForChar(SkUnichar uni, const SkString& lang, SkString* name);

[reed1, 2013/09/17 15:33:48]

usually we just use const char lang[] for input strings : no reason really to
require a string-object just for input.

+
+/**
  *  For test only.
  *  Load font config from given xml files, instead of those from Android system.
  */