README.TXT for newmap 1.beta1 Copyright (C) 2000, James Dustin Reichwein, All Rights Reserved. Contents The History of newmap File List Command Line Arguments Examples Reporting Bugs Working with the Source Code The History of newmap On the Apolyton forums, I'd learned that large maps, up to 32767 in area, could be created for Multiplayer Gold Edition and Test Of Time. I wanted to try this out, but I couldn't get it to work. I had already written MapCopy, which had all the functionality needed for creation of map files. So I quickly pounded out newmap. Newmap creates new, ocean filled, Civ2 .MP files. It will creates files up to 65537 squares in area, although I know of no game or map editor that will load such a map. This software is open source Freeware. The source code is released under the Mozilla Public License (MPL), and is included in this archive. This archive may also be distributed electronically. If you choose to place this archive on a web or FTP server, I would appreciate being notified so that I can notify you of new versions. This software is BETA quality. I have tested it as much as I can, but there are probably still problems with this software. If you encounter bugs, please let me know and give me the information in the "Reporting Bugs" section included in this document. I would also appreciate hearing if you've used this utility successfully, so I can now how widely it is being used, and whether it is mature enought for a 1.0 release (In actuality, version 1.0 will wait until MapCopy 1.0, since they share so much code). The most recent version of newmap can be found at: http://home.san.rr.com/dustyr/download/newmap.zip The most recent version of MapCopy, a utility for copying between .MPs and .SAVs, can be found at: http://home.san.rr.com/dustyr/download/mapcopy.zip For additional information on the contents of saved game file, I recommend Allard Höfelt's document at http://allard.8m.com/hexediting.htm. Without that document this utility would never have happened. The author of newmap can be contacted at jreichwe@san.rr.com File List This archive contains the following files: newmap.exe The executable. README.TXT This text file. LICENSE.TXT The MPL. src\ Source files newmap.cpp civ2sav.h civ2sav.cpp DustyUtil.h DustyUtil.cpp Command Line Syntax. newmap width height filename Arguments width The width of the map. Note that if you open the file with a hex editor, the width there is this value * 2. height The height of the map. filename The name of the file to create. The map can be no larger than 65535 squares in area. MGE and TOT can support maps up to 32767 squares. Earlier versions can support up to 10922 squares.", This utility will overwrite existing files. Examples: newmap 5 13107 theFile.mp Creates the largest possible map newmap supports. It will be named theFile.mp. newmap 7 4681 thefile.mp Creates the largest possible map that MGE and TOT support. newmap 143 229 theFile.mp Creates the largest possible map for MGE and TOT with the 1.6 height/width ratio that standard large maps have. Bug Reporting. This is BETA quality software. To iron out any wrinkles that are left in it, I need feedback from users. If you encounter a bug, please e-mail me at jreichwe@san.rr.com, with the following informaiton. * Describe the problem.Is it a bug, a mistake in the documentation, a feature you wish newmap had, or something else? * The version of newmap (This document is for version 1.beta1). * Indicate which version of Civ 2 you are working with (MGE, or FW). * A description of how to reproduce the problem. If possible include any .MP or .SAV files that are causing problems. * Any other information you think is useful. Working with the Source Code Newmap is open source software. This means that the source code for newmap is included in this distribution. You can compile newmap for yourself, or use, modify, or distribute its source code as stated by the Mozilla Public License (see LICENSE.TXT). You may use the Civ2Sav.cpp or DustyUtil.cpp files for you own projects, as stated in the MPL. If you do so, keep in mine that this code is still in its early phases, and that I may drastically change it as needed. On the other hand, if you make an improvement to any of the newmap source code, I would appreciate it if you would send the new code to me, so I could incorporate it into future versions. Building newmap Newmap is written to be fully ANSI C++ compliant. Unfortunately, it is hard to find fully ANSI C++ compliant compilers. The compiler I used is the free Borland C++ 5.5 compiler, available at http://www.borland.com/bcppbuilder/freecompiler/. This compiler has a bug in its fstream library, in the fstream.cc file. I was able to fix this bug, but the code is copyrighted so that I cannot redistribute it. As a result, I have not enclosed a Makefile. You may find that another C++ compiler may compile newmap without problems. Be alert for compatibilities with the STL or string class. If you wish to compile newmap using the Borland C++ 5.5 compiler, e-mail me at jreichwe@san.rr.com and I will send you the changes I made to fstream.cc. Good Luck, and I hope you find this software useful!