/ 
Alien-FreeImage-0.001
River stage one • 1 direct dependent • 1 total dependent
⭐ Starred 0 GitHub stars
/ Alien::FreeImage

NAME

Alien::FreeImage - Building freeimage library - http://freeimage.sourceforge.net/

VERSION

Version 0.001 of Alien::FreeImage uses freeimage sources XXXX.

SYNOPSIS

IMPORTANT: This module is not a perl binding for freeimage library; it is just a helper module.

Alien::FreeImage installation comprise of these steps:

  • Build freeimage binaries from source codes (note: static libraries are build in this case)

  • Install binaries and dev files (*.h, *.a) into share directory of Alien::FreeImage distribution - share directory is usually something like this: /usr/lib/perl5/site_perl/5.10/auto/share/dist/Alien-FreeImage

Later on you can use Alien::FreeImage in your module that needs to link with freeimage like this:

# Sample Makefile.pl
use ExtUtils::MakeMaker;
use Alien::FreeImage;

WriteMakefile(
  NAME         => 'Any::FreeImage::Module',
  VERSION_FROM => 'lib/Any/FreeImage/Module.pm',
  LIBS         => Alien::FreeImage->config('LIBS'),
  INC          => Alien::FreeImage->config('INC'),
  # + additional params
);

IMPORTANT: As Alien::FreeImage builds static libraries the modules using Alien::FreeImage need to have Alien::FreeImage just for building, not for later use. In other words Alien:FreeImage is just "build dependency" not "run-time dependency".

METHODS

config()

This function is the main public interface to this module.

Alien::FreeImage->config('LIBS');

Returns a string like: '-L/path/to/freeimage/dir/lib -lfreeimage'

Alien::FreeImage->config('INC');

Returns a string like: '-I/path/to/freeimage/dir/include'

Alien::FreeImage->config('PREFIX');

Returns a string like: '/path/to/freeimage/dir'

LICENSE

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

COPYRIGHT

2014+ KMX <kmx@cpan.org>