develop
Petr Mrázek 2009-09-14 20:02:16 +00:00
parent fac88478bd
commit c5144b5fde
2 changed files with 54 additions and 19 deletions

@ -3,30 +3,54 @@ Introduction
DFHack is a Dwarf Fortress memory access library and a set of basic tools using this library. DFHack is a Dwarf Fortress memory access library and a set of basic tools using this library.
The library is a work in progress, so things might change as more tools are written for it. The library is a work in progress, so things might change as more tools are written for it.
It is an attempt to unite the various ways tools access DF memory and allow for easier development
of new tools.
Getting DFHack Getting DFHack
---------------- ----------------
You can get the code or a release at DFHack's sourceforge site: You can get the code at DFHack's sourceforge site:
https://sourceforge.net/projects/dfhack/ https://sourceforge.net/projects/dfhack/
* subversion access: * subversion access:
svn co https://dfhack.svn.sourceforge.net/svnroot/dfhack/trunk dfhack svn co https://dfhack.svn.sourceforge.net/svnroot/dfhack/trunk dfhack
Compatibility
-------------
DFHack works on Windows XP, Vista, 7 or any modern Linux distribution.
Windows 2000 is currently *not supported* due to missing OS functionality. If you know how
to easily suspend processes, you can fix it :)
OSX is also not supported due to lack of developers with a Mac.
Currently supported Dwarf Fortress versions:
* Windows
40d
40d9 - 40d16
* Linux
40d9 - 40d16
Using the library Using the library
----------------- -----------------
The library should be compilable under Linux with GCC and under Windows with MinGW32 The library is compilable under Linux with GCC and under Windows with MinGW32 compiler.
compiler. It is using the cmake build system. See COMPILE for details. It is using the cmake build system. See COMPILE for details.
Main part of the API is in SimpleAPI.h DFHack is using the zlib/libpng license. This makes it easy to link to it, use it in-source
You might also have to include a few other files: or add your own extensions. Contributing back to the dfhack repository is welcome and the right
Types.h - defines many of the used data structures thing to do :)
TileTypes.h - functions for translating map tile type values to useful properties
(wall, flooer, etc.)
Memory offset definitions At the time of writing there's no API reference or documentation. The code does have a lot
------------------------- of comments though.
The file with memory offset definitions used by dfhack can be found in the output folder. Main part of the API is in SimpleAPI.h and should be easy to grasp.
TODO: write format explanation You might also have to include a few other files:
* DFTypes.h
defines many of the used data structures
* DFTileTypes.h
functions for translating map tile type values to useful properties (wall, flooer, etc.)
* DFMemAccess.h, together with at least ProcessManager.h
manual access to memory reading and writing functions.
Tools Tools
----- -----
@ -35,13 +59,27 @@ but they are meant mostly as examples for developers. Still, they can be useful
are cross-platform just like the library itself. are cross-platform just like the library itself.
* expbench - just exports the map 1000 times over. Meant to test how fast the * expbench - just exports the map 1000 times over. Meant to test how fast the
DFHack<->DF interface is. This should take 3-12 seconds. DFHack<->DF interface is. This can take 3-30+ seconds, depending on
your system and the size of the map.
* reveal - plain old reveal tool. Demonstrates writing map data back to DF. * reveal - plain old reveal tool. Demonstrates writing map data back to DF.
* prospector - scans the map for minerals. by default it only scans only visible veins. * prospector - scans the map for minerals. by default it only scans only visible veins.
You can make it show hidden things with '-a' and base rock and soil layers You can make it show hidden things with '-a' and base rock and soil layers
with '-b'. These can be combined ('-ab') with '-b'. These can be combined ('-ab')
* cleanmap - cleans mud, vomit, snow and all kinds of bloody mess from the map. It will * cleanmap - cleans mud, vomit, snow and all kinds of bloody mess from the map. It will
clean your irrigated farms too, so consider yourself warned. clean your irrigated farms too, so consider yourself warned.
Memory offset definitions
-------------------------
The file with memory offset definitions used by dfhack can be found in the output folder.
It uses XML as the base format.
It allows entry versioning and basing newer entries on older ones. These newer versions
only have to specify the values that are different or a single 'rebase' value that is then
used as an offset for all the addresses or object identifiers.
This makes it possible to track the small d## releases pretty quickly.
~ EOF ~

@ -28,9 +28,6 @@ distribution.
#include "DFMemInfo.h" #include "DFMemInfo.h"
/* TODO: Test these /* TODO: Test these
ReadVegetation
ReadConstruction
ReadBuilding
matgloss other than stone/soil matgloss other than stone/soil
*/ */