ppsspp/ext/native/tools
2017-03-18 16:33:16 +01:00
..
atlastool Make it very slightly easier to build atlastool on Windows. Still not exactly convenient. 2017-03-18 16:33:16 +01:00
zimtool Make it very slightly easier to build atlastool on Windows. Still not exactly convenient. 2017-03-18 16:33:16 +01:00
.gitignore Make it very slightly easier to build atlastool on Windows. Still not exactly convenient. 2017-03-18 16:33:16 +01:00
.project Merge remote repo native into ext/native/. 2015-09-06 12:24:17 -07:00
atlastool.cpp Minor script updates 2017-03-18 16:33:16 +01:00
audiotool.cpp Merge remote repo native into ext/native/. 2015-09-06 12:24:17 -07:00
b.sh Merge remote repo native into ext/native/. 2015-09-06 12:24:17 -07:00
CMakeLists.txt Fix atlas/zimtool build. 2015-09-21 12:46:42 -03:00
kanjifilter.h Merge remote repo native into ext/native/. 2015-09-06 12:24:17 -07:00
README.txt Merge remote repo native into ext/native/. 2015-09-06 12:24:17 -07:00
tools.sln Make it very slightly easier to build atlastool on Windows. Still not exactly convenient. 2017-03-18 16:33:16 +01:00
zimtool.cpp Merge remote repo native into ext/native/. 2015-09-06 12:24:17 -07:00

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