Princed Resources is a tool to access and modify Prince of Persia DAT files (version 1 and 2).
Please read this readme file thoroughly before using Princed Resource Editor.
- Compilation instructions
- Supported data formats
- Check the FAQ for help
- Shell usage examples
- Project home page
- Ask for assistance
- Report a bug
- Feature request
Run the program without parameters to get the usage help.
Syntax samples:
C:\PRINCED\PR> pr -eext DAT\vdungeon.dat
The above win32 example will export the bitmaps and palettes stored in C:\princed\pr\DAT\vdungeon.dat into the c:\princed\pr\ext folder.
C:\PRINCE> pr -e vdungeon.dat
This will export all the bitmaps and palettes stored in c:\prince\vdungeon.dat into the folder c:\prince.
C:\PRINCED\PR> pr -iext compiled\vdungeon.dat
This will import the bitmaps and palettes that are in c:\princed\pr\ext and associated to vdungeon.dat in the resource file and generate the file c:\princed\pr\compiled\vdungeon.dat.
C:\PRINCED\PR> pr -eext compiled\vpalace.dat@161
This will export the resource number 161 to the directory according to resources.xml (c:\princed\pr\ext\prince\sword\in the floor\bright.bmp).
./pr -eext FP/prince.dat@162:pop1 -f -v
This UNIX example will export the resource 162 from the index "pop1" forcing overwrite and being verbose.
./pr -eimages 'FP/prince.dat@prince/sword/*.bmp'
This is to export all bitmaps from prince/sword directory to the images/prince/sword directory. Note: the quotation marks '' are only to avoid wildcard expansions and won't be needed in win32 consoles.
./pr -efpdats FP
Exports all DAT files in FP to fpdats directory.
./pr -efpdats FP -r
The same, but looking into sub-directories.
./pr -e FP/v*.DAT
Exports to the current folder all DAT files in FP whose name starts with v. Note: Only works in shells with wildcard expansion support.
./pr -eimg FP/prince.dat FP/pv.dat
Exports to img the content of both files prince.dat and pv.dat located at the folder FP.
./pr -iimg FP/prince.dat@161
Imports back to (updates) FP/prince.dat only the resource 161 located in the directory img.
./pr -z7 -iimg 'FP/prince.dat@/prince/sword/*.bmp'
Updates the current bmp resources in img/prince/sword into the DAT file FP/prince.dat using compression level 7 (slow but very effective).
./pr -ximages 'FP/vdungeon.dat@/vdungeon/chopper/frame*.bmp,/vdungeon/spikes/frame01.bmp,1310'
Exports to images folder the resources matching with vdungeon/chopper/frame*.bmp, the resource vdungeon/spikes/frame01.bmp and the resource number 1310.
./pr -xpop2 pop2/bird.dat@/bird/long_jump/frame06.bmp,751:shape -v -f
Exports the file bird/long_jump/frame06.bmp and the resource 751 indexed in "shap" from pop2/bird.dat to the pop2 folder.
./pr --xml-optimize=test/resources.xml
Optimizes the file test/resources.xml performing the following tasks:
- add doctype declaration
- indent tags and arrange line separation
- reduce file size deleting inheritable attributes
- remove comments
The following command
./pr --unknown prince2
Reads all DAT information from the prince2 directory and then creates the file unknown/unknown.xml and fills it with the items that were not inside the resources.xml file.
Approximately 25Mb in RAM are required for a normal full directory task
Recommended:
AMD K6-II at 350Mhz or higher
32 Mb RAM
Benchmark results:
Performed on an AMD Athlon(tm) XP 2000+ with 1667.022 MHz
The file tested was the original vdungeon.dat, sized 14220 bytes
Normal benchmark results:
Compression level 1. Size 38031 bytes. Time 0.028137 seconds.
Compression level 2. Size 23756 bytes. Time 0.031273 seconds.
Compression level 3. Size 15912 bytes. Time 0.031836 seconds.
Compression level 4. Size 12519 bytes. Time 0.066246 seconds.
Compression level 5. Size 11347 bytes. Time 0.087975 seconds.
Compression level 6. Size 11218 bytes. Time 1.506183 seconds.
Compression level 7. Size 10932 bytes. Time 2.916612 seconds.
All known bugs were solved. If you find a bug (program crashes, corrupted resources, typos, etc), it's very probable that we haven't found it. So please report it. To report bugs just post them in http://sourceforge.net/tracker/?func=add&group_id=91915&atid=598845
(c) Copyright 2003 - 2006 - Princed Development Team
http://www.princed.org
This program is open source under the GNU General Public License terms
Coding & main routines
Enrique Calot
Coding Assistant
Santiago Benito-Zamora
Graphic compression algorithms
Tammo Jan Dijkema
Enrique Calot
Diego Essaya
Graphic format development
Tammo Jan Dijkema
Anke Balderer
MID Sound format development
Christian Lundheim
Resources.xml edition
Steven Fayers
Piotr Kochanek
Type pr --version to see translation credits for an specific language PR is also using some GPL compatible and GPL components made by Kevlin Henney (dirent structure port for windows) and the Free Software Foundation, Inc. (getopt parsing functions ports).
Special thanks to
- The authors of Valgrind and GDB for the great debugging features
- The authors of GCC and LCC for making excellent free compilers
- SourceForge.net for the home page hosting and the development environment provided
- Lugfi for all the support
Please enjoy using Princed Resource Editor!