Inductor Hierarchical Task Network Engine
This lightweight Hierarchical Task Network engine was first used in production in an iPhone strategy game called Exospecies. Visit the Exospecies Blog for more details. It is designed to be small, memory constrained, and used as an implementation detail of an app. It used the classic SHOP Planner as inspiration and largely followed that model.
Use and enjoy!
indhtn is designed to be built with CMake like this:
- Install CMake on your machine
- Go to the root of the indprolog repository and create a build directory.
- Change to that directory.
unix and win:
- CMake can build different types of projects using "generators". Run
cmake -helpto get a list of generators on your system: unix and win:
- Pick the generator that will create the type of project you want and use the
-Goption to choose it. Here are the ones that have been tested: Mac make file:
cmake -G "Unix Makefiles" ../srcMac Xcode:
cmake -G "Xcode" ../srcWindows Visual Studio:
cmake -G "Visual Studio 16 2019" ../src
- Then actually do the build using this command which magically builds whatever you choose on the command line:
cmake --build ./5a. OR you can manually use the build system that got created by cmake: unix or mac make file:
makeMac Xcode: Open the IndProlog.xcodeproj file in the build directory using Xcode. Windows Visual Studio: Open the .sln file in the build directory using VS.
Running Tests to make sure the build worked
If you're using a command line generator of some sort, just run
runtests on the commandline in your operating system of choice.
In Xcode, after you build you should change the scheme to
runtests and then choose Product/Run. The output of the test will appear in the Output window.
Set the default project to runtests and hit F5. You'll get a console window with the results
99.99% of the code for the Htn is platform agnostic (or at least should be). It has been built and tested on Windows, Mac and iOS. The platform specific code is located in the iOS and Win directorys and is currently only a single function for debug logging.
/FXPlatform: Contains some general purpose code for tracing, asserts, strings, etc
/FXPlatform/Parser: The Inductor Parser code
/FXPlatform/iOS: Code specific to iOS and Mac
/FXPlatform/Win: Code specific to Windows
/FXPlatform/Prolog: The prolog compiler and runtime engine
/UnitTest++: The UnitTest++ framework used to write unit tests (https://github.com/unittest-cpp/unittest-cpp)
/Tests: Basic smoke tests used to make sure it compiled properly
Read GettingStarted.md for a tutorial on how to use InductorHTN.
Do what you like, with no warranties! Read License.md.