85 lines
4.3 KiB
XML
85 lines
4.3 KiB
XML
<?xml version="1.0" encoding="utf-8"?>
|
|
<!--
|
|
Vendor-provided fallback fonts
|
|
|
|
This file can be edited to add references to fonts that are not installed or referenced in the
|
|
default system. The file should then be placed in /vendor/etc/fallback_fonts.xml. Note
|
|
that in your makefile, this directory should be referenced as $(TARGET_COPY_OUT_VENDOR)/etc/:
|
|
|
|
PRODUCT_COPY_FILES += \
|
|
frameworks/base/data/fonts/vendor_fonts.xml:$(TARGET_COPY_OUT_VENDOR)/etc/fallback_fonts.xml \
|
|
frameworks/base/data/fonts/vendor_fonts-ja.xml:$(TARGET_COPY_OUT_VENDOR)/etc/fallback_fonts-ja.xml
|
|
|
|
For example, vendors might want to build configurations for locales that are
|
|
better served by fonts which either handle glyphs not supported in the default fonts or which
|
|
handle these glyphs differently than the default fallback fonts.
|
|
Each entry in this list is a "family", which consists of a list of "files"
|
|
(the filenames for that family). The files objects are
|
|
provided in the order of the styles supported for that family: regular, bold, italic, and
|
|
bold-italic. Only providing one font means that all styles will be rendered with that font.
|
|
Providing two means that these two fonts will render regular and bold fonts (italics will
|
|
be mapped to these two fonts).
|
|
|
|
There is also an optional "order" attribute on the Family tag. This specifies the index at
|
|
which that family of fonts should be inserted in the fallback font list, where the
|
|
default fallback fonts on the system (in /system/etc/fallback_fonts.xml) start at index 0.
|
|
If no 'order' attribute is supplied, that family will be inserted either at the end of the
|
|
current fallback list (if no order was supplied for any previous family in this file) or
|
|
after the previous family (if there was an order specified previously). Typically, vendors
|
|
may want to supply an order for the first family that puts this set of fonts at the appropriate
|
|
place in the overall fallback fonts. The order of this list determines which fallback font
|
|
will be used to support any glyphs that are not handled by the default system fonts.
|
|
|
|
Han languages (Chinese, Japanese, and Korean) share a common range of unicode characters;
|
|
their ordering in the fallback or vendor files gives priority to the first in the list.
|
|
Locale-specific ordering can be configured by adding language and region codes to the end
|
|
of the filename (e.g. /vendor/etc/fallback_fonts-ja.xml). When no region code is used,
|
|
as with this example, all regions are matched. Use separate files for each supported locale.
|
|
The standard fallback file (fallback_fonts.xml) is used when a locale does not have its own
|
|
file. All fallback files must contain the same complete set of fonts; only their ordering
|
|
can differ. For example, on a device supporting Japanese, but with English as the default,
|
|
/vendor/etc/fallback_fonts.xml might contain:
|
|
|
|
<familyset>
|
|
<family>
|
|
<fileset>
|
|
<file>DroidSansJapanese.ttf</file>
|
|
</fileset>
|
|
</family>
|
|
</familyset>
|
|
|
|
placing the Japanese font at the end of the fallback sequence for English, with a corresponding
|
|
/system/vendor/etc/fallback_fonts-ja.xml, placing it at the front of the list.
|
|
|
|
<familyset>
|
|
<family order="0">
|
|
<fileset>
|
|
<file>DroidSansJapanese.ttf</file>
|
|
</fileset>
|
|
</family>
|
|
</familyset>
|
|
|
|
The sample configuration below is an example of how one might provide two families of fonts
|
|
that get inserted at the first and second (0 and 1) position in the overall fallback fonts.
|
|
|
|
See /system/etc/system_fonts.xml and /system/etc/fallback_fonts.xml for more information
|
|
and to understand the order in which the default system fonts are loaded and structured for
|
|
lookup.
|
|
-->
|
|
|
|
<!-- Sample fallback font additions to the default fallback list. These fonts will be added
|
|
to the top two positions of the fallback list, since the first has an order of 0. -->
|
|
<!--
|
|
<familyset>
|
|
<family order="0">
|
|
<fileset>
|
|
<file>MyFont.ttf</file>
|
|
</fileset>
|
|
</family>
|
|
<family>
|
|
<fileset>
|
|
<file>MyOtherFont.ttf</file>
|
|
</fileset>
|
|
</family>
|
|
</familyset>
|
|
--> |