summaryrefslogtreecommitdiffstats
path: root/tools/image_generator/README.md
blob: 1230ad5101099cac56e9566bab5bad4dcef4f093 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
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:
1. `imageWidth`: The number of pixels per line; and the text strings will be
   wrapped accordingly.
2. `textName`: The description of the text string, e.g. "recovery_erasing",
   "recovery_installing_security"
3. `fontDirectory`: The directory that contains all the support .ttf | .ttc
   files, e.g. $OUT/system/fonts/
4. `resourceDirectory`: The resource directory that contains all the translated
   strings in xml format, e.g. bootable/recovery/tools/recovery_l10n/res/
5. `outputFilename`: Path to the generated image.

# Locales
Supported locales and background texts are located in
[tools/recovery_l10n/res/](../recovery_l10n/res/values). 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`