taBBall/compiling

TracNav

/zoss/taBBall? Compiling Instructions

This is currently the instructions on compiling and building on Windows only. If you're interested in building on other platforms, please ask about it in IRC or on the  forums.

Getting the Source

If you've downloaded and installed the source distribution then the source should be located at 

{installdir}\Zen\examples\taBBall

If you're a ZOSS contributor, the best way to get the source code is to get it from Subversion.

If you have the bleeding edge trunk for the rest of ZOSS then probably you already have taBBall, but it's located at: 

svn://www.indiezen.org/zoss/examples/trunk/taBBall

Compiling

If you downloaded the source and binary distribution, you already have everything you need. If you want to recompile everything then you'll also need to download and compile everything listed below in the Dependencies section.

No matter which way you've gone, you will need to download and install Boost and set up your configuration? appropriately for your system.

Once you have the dependencies compiled, it's only a matter of opening the taBBall.sln and compiling everything in the solution. Note: Only DEBUG|Win32 builds are currently supported.

If something goes wrong, visit the  forms or IRC.

Once you have it compiling, you're going to have to set up the taBBall configuration so that you can execute it either through the use of a batch file, or through the debugger.

IMPORTANT NOTE: Setting up the taBBall execution configuration files is different from setting up the main_env_vars? configuration. If you receive errors (especially related to missing DLL's) then you need to take a look at your taBBall execution configuration files and make sure they are correct.

Dependencies

Most of the time if you downloaded and installed the current binaries, you won't have to build any of these dependencies.

The main exception to this rule is if you want to make modifications to Zen Engine or the Base Starter Kit.

It's STRONGLY recommended that you do not modify any of the Zen Engine, the Base Starter Kit or any of the plugins without first discussing it on the  forums or discussing it in IRC? with one of the core developers. If you have something that needs to be modified to suit your needs, probably everyone would benefit and it would be best for everyone if you gave your modifications back to the community. Remember, it's not required, but also remember that you received this software for free and it would be nice of you to contribute something back.

Also, if the modifications end up not being beneficial, possibly one of the core team members will have a good suggestion on how you can accomplish your goals without making any modifications. There's a whole lot more to ZOSS than what's documented... we're working on improving the documentation, but until it's perfect, there is probably someone around that could provide some insight into the problem you're wanting to solve.

Don't hesitate asking questions on the forums or in IRC. The developers and community members are here to help.

To compile taBBall, simply open the taBBall.sln and build it.

Remember, this is a top level list, and each of these components have other dependencies. See the documentation for each of the individual plugins for more details.