Differences

This shows you the differences between two versions of the page.

--- proton:rtpack [2010/12/28 05:27] – created seth
+++ proton:rtpack [2012/12/02 12:24] (current) – seth
@@ Line 1: / Line 1: @@
-=== RTPack.exe source code ===
+==== RTPack source code ====
-It's located in tools/rtpack.
+RTPack is a general purpose utility that does several useful things from the command line.  The .exe version is used from .bat files in windows, and on linux .. well, it doesn't have an .exe and it used from shell scripts or something.
+What's it do?
+  * Converts most image formats to .rttex.  (.rttex is Proton's custom image format, it can do things like use png or jpg compression internally, remember the pre-tweaked widths/heights, stuff like that.
+  * Can create fonts
+  * Can compress any file (Proton will detect and decompress compressed files)
+  * Other bad ass stuff.  Or not, I can't remember
+It's located in tools/RTPack.
+=== Windows ===
 It's a MSVC project that requires Clanlib 1.X and the PowerVR libraries (for .pvrtc texture creation) to compiles.
@@ Line 8: / Line 19: @@
 Note:  Unless you really need to tweak something you never really need to compile this as  the .exe version is included.
+=== Linux ===
+First of you'll need to have a couple of dependencies installed and/or available.
+You need to get PVRTexLib from Imagination (it's a free download but requires registration). Extract the contents of the package under ''tools/RTPack'' preserving paths - you should get a subdirectory called ''PVRTexLib'' there.
+**NOTE:** RTPack currently supports only the 3.x versions of PVRTexLib. The newest version available from Imagination however is on the 4.x series which is API incompatible with the 3.x versions. Either you need to find a 3.x version of PVRTexLib or port the RTPack code to work with the 4.x versions. (Some very old 3.x series version for 32-bit Linux can be found from here https://netst.org/pub/linux/ARM/OMAP/TI/Graphics_SDK_4_03_00_02/GFX_Linux_SDK/OVG/SDKPackage/Utilities/PVRTexLib/ )
+You also need ClanLib version 1 development packages. On Fedora the package is called ClanLib1-devel. On other distributions it might be called something else...
+Next run the ''build.sh'' script in the ''tools/RTPack'' directory. You should get a binary called ''RTPack'' into a subdirectory called ''build''.
+If something got wrong, hopefully you got an error message that explains the situation. In any case, if you are stuck feel free to ask on the [[http://www.rtsoft.com/forums/forumdisplay.php?27-Proton-SDK-General-Discussion|forums]].
+The lazy alternative is to use wine RTPack.exe <cmd line options>.
+=== Others ===
 Want to help by compiling an OSX version?  Add it here!