History

Tianjie 6450acf032 Add doc for image_generator Bug: 143630837 Test: check preview Change-Id: I3b7ca52e2a13685a523901092df79b039e2ad96c		2020-12-20 20:00:30 -08:00
..
Android.bp	Use icu4j instead of its deprecated legacy alias icu4j-host	2019-06-03 16:14:35 +01:00
ImageGenerator.java	New priority scripts + critical updates to fonts.	2020-02-28 14:33:58 +00:00
ImageGenerator.mf	Use a host java program to generate the background text	2018-10-12 15:46:32 -07:00
README.md	Add doc for image_generator	2020-12-20 20:00:30 -08:00

README.md

Recovery Image Generator

This program uses java.awt.Graphics2D to generate the background text files used under recovery mode. And thus we don't need to do the manual work by running emulators with different dpi.

Usage:

java -jar path_to_jar --image_width imageWidth --text_name textName --font_dir fontDirectory --resource_dir resourceDirectory --output_file outputFilename

Description of the parameters:

imageWidth: The number of pixels per line; and the text strings will be wrapped accordingly.
textName: The description of the text string, e.g. "recovery_erasing", "recovery_installing_security"
fontDirectory: The directory that contains all the support .ttf | .ttc files, e.g. $OUT/system/fonts/
resourceDirectory: The resource directory that contains all the translated strings in xml format, e.g. bootable/recovery/tools/recovery_l10n/res/
outputFilename: Path to the generated image.

Locales

Supported locales and background texts are located in tools/recovery_l10n/res/. For each background text, the tool renders a localized image for every supported locale.

Each individual localized image contains an encoded locale header string, and the rendered background text. The locale header string is generated by Locale.forLanguageTag. And sample result include en-US, zh-CN, etc. These individual images are then concatenated together to form the final resource image that locates in res/images, e.g. install_text.png