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

Description
  This distribution builds and installs libraries for the (stable) "1.3.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 <FL/Fl.H>
      #include <FL/Fl_Window.H>
      #include <FL/Fl_Box.H>
      int main(int argc, char **argv) {
        Fl_Window *window = new Fl_Window(300,180);
        Fl_Box *box = new Fl_Box(FL_UP_BOX, 20, 40, 260, 100, "Hello, World!");
        box->labelfont(FL_BOLD + FL_ITALIC);
        box->labelsize(36);
        box->labeltype(FL_SHADOW_LABEL);
        window->end();
        window->show(argc, argv);
        return Fl::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 fltk 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

      Additionally, the optional XCurser lib may be installed with:

        > 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::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, Alien::FLTK2

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 0bfc53b 2010-02-13 16:54:31Z sanko@cpan.org $
