ppsspp/ext/native/tools
2024-05-20 10:04:11 +02:00
..
atlastool Buildfix the old tools 2024-01-12 14:46:00 +01:00
prebuilt@cbea79dc8f Atlastool/zimtool: Make it easy to build these on Windows (prebuilt submodule) 2020-02-29 12:19:08 +01:00
zimtool Buildfix the old tools 2024-01-12 14:46:00 +01:00
.gitignore Fix atlas tool on linux 2021-09-17 15:13:35 +02:00
.project Merge remote repo native into ext/native/. 2015-09-06 12:24:17 -07:00
atlastool.cpp RetroAchievements: Better handling of not being online when trying to log in 2023-07-13 11:26:43 +02:00
b.sh Fix atlas tool on linux 2021-09-17 15:13:35 +02:00
CMakeLists.txt Bump a few minimum-cmake-version statements 2024-05-20 10:04:11 +02: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
zimtool.cpp Tools: Make ZimTool able to use ZSTD/specify level. 2021-05-16 09:39:39 -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