doc/porting

   1 PORTING
   2
   3 Updated: March 2005
   4
   5 In order to successfully port Metal Blob Solid to another platform you will need,
   6
   7 * SDL
   8 * SDL Image
   9 * SDL Mixer
  10 * SDL TTF
  11
  12 There are a few considerations when porting to other platforms,
  13
  14 - In the makefile you should remove the -DUNIX define if you are not running
  15   on a *nix system. If you don't it is likely you will only get compile time errors
  16   so you'll be reminded to remove it.
  17
  18 - Most non *nix systems do not have access to a function called strtok_r() which, to
  19   my knowledge, is a threaded version of the strtok() function. Since MBS makes some
  20   small use of this function I've had a try and replicate it. The replicated version
  21   is very half arsed and is only intended to work. Speed and efficiency aren't a
  22   concern here. If you get some grief about "flag tokens" to it is most likely to
  23   be related to this function. It can be found in CEngine.cpp
  24
  25 - On a similar note there is a define called IGNORE_FLAGTOKEN_ERRORS which can also
  26   be set to hopefully aid in the pharsing of the flag tokens whilst also ignoring
  27   any errors thrown. Consider adding to this the build script if you experience
  28   issues.
  29
  30 - To create the PAK file you can run "make buildpak" after running "make". This will
  31   be required if you are building the game from source on non *nix platforms (note that
  32   make install builds the pak file).
  33
  34 When you've successfully ported the game to another platform drop me an email and let me
  35 know. Please DO NOT email me the port without asking permission.
  36
  37 After having said all that, please report gameplay problems as well! Because of the
  38 nature of the game (a platform game with multiple objectives and the ability to
  39 return to previous missions), there are likely to be a few problems. Just let me know
  40 what the problem is, what level it is on and where abouts you encountered it.
  41
  42 Stephen Sweeney
  43 stephen.sweeney@parallelrealities.co.uk
  44 http://www.parallelrealities.co.uk
  45
  46 (NB: This email address does not accept HTML formatted messages. Plain text only)