Panda3D Module Builder

This is a prefab to create modules and extensions for the Panda3D engine. It provides a cmake script to make building and distributing your modules the matter of a single command / mouseclick.

Requirements

The Panda3D SDK (get it here)
CMake 2.6 or higher (get it here)

For compiling on Windows 32 bit:

Visual Studio 2010 (any version)

For compiling on Windows 64 bit:

Visual Studio 2010 (any version)
Windows SDK 7.1 (be sure to tick the VC++ 64 bit compilers)

Notice: If you want to use a different version of Visual Studio, you first need to make a Panda3D build compiled with that version (otherwise your module won't work, or crash randomly). After you did that, you can adjust the config.ini file with your desired Visual Studio version. You can get a list of supported version strings with cmake --help. Notice that you don't have to specify [arch] after the Generator name, the script automatically does that, depending on your panda build architecture.

Usage

Copy the contents of this repository to a suitable path in your project
Move your C++ Code to the Source/ directory.
To compile your module, use:
```
python build.py
```

This will ask you for a module name the first time you run it. After that, it will generate a binary with the name <module-name>.pyd or <module-name>.so (depending on your platform) in the directory of the build script.

You can then simply import the module in python, like this:

# Import panda3d core to append its binaries to the path, otherwise you might
# get missing DLL errors
from panda3d.core import *
from insert_module_name_here import ExampleClass
test_class = ExampleClass()

There is also a small example class contained in the source directory, which shows the basics of using interrogate.

Further configuration

Please cleanup your built directories after changing the configuration! You can do so with passing --clean in the command line.

Command Line

Command line options are:

--optimize=N to override the optimize option. This overrides any option set in the config.ini
--clean to force a clean rebuild

config.ini

Further adjustments can be made in the config.ini file:

You can set generate_pdb to 0 or 1 to control whether a .PDB file is generated.
You can set vc_version to change the Visual Studio Version. See above!
You can set optimize to change the optimization. This should match the --optimize= option of your Panda3D Build.
You can set use_lib_eigen to 1 to require the Eigen 3 library
You can set use_lib_bullet to 1 to require the Bullet library
You can set use_lib_freetype to 1 to require the Freetype library
You can set verbose_igate to 1 or 2 to get detailed interrogate output