README.txt

字库系统结构:
........................
1. PPSSPP系统菜单  (ui_atlas) 
2. ui_atlas_lowmem (<-新版已经不再需要)
3. 游戏存档等文字 (ppge_atlas)

关于字体的筛选和设置分别参见他们的script文件。
chinese.txt作为学习文件供程序默认读取。

游戏存档菜单ppge_atlas
需要文件分别是: 
ui_atlas.zim 到 assets\ 和 android\assets\
ppge_atlas.cpp 和 ppge_atlas.h 到 Core\Util\

模拟器界面菜单ui_atlas

字库制作:
.................
(Windows) 运行脚本 buildfont.bat可以构建字库
(Linux/IOS/MACOSX) 使用 build-ppge 和 build-ui

(Windows) 运行copy2proj.bat 将所需文件复制到ppsspp工程项目中
(Linux/IOS/MACOSX) 上使用 mvppge2proj 和 mvui2proj

PS: 如需设置自定义字体文件名ppge_atlas.zim, 可以修改Core\Util\PPGeDraw.cpp 和 Core\Util\ppge_atlas.cpp

字库工具说明:
.........................
These are simple tools to create the ZIM texture format and texture atlases based on it.

atlastool <configuration_file> <filename_prefix> <format> 

<configuration_file> path to the configuration file for the atlas to be generated
		     description of the format is below

<filename_prefix> the prefix of the output files, the output files will be:
		  <filename_prefix>_atlas.zim
		  <filename_prefix>_atlas.cpp
		  <filename_prefix>_atlas.h

<format> texture format of the atlas, can be:
		8888 - RGBA8
		etc1 - ETC1 compressed
		<none> - uses RGBA4444

Basic configuration file format look like this:

	<size>
	font <fontname> <fontpath> <glyphregions> <height> [<vertical offset>]
	image <symbolname> <imagepath> <action>

All the blocks enclosed with "<" ">" need to be replaced with the respective options, for
example one line in one of out configuration files is:

	font UBUNTU24 C:/Windows/Fonts/KozGoPro-Medium.otf UWkhcsGR 24

<size> 	size is the horizontal size of the atlas, should be a power of 2, the vertical size is
	automatically adjusted to be smallest power of 2 that can fit the whole atlas.

<fontname> the name of the font in the generated *.h and *.cpp files

<fontpath> path to the font, can use *.otf and *.ttf fonts

<glyphregions> defines which glyphs should be copied into the atlas, can use any combination
	       of the following:
		U - US ASCII
		W - Latin-1 extras 1
		E - Latin-1 Extended A (needed for Hungarian etc)
		e - Latin-1 Extended B (for some African and latinized asian languages?)
		k - Katakana
		h - Hiragana
		s - ShiftJIS symbols
		H - Hebrew
		G - Greek
		R - Russian
		c - All Kanji, filtered though!
		T - Thai
		K - Korean (hangul)

<height> height in pixels of the glyphs in the font atlas

<vertical offset> ??? no idea

<symbolname> name of this symbol in the generated *.h and *.cpp files

<imagepath> path to the image file that is going to be used

<action> can be any of:
		copy - copies the image as-is
		r2a  - red2alpha, red channel to alpha, color is a solid while
		r2i  - red to intensity, full alpha
		pre  - premultiply alpha
		p2a  - pink (255,0,255) to alpha