NAME

Alien::Box2D - Build and make available Box2D library - http://box2d.org/

VERSION

Version 0.102

SYNOPSIS

Alien::Box2D during its installation does one of the following:

• Builds ODE binaries from source codes and installs dev files (headers: *.h, static library: *.a) into share directory of Alien::Box2D distribution.

Later you can use Alien::Box2D in your module that needs to link with libode like this:

    # Sample Build.pl
    use Module::Build;
    use Alien::Box2D;

    my $build = Module::Build->new(
      module_name => 'Any::Box2D::Module',
      # + other params
      build_requires => {
                    'Alien::Box2D' => 0,
                    # + others modules
      },
      configure_requires => {
                    'Alien::Box2D' => 0,
                    # + others modules
      },
      extra_compiler_flags => Alien::Box2D->config('cflags'),
      extra_linker_flags   => Alien::Box2D->config('libs'),
    )->create_build_script;

NOTE: Alien::Box2D is required only for building not for using 'Any::Box2D::Module'.

DESCRIPTION

In short Alien::Box2D can be used to detect and get configuration settings from an already installed Box2D. It offers also an option to download Box2D source codes and build binaries from scratch.

METHODS

config()

This function is the main public interface to this module:

    Alien::Box2D->config('prefix');
    Alien::Box2D->config('version');
    Alien::Box2D->config('libs');
    Alien::Box2D->config('cflags');

BUGS

Please post issues and bugs at http://rt.cpan.org/NoAuth/Bugs.html?Dist=Alien-Box2D

AUTHOR

KMX, <kmx at cpan.org>

COPYRIGHT

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

The full text of the license can be found in the LICENSE file included with this module.