This is the README for Sail the Seas version 1.1.2. TODO Add a save (not save as) Add a "Last game" saved game HOW TO PLAY What? It's easy! :) KEYS You can press to return to the previous screen at almost any time, unless you're at the main menu, in which case quits. At the main menu , : Scroll through the saved games (if there are at least two) , : Scroll through the maps (if there are at least two) , R: Open (or resume) the selected saved game N: Create a new game -, : Delete the selected saved game +: Duplicate the selected saved game \, : Rename the selected saved game : Quit Use and to scroll through the maps (if there's more than one), and and to scroll through the saved files for the selected map. Press or R to open (resume) a saved game, or N to create a new one. Or press to delete the selected saved game. Press to exit. During the game : Access the menu : Save game (shortcut to the "Save game" button in the menu) Press to access the menu. Or press to save the game. Press to return to the main menu. Your game will be discarded, so you should save it first. Press F9 at any time to capture a screen shot. The screen shot will be saved as the next available file in ps/. For example, if there are no files in ps/, the printscreen will be 0000.bmp. If there's a 0000.bmp, it will be 0001.bmp, and so on. Once there are 0000.bmp all the way to 9999.bmp, you'll get an error: "Too many printscreens". You can rename some of them if that happens (which isn't likely!). SYSTEM REQUIREMENTS Under Windows, Sail the Seas requires SDL.DLL in the path. (It's included in sailseas.zip, so you don't have to worry about it.) If you already have SDL.DLL version 1.2.8.0 or newer installed, you can delete ./sdl.dll. Under Linux, Sail the Seas doesn't need anything special, except maybe full permissions in its install directory. FILES The directory structure for Sail the Seas should be as follows: data/ For images used in the game maps/ Holds the maps ps/ For printscreens sav/ Contains saved games src/ Source code You should have received the following files in sailseas.zip with this distribution: ./maps.dat List of all the installed maps ./readme.txt This readme file ./sailseas Linux executable ./sailseas.exe Windows executable ./sdl.dll SDL runtime library (for Windows) data/arrows.bmp A bitmap with the arrows you see at the main menu data/font.bmp The smaller font data/font2.bmp The larger font maps/_default.bg maps/_default.fg maps/_default.map maps/pallete.bmp 1x1 bitmap with the pallete required for .fg and .bg files src/custkeys.h src/dsfont.c src/dsfont.h src/graphics.c src/graphics.h src/includes.h src/main.c src/main.h src/menu.c src/menu.h src/mscreen.c src/mscreen.h ps/sample.bmp.gz sample.bmp compressed with GZIP If one or more of these are missing, you can get sailseas.zip from http://dwks.theprogrammingsite.com/myprogs/down/sailseas.zip, or an individual file from http://dwks.theprogrammingsite.com/myprogs/down/sailseas/file. There is an index at the Sail the Seas page at http://dwks.theprogrammingsite.com/myprogs/sailseas.htm. TROUBLESHOOTING Sail the Seas must be run in its install directory. Nearly all error messages are written to the log file ./sailseas.log, so if the console disappears or you can't see it, look at this file. Console message: "No prefs file, creating it" There is no prefs file, so Sail the Seas is creating the default one with default settings. Nothing to worry about. Console message: "Too many printscreens" There are 10,000 printscreens in ps/. Delete or rename some of them. Console message: "Error in map "*": can't open .fg/.bg file" The map you tried to use is missing its .fg or .bg file, or one of the files is invalid (ie, not a BMP). Try another map. Console message: Standard system error message This probably means that the editor used to open this file (readme.txt) can't be found. Open it yourself. Console message: "No maps dat file, creating it" There won't be any maps installed. See TROUBLESHOOTING->Console message: "There are no maps installed". Console message: "Can't make maps dat file" See TROUBLESHOOTING->Console message: "There are no maps installed". Console message: "No saved games file for *, creating it" This message just means that you haven't selected this map before (from the main menu). Nothing to worry about. Console message: "Can't make saved games file" If you use this map, Sail the Seas probably won't be able to save your games. Console message: "There are no maps installed" Sail the Seas doesn't have any maps to use. Try running (from Sail the Seas' install directory) [Windows] C>dir /b/on maps\*.map > maps.dat [Linux] $ cd maps $ ls -1 *.map > ../maps.dat $ cd .. [Linux with Perl installed] $ ls -1 maps/*.map | perl -ne 's|^.*/||;print;' > maps.dat [English] Generate a list of all the files that have an extension of .MAP in the maps subdirectory, and store the list in maps.dat. (You should also do this whenever you install a new map.) If the problem persists, then you really do have no maps installed, so get some. :) Console message: "Can't open data/*" The file specified doesn't exist, or it is the wrong format. Get it from the website or re-extract it from the ZIP archive. See also: FILES Console message: "Out of memory" There is not enough memory to run Sail the Seas. Quit some programs and try re-launching it. If that doesn't work, try rebooting. If that still doesn't work, you probably need to get some more memory (RAM). Console message: "Can't display *" Some weird error has occured -- Sail the Seas couldn't display an image. Try re-launching. Console message: "Fatal signal: Segmentation Fault (SDL Parachute Deployed)" This shouldn't happen. :) If it does, try re-launching or rebooting. ON THE INTERNET Visit DWK's home page at http://dwks.theprogrammingsite.com/, or the Sail the Seas page at http://dwks.theprogrammingsite.com/myprogs/sailseas.htm. The ZIP file is at http://dwks.theprogrammingsite.com/myprogs/down/sailseas.zip, in case you want to download it right away. :) The SDL is a cross-platform graphics library used in Sail the Seas. The SDL's home page is at http://www.libsdl.org/.