/ 
Alien-wxWidgets-0.12
River stage two • 3 direct dependents • 69 total dependents
/ Alien::wxWidgets

NAME

Alien::wxWidgets - building, finding and using wxWidgets binaries

SYNOPSIS

use Alien::wxWidgets <options>;

my $version = Alien::wxWidgets->version;
my $config = Alien::wxWidgets->config;
my $compiler = Alien::wxWidgets->compiler;
my $linker = Alien::wxWidgets->linker;
my $include_path = Alien::wxWidgets->include_path;
my $defines = Alien::wxWidgets->defines;
my $cflags = Alien::wxWidgets->c_flags;
my $linkflags = Alien::wxWidgets->link_flags;
my $libraries = Alien::wxWidgets->libraries( qw(gl adv core base) );
my @libraries = Alien::wxWidgets->link_libraries( qw(gl adv core base) );
my @implib = Alien::wxWidgets->import_libraries( qw(gl adv core base) );
my @shrlib = Alien::wxWidgets->shared_libraries( qw(gl adv core base) );
my @keys = Alien::wxWidgets->library_keys; # 'gl', 'adv', ...
my $library_path = Alien::wxWidgets->shared_library_path;
my $key = Alien::wxWidgets->key;
my $prefix = Alien::wxWidgets->prefix;

DESCRIPTION

Please see Alien for the manifesto of the Alien namespace.

In short Alien::wxWidgets can be used to detect and get configuration settings from an installed wxWidgets.

METHODS

load/import

use Alien::wxWidgets version          => 2.004 | [ 2.004, 2.005 ],
                     compiler_kind    => 'gcc' | 'cl', # Windows only
                     compiler_version => '3.3', # only GCC for now
                     toolkit          => 'gtk2',
                     debug            => 0 | 1,
                     unicode          => 0 | 1,
                     mslu             => 0 | 1,
                     key              => $key,
                     ;

Alien::wxWidgets->load( <same as the above> );

Using Alien::wxWidgets without parameters will load a default configuration (for most people this will be the only installed confiuration). Additional parameters allow to be more selective.

If there is no matching configuration the method will die().

In case no arguments are passed in the use, Alien::wxWidgets will try to find a reasonable default configuration.

Please note that when the version is pecified as version = 2.004> it means "any version >= 2.004" while when specified as version = [ 2.004, 2.005 ]> it means "any version => 2.004 and < 2.005".

key

my $key = Alien::wxWidgets key;

Returns an unique key that can be used to reload the currently-loaded configuration.

version

my $version = Alien::wxWidgets->version;

Returns the wxWidgets version for this Alien::wxWidgets installation in the form MAJOR + MINOR / 1_000 + RELEASE / 1_000_000 e.g. 2.006002 for wxWidgets 2.6.2 and 2.004 for wxWidgets 2.4.0.

config

my $config = Alien::wxWidgets->config;

Returns some miscellaneous configuration informations for wxWidgets in the form

{ toolkit   => 'msw' | 'gtk' | 'motif' | 'x11' | 'cocoa' | 'mac',
  debug     => 1 | 0,
  unicode   => 1 | 0,
  mslu      => 1 | 0,
  }

include_path

my $include_path = Alien::wxWidgets->include_path;

Returns the include paths to be used in a format suitable for the compiler (usually something like "-I/usr/local/include -I/opt/wx/include").

defines

my $defines = Alien::wxWidgets->defines;

Returns the compiler defines to be used in a format suitable for the compiler (usually something like "-D__WXDEBUG__ -DFOO=bar").

c_flags

my $cflags = Alien::wxWidgets->c_flags;

Returns additional compiler flags to be used.

compiler

my $compiler = Alien::wxWidgets->compiler;

Returns the (C++) compiler used for compiling wxWidgets.

linker

my $linker = Alien::wxWidgets->linker;

Returns a linker suitable for linking C++ binaries.

link_flags

my $linkflags = Alien::wxWidgets->link_flags;

Returns additional link flags.

libraries

my $libraries = Alien::wxWidgets->libraries( qw(gl adv core base) );

Returns link flags for linking the libraries passed as arguments. This usually includes some search path specification in addition to the libraries themselves. The caller is responsible for the correct order of the libraries.

link_libraries

my @libraries = Alien::wxWidgets->link_libraries( qw(gl adv core base) );

Returns a list of linker flags that can be used to link the libraries passed as arguments.

import_libraries

my @implib = Alien::wxWidgets->import_libraries( qw(gl adv core base) );

Windows specific. Returns a list of import libraries corresponding to the libraries passed as arguments.

shared_libraries

my @shrlib = Alien::wxWidgets->shared_libraries( qw(gl adv core base) );

Returns a list of shared libraries corresponding to the libraries passed as arguments.

library_path

my $library_path = Alien::wxWidgets->shared_library_path;

Windows specific. Returns the path at which the private copy of wxWidgets libraries has been installed.

BUGS

  • Does not support multiple wxWidgets configurations.

  • Does not support automated wxWidgets download/installation.

  • Error handling (wx-config not in path, compiler/make not found) is missing.

AUTHOR

Mattia Barbon <mbarbon@cpan.org>

LICENSE

Copyright (c) 2005 Mattia Barbon <mbarbon@cpan.org>

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