README

   1 GDash
   2 -----
   3 An Emerald Mine-like game for GTK+.
   4 Use the cursor keys and Ctrl to move.
   5
   6
   7 Compiling
   8 ---------
   9 Compiling the game goes the usual way. After uncompressing, you can
  10 use the 'configure' script to detect libraries and create makefiles,
  11 then use 'make' and maybe 'make install', if needed:
  12
  13         ./configure [parameters]
  14         make
  15         make install
  16
  17 The game uses the glib library. For compiling, headers and development
  18 libraries are also needed from the glib package.
  19 The program comes in two versions, the GTK+-based 'gdash', which has
  20 a cave editor, too. The other one is the SDL-based 'sdash', which is
  21 very similar to the original C64 game, and has joystick support, and
  22 a very nice fullscreen support.
  23 Sound support can also be enabled, if SDL is available. (It is enabled
  24 by default.)
  25 The switches to control the libraries are:
  26
  27         --with-gtk and --without-gtk, to compile or to skip the menu-driven
  28         gdash version.
  29
  30         --with-sdl and --without-sdl, to control the build of the sdl
  31         version.
  32
  33         --enable-sound and --disable-sound, to use sounds or not. For sounds,
  34         SDL is needed, so --enable-sound --without-sdl is an invalid
  35         combination.
  36
  37 For example, if you do not have GTK+, and plan to build only the C64-like
  38 sdash, you can use:
  39
  40         ./configure --without-gtk
  41         make
  42
  43 Remember that glib is needed in either case. Also, some icons and
  44 pictures are inlined in the executables. The include/ directory comes
  45 with these .h files readily generated, but if you change one of the .png
  46 files, the gdk-pixbuf-csource application is needed to regenerate them,
  47 which is part of the GTK+ development package.
  48
  49 To build the Windows installer, you can use MinGW and the Msys environment.
  50 Type 'make gdash.nsi' in the shell, and open the resulting 'gdash.nsi' file
  51 in NSIS.
  52
  53
  54
  55 util/any2gdash
  56 --------------
  57 You can use the any2gdash tool to convert caves found in snapshot files.
  58 This tool extracts information, and creates a binary file,
  59 which is similar to the internal format of an engine found in the snapshot.
  60
  61 Currently it loads BD1, BD2, PLCK, 1stB and CrLi snapshots.
  62 Using these internal formats is important for now, as the GDash
  63 engine is not completed yet. A later version can interpret some bytes
  64 from the file, which some older one did not; yet it is not necessary to
  65 import a game again for this.
  66 Also these internal formats are subject to change, as I'm going on with
  67 development, so converting all your games is somewhat discouraged for now.
  68 In turn, conversions are very useful to test the engine and compatibility.
  69 So treat the converted games as a way to test GDash and help me with
  70 describing any problem you may find.
  71
  72
  73 Send e-mail to: cirix <cirix@fw.hu>
  74