scummvm/tools/skycpt
David Turner a1e7761f6d TOOLS: Modified engine patch for use with skycpt and updated skycpt README
The Demo _does_ contain the Save/Load Panel resources, but not the required font #2.
Have updated the patch to allow use of font #0, so the process for the CD demo is now the
same as for the other versions of BASS.

svn-id: r53163
2010-10-12 14:39:27 +00:00
..
288diff.txt
AsciiCptCompile.cpp TOOLS : Fixes for skycpt use, particularly on case-sensitive OS 2010-09-29 02:57:11 +00:00
AsciiCptCompile.sln
AsciiCptCompile.vcproj TOOLS : Fixes for skycpt use, particularly on case-sensitive OS 2010-09-29 02:57:11 +00:00
COMPACT.TXT
cptcompiler.cpp TOOLS : Fixes for skycpt use, particularly on case-sensitive OS 2010-09-29 02:57:11 +00:00
cpthelp.cpp Tools - Use standard header 2010-01-23 15:00:11 +00:00
cpthelp.h Tools - Use standard header 2010-01-23 15:00:11 +00:00
idFinder.cpp Tools - Use standard header 2010-01-23 15:00:11 +00:00
KmpSearch.cpp Tools - Use standard header 2010-01-23 15:00:11 +00:00
KmpSearch.h ALL: Fixup some #define names 2010-09-28 20:30:50 +00:00
module.mk Added the svn:keywords property to some files missing it. 2010-02-27 17:02:58 +00:00
README TOOLS: Modified engine patch for use with skycpt and updated skycpt README 2010-10-12 14:39:27 +00:00
savedata.txt
skycpt-engine.patch TOOLS: Modified engine patch for use with skycpt and updated skycpt README 2010-10-12 14:39:27 +00:00
stdafx.cpp Tools - Replace some more headers by standard headers 2010-01-23 15:27:47 +00:00
stdafx.h ALL: Fixup some #define names 2010-09-28 20:30:50 +00:00
TextFile.cpp TOOLS : Fixes for skycpt use, particularly on case-sensitive OS 2010-09-29 02:57:11 +00:00
TextFile.h ALL: Fixup some #define names 2010-09-28 20:30:50 +00:00

Since V.0.8.0 ScummVM requires the SKY.CPT file for running Beneath a Steel Sky.
This file contains data that was originally included in the SKY.EXE and was also included
in the ScummVM executable before 0.8.0.
Including all this data in the executable has the disadvantage that it wastes memory.
Even when playing a completely different game (like, e.g. Day of the Tentacle) ScummVM would
have the Beneath a Steel Sky data lying around in memory. This doesn't make much of a difference
on a 1GB RAM windows system, but for platforms like PALM and PocketPC it's a real problem,
so this data was moved into the SKY.CPT file and is loaded at runtime when BASS is started.

This program creates the SKY.CPT file.

If you want to create your own file, *PLEASE* simply forget about it.
It's a long and annoying procedure and won't help you with anything.
This program was only included in ScummVM's source tree because the Debian license
forces us to.
Instead download the file from http://www.scummvm.org/
Also, please be aware that if you create your own CPT file (if it isn't exactly the same as the
one we offer for download at www.scummvm.org), it will be incompatible and the savegames produced
using the file will be incompatible with ScummVM using the normal CPT file.
The incompatibility will not be detected by ScummVM, it will most probably simply crash.

If you still want to waste your time by creating this file:
1) compile the tool
2) run it once, it'll complain that it's missing 7 files, the RESET.* files but
	it creates an incomplete COMPACT.DBG file anyways, which you rename to SKY.CPT.
3) download the seven different Beneath a Steel Sky versions:
	v.0.00288: The first floppy version that was released
	v.0.00303: Another floppy version
	v.0.00331: Another floppy version
	v.0.00348: Another floppy version
	v.0.00365: CD Demo
	v.0.00368: Full CD version
	v.0.00372: Final CD version
4) Apply the supplied skycpt-engine.patch to a clean copy of the ScummVM
   codebase. This modifies the sky engine to allow savefiles to be generated
   containing the required data for the skycpt tool.
5) Compile the patched ScummVM.
6) Start each of the BASS versions with this patched version, enjoy the intro
   over and over again.
	Afterwards, it'll automatically show the load/save dialog where you save the game.
7) Rename the Savegame files you created (SKY-VM.000 etc., not the ASD or SAV
   file) to "RESET.*", depending on the version.
	e.g. RESET.288 for v.0.00288
8) Rename each file with a ".gz" suffix and run gunzip on it.
   This removes the ScummVM gzip savefile compression.
   Failing to do this will cause skycpt to abort at a filesize assert
   when reading the "RESET.*" files.
9) Copy the files into the skycpt tool directory, execute the tool again.
	It'll create a new COMPACT.DBG.
10) Rename this file to SKY.CPT.
11) DELETE IT BECAUSE IT'S PROBABLY BROKEN, NOT WORTH BOTHERING WITH ANYWAYS
	AND DOWNLOAD THE SKY.CPT FILE FROM THE URL ABOVE!!

Oh, I almost forgot.
The program only works on little endian systems and probably isn't alignment safe either.
It may also leak memory or accidentially reformat your harddisk. Who knows.
You've been warned.