NAME
  Alien::FLTK2 - 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::FLTK2;
    use ExtUtils::CBuilder;
    my $AF     = Alien::FLTK2->new();
    my $CC     = ExtUtils::CBuilder->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('C++'                => 1,
                           source               => $source,
                           include_dirs         => [$AF->include_dirs()],
                           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::FLTK2 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::FLTK2 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::FLTK2 too.

  *   Repository

      http://github.com/sanko/alien-fltk2/ 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::FLTK2::Todo

See Also
    FLTK, Alien::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::FLTK2 is based in part on the work of the FLTK project. See
  http://www.fltk.org/.

$Id: README 29c299d 2010-01-18 05:25:57Z sanko@cpan.org $
