1Alien::wxWidgets(3) User Contributed Perl Documentation Alien::wxWidgets(3)
2
6 Alien::wxWidgets - building, finding and using wxWidgets binaries
7
9 use Alien::wxWidgets <options>;
10 my $version = Alien::wxWidgets->version;
12 my $config = Alien::wxWidgets->config;
13 my $compiler = Alien::wxWidgets->compiler;
14 my $linker = Alien::wxWidgets->linker;
15 my $include_path = Alien::wxWidgets->include_path;
16 my $defines = Alien::wxWidgets->defines;
17 my $cflags = Alien::wxWidgets->c_flags;
18 my $linkflags = Alien::wxWidgets->link_flags;
19 my $libraries = Alien::wxWidgets->libraries( qw(gl adv core base) );
20 my @libraries = Alien::wxWidgets->link_libraries( qw(gl adv core base) );
21 my @implib = Alien::wxWidgets->import_libraries( qw(gl adv core base) );
22 my @shrlib = Alien::wxWidgets->shared_libraries( qw(gl adv core base) );
23 my @keys = Alien::wxWidgets->library_keys; # 'gl', 'adv', ...
24 my $library_path = Alien::wxWidgets->shared_library_path;
25 my $key = Alien::wxWidgets->key;
26 my $prefix = Alien::wxWidgets->prefix;
27
29 Please see Alien for the manifesto of the Alien namespace.
30 In short "Alien::wxWidgets" can be used to detect and get configuration
32 settings from an installed wxWidgets.
33
35 load/import
36 use Alien::wxWidgets version => 2.004 | [ 2.004, 2.005 ],
37 compiler_kind => 'gcc' | 'cl', # Windows only
38 compiler_version => '3.3', # only GCC for now
39 toolkit => 'gtk2',
40 debug => 0 | 1,
41 unicode => 0 | 1,
42 mslu => 0 | 1,
43 key => $key,
44 ;
45 Alien::wxWidgets->load( <same as the above> );
47 Using "Alien::wxWidgets" without parameters will load a default
49 configuration (for most people this will be the only installed
50 confiuration). Additional parameters allow to be more selective.
51 If there is no matching configuration the method will "die()".
53 In case no arguments are passed in the "use", "Alien::wxWidgets" will
55 try to find a reasonable default configuration.
56 Please note that when the version is pecified as "version =" 2.004> it
58 means "any version >= 2.004" while when specified as "version =" [
59 2.004, 2.005 ]> it means "any version => 2.004 and < 2.005".
60 key
62 my $key = Alien::wxWidgets key;
63 Returns an unique key that can be used to reload the currently-loaded
65 configuration.
66 version
68 my $version = Alien::wxWidgets->version;
69 Returns the wxWidgets version for this "Alien::wxWidgets" installation
71 in the form MAJOR + MINOR / 1_000 + RELEASE / 1_000_000 e.g. 2.006002
72 for wxWidgets 2.6.2 and 2.004 for wxWidgets 2.4.0.
73 config
75 my $config = Alien::wxWidgets->config;
76 Returns some miscellaneous configuration informations for wxWidgets in
78 the form
79 { toolkit => 'msw' | 'gtk' | 'motif' | 'x11' | 'cocoa' | 'mac',
81 debug => 1 | 0,
82 unicode => 1 | 0,
83 mslu => 1 | 0,
84 }
85 include_path
87 my $include_path = Alien::wxWidgets->include_path;
88 Returns the include paths to be used in a format suitable for the
90 compiler (usually something like "-I/usr/local/include
91 -I/opt/wx/include").
92 defines
94 my $defines = Alien::wxWidgets->defines;
95 Returns the compiler defines to be used in a format suitable for the
97 compiler (usually something like "-D__WXDEBUG__ -DFOO=bar").
98 c_flags
100 my $cflags = Alien::wxWidgets->c_flags;
101 Returns additional compiler flags to be used.
103 compiler
105 my $compiler = Alien::wxWidgets->compiler;
106 Returns the (C++) compiler used for compiling wxWidgets.
108 linker
110 my $linker = Alien::wxWidgets->linker;
111 Returns a linker suitable for linking C++ binaries.
113 link_flags
115 my $linkflags = Alien::wxWidgets->link_flags;
116 Returns additional link flags.
118 libraries
120 my $libraries = Alien::wxWidgets->libraries( qw(gl adv core base) );
121 Returns link flags for linking the libraries passed as arguments. This
123 usually includes some search path specification in addition to the
124 libraries themselves. The caller is responsible for the correct order
125 of the libraries.
126 link_libraries
128 my @libraries = Alien::wxWidgets->link_libraries( qw(gl adv core base) );
129 Returns a list of linker flags that can be used to link the libraries
131 passed as arguments.
132 import_libraries
134 my @implib = Alien::wxWidgets->import_libraries( qw(gl adv core base) );
135 Windows specific. Returns a list of import libraries corresponding to
137 the libraries passed as arguments.
138 shared_libraries
140 my @shrlib = Alien::wxWidgets->shared_libraries( qw(gl adv core base) );
141 Returns a list of shared libraries corresponding to the libraries
143 passed as arguments.
144 library_keys
146 my @keys = Alien::wxWidgets->library_keys;
147 Returns a list of keys that can be passed to "shared_libraries",
149 "import_libraries" and "link_libraries".
150 library_path
152 my $library_path = Alien::wxWidgets->shared_library_path;
153 Windows specific. Returns the path at which the private copy of
155 wxWidgets libraries has been installed.
156 prefix
158 my $prefix = Alien::wxWidgets->prefix;
159 Returns the install prefix for wxWidgets.
161 dump_configurations
163 Alien::wxWidgets->dump_configurations( %filters );
164 Prints a list of available configurations (mainly useful for
166 interactive use/debugging).
167 show_configurations
169 Alien::wxWidgets->show_configurations( %filters );
170 Prints a human-readable list of available configurations (mainly useful
172 for interactive use/debugging).
173 get_configurations
175 my $configs = Alien::wxWidgets->get_configurations( %filters );
176 Returns a list of configurations matching the given filters.
178
180 Mattia Barbon <mbarbon@cpan.org>
181
183 Alien::wxWidgets
184 Copyright (c) 2005-2009 Mattia Barbon <mbarbon@cpan.org>
185 This program is free software; you can redistribute it and/or
187 modify it under the same terms as Perl itself
188 inc/bin/patch
190 was taken from the Perl Power Tools distributions
191 Copyright (c) 1999 Moogle Stuffy Software <tgy@chocobo.org>
193 You may play with this software in accordance with the Perl
195 Artistic License.
196 You may use this documentation under the auspices of the GNU
198 General Public License.
199 inc/bin/patch.exe
201 was downloaded from
202 http://gnuwin32.sourceforge.net/packages/patch.htm ad is
203 copyrighted by its authors, sources are included inside the inc/src
204 directory.
205 This program is free software; you can redistribute it and/or
207 modify it under the terms of the GNU General Public License as
208 published by the Free Software Foundation; either version 2 of the
209 License, or (at your option) any later version.
210 This program is distributed in the hope that it will be useful, but
212 WITHOUT ANY WARRANTY; without even the implied warranty of
213 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
214 General Public License for more details.
215 You should have received a copy of the GNU General Public License
217 along with this program; if not, write to the Free Software
218 Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
219 02111-1307 USA
220 bundled files from CPAN
222 inc/File/Fetch/Item.pm
223 inc/File/Fetch.pm
224 inc/File/Spec/Unix.pm
225 inc/IPC/Cmd.pm
226 inc/Locale/Maketext/Simple.pm
227 inc/Module/Load/Conditional.pm
228 inc/Module/Load.pm
229 inc/Params/Check.pm
230 inc/Archive/Extract.pm
231 Are copyright their respective authors an can be used according to
233 the license specified in their CPAN distributions.
234perl v5.12.1 2010-07-14 Alien::wxWidgets(3)