NAME
  Alien::FLTK - Build and use the Fast Light Toolkit binaries

Description
  This distribution builds and installs libraries for the (experimental)
  "2.0.x" branch of the FLTK GUI toolkit.

Synopsis
    use Alien::FLTK;
    use ExtUtils::CBuilder;
    my $CC     = ExtUtils::CBuilder->new();
    my $AF     = Alien::FLTK->new();
    my $source = 'hello_world.cxx';
    open(my $FH, '>', $source) || die '...';
    syswrite($FH, <<'') || die '...'; close $FH;
        #include <fltk/Window.h>
        #include <fltk/Widget.h>
        #include <fltk/run.h>
        using namespace fltk;
        int main(int argc, char **argv) {
            Window *window = new Window(300, 180);
            window->begin();
            Widget *box = new Widget(20, 40, 260, 100, "Hello, World!");
            box->box(UP_BOX);
            box->labelfont(HELVETICA_BOLD_ITALIC);
            box->labelsize(36);
            box->labeltype(SHADOW_LABEL);
            window->end();
            window->show(argc, argv);
            return run();
        }

    my $obj = $CC->compile( source               => $source,
                            extra_compiler_flags => $AF->cxxflags( ) );
    my $exe = $CC->link_executable( objects            => $obj,
                                    extra_linker_flags => $AF->ldflags( ) );
    print system('./' . $exe) ? 'Aww...' : 'Yay!';
    END { unlink grep defined, $source, $obj, $exe; }

Requirements
  Prerequisites differ by system...

  * Win32
      The fltk2 libs and Alien::FLTK both build right out of the box with
      MinGW. Further testing is needed for other setups.

  * X11/*nix
      X11-based systems require several development packages. On Debian, these
      may be installed with...

        > sudo apt-get install libx11-dev
        > sudo apt-get install libxi-dev
        > sudo apt-get install libxcursor-dev

  * Darwin/OSX
      Uh, yeah, I have no idea.

Installation
  The distribution is based on Module::Build, so use the following procedure:

      > perl Build.PL
      > ./Build
      > ./Build test
      > ./Build install

Support Links
  *   Issue Tracker

      http://github.com/sanko/alien-fltk/issues

      Please only report Alien::FLTK related bugs to this tracker. For FLTK
      issues, use http://github.com/sanko/fltk-perl/issues/

  *   Homepage:

      http://sanko.github.com/fltk-perl/ is the homepage of the FLTK project.

  *   Mailing List

      Once I find someone to host a list for the FLTK project, I'll use it for
      Alien::FLTK too.

  *   Repository

      http://github.com/sanko/alien-fltk/ and you are invited to fork it.

Examples
  Please see the Synopsis and the files in the "/example/".

Bugs
  Numerous, I'm sure. Please see Alien::FLTK::Todo

See Also
    FLTK

Author
    Sanko Robinson <sanko@cpan.org> - http://sankorobinson.com/

    CPAN ID: SANKO

License and Legal
  Copyright (C) 2009 by Sanko Robinson <sanko@cpan.org>

  This program is free software; you can redistribute it and/or modify it
  under the terms of The Artistic License 2.0. See the LICENSE file
  included with this distribution or
  http://www.perlfoundation.org/artistic_license_2_0. For clarification,
  see http://www.perlfoundation.org/artistic_2_0_notes.

  When separated from the distribution, all POD documentation is covered
  by the Creative Commons Attribution-Share Alike 3.0 License. See
  http://creativecommons.org/licenses/by-sa/3.0/us/legalcode. For
  clarification, see http://creativecommons.org/licenses/by-sa/3.0/us/.

  Alien::FLTK is based in part on the work of the FLTK project. See
  http://www.fltk.org/.

$Id: README 1622ff0 2009-10-10 15:08:27Z sanko@cpan.org $
