wxruby64 2.0.1-x64-mingw32
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +7 -0
- data/INSTALL +254 -0
- data/LICENSE +53 -0
- data/README +198 -0
- data/art/wxruby-128x128.png +0 -0
- data/art/wxruby-256x256.png +0 -0
- data/art/wxruby-64x64.png +0 -0
- data/art/wxruby.png +0 -0
- data/lib/wx.rb +53 -0
- data/lib/wx/accessors.rb +68 -0
- data/lib/wx/classes/acceleratortable.rb +28 -0
- data/lib/wx/classes/animation.rb +18 -0
- data/lib/wx/classes/app.rb +51 -0
- data/lib/wx/classes/artprovider.rb +31 -0
- data/lib/wx/classes/auinotebook.rb +9 -0
- data/lib/wx/classes/bitmap.rb +59 -0
- data/lib/wx/classes/busycursor.rb +12 -0
- data/lib/wx/classes/checklistbox.rb +46 -0
- data/lib/wx/classes/choice.rb +4 -0
- data/lib/wx/classes/clientdc.rb +13 -0
- data/lib/wx/classes/clipboard.rb +56 -0
- data/lib/wx/classes/colour.rb +49 -0
- data/lib/wx/classes/combobox.rb +4 -0
- data/lib/wx/classes/commandevent.rb +7 -0
- data/lib/wx/classes/controlwithitems.rb +10 -0
- data/lib/wx/classes/data_object.rb +14 -0
- data/lib/wx/classes/data_object_simple.rb +6 -0
- data/lib/wx/classes/dataformat.rb +23 -0
- data/lib/wx/classes/dc.rb +57 -0
- data/lib/wx/classes/event.rb +5 -0
- data/lib/wx/classes/evthandler.rb +1039 -0
- data/lib/wx/classes/font.rb +118 -0
- data/lib/wx/classes/functions.rb +44 -0
- data/lib/wx/classes/gauge.rb +12 -0
- data/lib/wx/classes/genericdirctrl.rb +36 -0
- data/lib/wx/classes/grid.rb +146 -0
- data/lib/wx/classes/hboxsizer.rb +6 -0
- data/lib/wx/classes/helpcontroller.rb +5 -0
- data/lib/wx/classes/helpcontrollerhelpprovider.rb +23 -0
- data/lib/wx/classes/helpprovider.rb +15 -0
- data/lib/wx/classes/htmlhelpcontroller.rb +5 -0
- data/lib/wx/classes/htmlwindow.rb +14 -0
- data/lib/wx/classes/icon.rb +32 -0
- data/lib/wx/classes/iconbundle.rb +3 -0
- data/lib/wx/classes/image.rb +53 -0
- data/lib/wx/classes/imagelist.rb +3 -0
- data/lib/wx/classes/listbox.rb +4 -0
- data/lib/wx/classes/listctrl.rb +33 -0
- data/lib/wx/classes/locale.rb +28 -0
- data/lib/wx/classes/mediactrl.rb +48 -0
- data/lib/wx/classes/menu.rb +62 -0
- data/lib/wx/classes/menuitem.rb +7 -0
- data/lib/wx/classes/notebook.rb +9 -0
- data/lib/wx/classes/object.rb +14 -0
- data/lib/wx/classes/paintdc.rb +12 -0
- data/lib/wx/classes/point.rb +56 -0
- data/lib/wx/classes/previewframe.rb +13 -0
- data/lib/wx/classes/rect.rb +19 -0
- data/lib/wx/classes/richtextctrl.rb +63 -0
- data/lib/wx/classes/simplehelpprovider.rb +38 -0
- data/lib/wx/classes/size.rb +58 -0
- data/lib/wx/classes/sizer.rb +43 -0
- data/lib/wx/classes/sound.rb +23 -0
- data/lib/wx/classes/splitterwindow.rb +10 -0
- data/lib/wx/classes/standardpaths.rb +9 -0
- data/lib/wx/classes/styledtextctrl.rb +92 -0
- data/lib/wx/classes/textctrl.rb +14 -0
- data/lib/wx/classes/texturlevent.rb +18 -0
- data/lib/wx/classes/timer.rb +96 -0
- data/lib/wx/classes/toolbar.rb +36 -0
- data/lib/wx/classes/toolbartool.rb +4 -0
- data/lib/wx/classes/treectrl.rb +44 -0
- data/lib/wx/classes/validator.rb +7 -0
- data/lib/wx/classes/vboxsizer.rb +6 -0
- data/lib/wx/classes/window.rb +89 -0
- data/lib/wx/classes/xmlresource.rb +54 -0
- data/lib/wx/helpers.rb +54 -0
- data/lib/wx/keyword_ctors.rb +204 -0
- data/lib/wx/keyword_defs.rb +585 -0
- data/lib/wx/version.rb +3 -0
- data/lib/wxruby2.so +0 -0
- data/samples/SAMPLES-LICENSE.TXT +18 -0
- data/samples/aui/aui.rb +1356 -0
- data/samples/bigdemo/About.rbw +39 -0
- data/samples/bigdemo/ColorPanel.rbw +23 -0
- data/samples/bigdemo/GridSimple.rbw +78 -0
- data/samples/bigdemo/MDIDemo.rbw +57 -0
- data/samples/bigdemo/PopupMenu.rbw +149 -0
- data/samples/bigdemo/ShapedWindow.rbw +128 -0
- data/samples/bigdemo/Sizers.rbw +543 -0
- data/samples/bigdemo/bigdemo.rb +823 -0
- data/samples/bigdemo/demoTemplate.rbw +33 -0
- data/samples/bigdemo/helpfile.htb +0 -0
- data/samples/bigdemo/icons/Test 015.jpg +0 -0
- data/samples/bigdemo/icons/Test 015.png +0 -0
- data/samples/bigdemo/icons/choice.bmp +0 -0
- data/samples/bigdemo/icons/choice.xpm +27 -0
- data/samples/bigdemo/icons/combo.bmp +0 -0
- data/samples/bigdemo/icons/combo.xpm +27 -0
- data/samples/bigdemo/icons/copy.xpm +25 -0
- data/samples/bigdemo/icons/cut.xpm +24 -0
- data/samples/bigdemo/icons/gauge.bmp +0 -0
- data/samples/bigdemo/icons/gauge.xpm +27 -0
- data/samples/bigdemo/icons/help.xpm +25 -0
- data/samples/bigdemo/icons/list.bmp +0 -0
- data/samples/bigdemo/icons/list.xpm +27 -0
- data/samples/bigdemo/icons/mondrian.ico +0 -0
- data/samples/bigdemo/icons/mondrian.xpm +44 -0
- data/samples/bigdemo/icons/new.xpm +24 -0
- data/samples/bigdemo/icons/ogl.ico +0 -0
- data/samples/bigdemo/icons/ogl.xpm +45 -0
- data/samples/bigdemo/icons/open.xpm +26 -0
- data/samples/bigdemo/icons/paste.bmp +0 -0
- data/samples/bigdemo/icons/paste.xpm +38 -0
- data/samples/bigdemo/icons/pointy.png +0 -0
- data/samples/bigdemo/icons/preview.xpm +26 -0
- data/samples/bigdemo/icons/print.xpm +26 -0
- data/samples/bigdemo/icons/radio.bmp +0 -0
- data/samples/bigdemo/icons/radio.xpm +27 -0
- data/samples/bigdemo/icons/robert.xpm +415 -0
- data/samples/bigdemo/icons/sashtest.ico +0 -0
- data/samples/bigdemo/icons/save.xpm +25 -0
- data/samples/bigdemo/icons/smiles.bmp +0 -0
- data/samples/bigdemo/icons/smiles.xpm +39 -0
- data/samples/bigdemo/icons/smiley.ico +0 -0
- data/samples/bigdemo/icons/smiley.xpm +42 -0
- data/samples/bigdemo/icons/stattext.xpm +24 -0
- data/samples/bigdemo/icons/test2.bmp +0 -0
- data/samples/bigdemo/icons/test2.png +0 -0
- data/samples/bigdemo/icons/test2.xpm +79 -0
- data/samples/bigdemo/icons/text.bmp +0 -0
- data/samples/bigdemo/icons/text.xpm +27 -0
- data/samples/bigdemo/icons/tog1.bmp +0 -0
- data/samples/bigdemo/icons/tog1.xpm +38 -0
- data/samples/bigdemo/icons/tog2.bmp +0 -0
- data/samples/bigdemo/icons/tog2.xpm +38 -0
- data/samples/bigdemo/icons/wxruby-128x128.png +0 -0
- data/samples/bigdemo/icons/wxwin.ico +0 -0
- data/samples/bigdemo/icons/wxwin16x16.png +0 -0
- data/samples/bigdemo/icons/wxwin16x16.xpm +25 -0
- data/samples/bigdemo/icons/wxwin32x32.png +0 -0
- data/samples/bigdemo/icons/wxwin48x48.png +0 -0
- data/samples/bigdemo/run.rb +90 -0
- data/samples/bigdemo/tips.txt +7 -0
- data/samples/bigdemo/utils.rb +12 -0
- data/samples/bigdemo/wxArtProvider.rbw +281 -0
- data/samples/bigdemo/wxBitmapButton.rbw +65 -0
- data/samples/bigdemo/wxButton.rbw +64 -0
- data/samples/bigdemo/wxCalendarCtrl.rbw +60 -0
- data/samples/bigdemo/wxCheckBox.rbw +50 -0
- data/samples/bigdemo/wxCheckListBox.rbw +65 -0
- data/samples/bigdemo/wxChoice.rbw +47 -0
- data/samples/bigdemo/wxChoicebook.rbw +78 -0
- data/samples/bigdemo/wxColourDialog.rbw +31 -0
- data/samples/bigdemo/wxComboBox.rbw +77 -0
- data/samples/bigdemo/wxCursor.rbw +136 -0
- data/samples/bigdemo/wxDialog.rbw +74 -0
- data/samples/bigdemo/wxDirDialog.rbw +29 -0
- data/samples/bigdemo/wxDragImage.rbw +70 -0
- data/samples/bigdemo/wxFileDialog.rbw +37 -0
- data/samples/bigdemo/wxFileDialog_Save.rbw +35 -0
- data/samples/bigdemo/wxFindReplaceDialog.rbw +82 -0
- data/samples/bigdemo/wxFontDialog.rbw +173 -0
- data/samples/bigdemo/wxFrame.rbw +53 -0
- data/samples/bigdemo/wxGauge.rbw +71 -0
- data/samples/bigdemo/wxGenericDirCtrl.rbw +74 -0
- data/samples/bigdemo/wxGrid.rbw +66 -0
- data/samples/bigdemo/wxHtmlHelpController.rbw +52 -0
- data/samples/bigdemo/wxListBox.rbw +140 -0
- data/samples/bigdemo/wxListCtrl_virtual.rbw +112 -0
- data/samples/bigdemo/wxMDIWindows.rbw +50 -0
- data/samples/bigdemo/wxMenu.rbw +236 -0
- data/samples/bigdemo/wxMessageDialog.rbw +27 -0
- data/samples/bigdemo/wxMiniFrame.rbw +70 -0
- data/samples/bigdemo/wxMultipleChoiceDialog.rbw +32 -0
- data/samples/bigdemo/wxNotebook.rbw +136 -0
- data/samples/bigdemo/wxProgressDialog.rbw +43 -0
- data/samples/bigdemo/wxRadioBox.rbw +72 -0
- data/samples/bigdemo/wxRadioButton.rbw +125 -0
- data/samples/bigdemo/wxSashWindow.rbw +141 -0
- data/samples/bigdemo/wxScrolledMessageDialog.rbw +57 -0
- data/samples/bigdemo/wxScrolledWindow.rbw +199 -0
- data/samples/bigdemo/wxSingleChoiceDialog.rbw +33 -0
- data/samples/bigdemo/wxSlider.rbw +42 -0
- data/samples/bigdemo/wxSpinButton.rbw +50 -0
- data/samples/bigdemo/wxSpinCtrl.rbw +51 -0
- data/samples/bigdemo/wxSplitterWindow.rbw +63 -0
- data/samples/bigdemo/wxStaticBitmap.rbw +47 -0
- data/samples/bigdemo/wxStaticText.rbw +55 -0
- data/samples/bigdemo/wxStatusBar.rbw +126 -0
- data/samples/bigdemo/wxTextCtrl.rbw +149 -0
- data/samples/bigdemo/wxTextEntryDialog.rbw +31 -0
- data/samples/bigdemo/wxToggleButton.rbw +49 -0
- data/samples/bigdemo/wxToolBar.rbw +131 -0
- data/samples/bigdemo/wxTreeCtrl.rbw +191 -0
- data/samples/calendar/calendar.rb +348 -0
- data/samples/caret/caret.rb +282 -0
- data/samples/caret/mondrian.xpm +44 -0
- data/samples/controls/controls.rb +1136 -0
- data/samples/controls/get_item_sample.rb +87 -0
- data/samples/controls/icons/choice.xpm +27 -0
- data/samples/controls/icons/combo.xpm +27 -0
- data/samples/controls/icons/gauge.xpm +27 -0
- data/samples/controls/icons/list.xpm +27 -0
- data/samples/controls/icons/radio.xpm +27 -0
- data/samples/controls/icons/stattext.xpm +24 -0
- data/samples/controls/icons/text.xpm +27 -0
- data/samples/controls/mondrian.ico +0 -0
- data/samples/controls/mondrian.xpm +44 -0
- data/samples/controls/test2.bmp +0 -0
- data/samples/dialogs/dialogs.rb +797 -0
- data/samples/dialogs/tips.txt +18 -0
- data/samples/dragdrop/dragdrop.rb +177 -0
- data/samples/drawing/bitmap.rb +49 -0
- data/samples/drawing/bitmap_image.rb +92 -0
- data/samples/drawing/graphics_drawing.rb +235 -0
- data/samples/drawing/maths_images.rb +265 -0
- data/samples/drawing/rmagic_bitmap_image.rb +110 -0
- data/samples/drawing/ruby-logo.jpg +0 -0
- data/samples/etc/activation.rb +102 -0
- data/samples/etc/choice.rb +67 -0
- data/samples/etc/miniframe.rb +79 -0
- data/samples/etc/sash.rb +130 -0
- data/samples/etc/scrollwin.rb +110 -0
- data/samples/etc/system_settings.rb +252 -0
- data/samples/etc/threaded.rb +72 -0
- data/samples/etc/toolbar_sizer_additem.rb +55 -0
- data/samples/etc/wizard.rb +74 -0
- data/samples/event/event.rb +182 -0
- data/samples/event/update_ui_event.rb +70 -0
- data/samples/grid/grid.rb +198 -0
- data/samples/grid/gridtablebase.rb +148 -0
- data/samples/html/html.rb +262 -0
- data/samples/listbook/listbook.rb +174 -0
- data/samples/listbook/listbook.xrc +370 -0
- data/samples/mdi/mdi.rb +85 -0
- data/samples/media/mediactrl.rb +167 -0
- data/samples/minimal/minimal.rb +77 -0
- data/samples/minimal/mondrian.ico +0 -0
- data/samples/minimal/mondrian.png +0 -0
- data/samples/minimal/nothing.rb +16 -0
- data/samples/opengl/cube.rb +130 -0
- data/samples/opengl/cube_anim_lighting.rb +191 -0
- data/samples/printing/mondrian.ico +0 -0
- data/samples/printing/mondrian.xpm +44 -0
- data/samples/printing/printing.rb +487 -0
- data/samples/sockets/SocketPackets.rb +27 -0
- data/samples/sockets/res/message-new.png +0 -0
- data/samples/sockets/res/user.png +0 -0
- data/samples/sockets/wxClient.rb +395 -0
- data/samples/sockets/wxServer.rb +422 -0
- data/samples/sockets/wxSocketGUI.rb +97 -0
- data/samples/text/document-open.png +0 -0
- data/samples/text/document-save.png +0 -0
- data/samples/text/edit-copy.png +0 -0
- data/samples/text/edit-cut.png +0 -0
- data/samples/text/edit-paste.png +0 -0
- data/samples/text/edit-redo.png +0 -0
- data/samples/text/edit-undo.png +0 -0
- data/samples/text/format-text-bold.png +0 -0
- data/samples/text/format-text-italic.png +0 -0
- data/samples/text/format-text-underline.png +0 -0
- data/samples/text/mondrian.ico +0 -0
- data/samples/text/mondrian.xpm +44 -0
- data/samples/text/preferences-desktop-font.png +0 -0
- data/samples/text/rich_textctrl.rb +290 -0
- data/samples/text/scintilla.rb +169 -0
- data/samples/text/textctrl.rb +111 -0
- data/samples/text/unicode.rb +242 -0
- data/samples/text/utf8.txt +15 -0
- data/samples/treectrl/icon1.xpm +79 -0
- data/samples/treectrl/icon2.xpm +53 -0
- data/samples/treectrl/icon3.xpm +79 -0
- data/samples/treectrl/icon4.xpm +43 -0
- data/samples/treectrl/icon5.xpm +79 -0
- data/samples/treectrl/treectrl.rb +1166 -0
- data/samples/xrc/samples.xrc +46 -0
- data/samples/xrc/xrc_sample.rb +76 -0
- metadata +330 -0
checksums.yaml
ADDED
@@ -0,0 +1,7 @@
|
|
1
|
+
---
|
2
|
+
SHA1:
|
3
|
+
metadata.gz: d49246a78b536d2eac4bc11ee424666d779699fa
|
4
|
+
data.tar.gz: 7aec110b2a41bcdff04fbf51504ae3a770857b17
|
5
|
+
SHA512:
|
6
|
+
metadata.gz: ef6abc18ba9f5b74880022a57e3a07641a75a96e2def28973a542f8e96f8df0745a75f8d5d2f0581d4193dc331642a4915dbed95e2a1cbb28877ce9bd6c11a6c
|
7
|
+
data.tar.gz: 333f6eb5b99bf3fa8785dee712721c55238724671c265a3817712bdeb667cc2005ff16c78faddca2ee2f4d66827c5e85a8409fb504230d10b13193cf55864c94
|
data/INSTALL
ADDED
@@ -0,0 +1,254 @@
|
|
1
|
+
= Installing wxRuby
|
2
|
+
|
3
|
+
wxRuby is fully supported on Ruby 1.8 and Ruby 1.9.1. There are two
|
4
|
+
ways of installing wxRuby2:
|
5
|
+
|
6
|
+
* Using Rubygems to install a precompiled binary gem
|
7
|
+
* Obtaining the sources and compiling wxRuby yourself
|
8
|
+
|
9
|
+
For most users (especially on Windows and OS X), using rubygems will be
|
10
|
+
most convenient, and is recommended. Compiling may be needed on systems
|
11
|
+
which have very varied configurations (in particular, Linux). You'll
|
12
|
+
also need to compile yourself if you want to use the latest development
|
13
|
+
code, rather than a numbered release.
|
14
|
+
|
15
|
+
= Installing wxRuby using Rubygems
|
16
|
+
|
17
|
+
On Windows and OS X, the only normal prerequisite is Ruby itself and
|
18
|
+
rubygems. On Linux, you will need your distro's wx library
|
19
|
+
installed. See below for platform-specific information.
|
20
|
+
|
21
|
+
== Temporary instructions for gem installation
|
22
|
+
|
23
|
+
As of February 2009, Rubygems has a serious bug which means that the
|
24
|
+
latest version of specific gems are not correctly offered by the
|
25
|
+
automatic installation procedure. This affects a variety of gems and
|
26
|
+
ruby and rubygems versions. Please follow these temporary instructions
|
27
|
+
until this is resolved:
|
28
|
+
|
29
|
+
Download the correct gem file for your platform from the wxRuby download
|
30
|
+
page: http://rubyforge.org/frs/?group_id=35
|
31
|
+
|
32
|
+
Gems for 1.8 are named: wxruby-[version]-[processor]-[os].gem
|
33
|
+
Gems for 1.9 are named: wxruby-ruby19-[version]-[processor]-[os].gem
|
34
|
+
|
35
|
+
Choose the latest version available for your processor and operating
|
36
|
+
system: mswin32 or mingw32 for Windows, darwin for for OS X, linux for
|
37
|
+
Linux.
|
38
|
+
|
39
|
+
Save the file to your local hard drive. Open a command prompt or
|
40
|
+
terminal, go to the directory where the gem file is saved, and do:
|
41
|
+
|
42
|
+
gem install <filename>
|
43
|
+
|
44
|
+
For example:
|
45
|
+
|
46
|
+
gem install wxruby-1.9.10-x86-mswin32-60.gem
|
47
|
+
|
48
|
+
On Linux and OS X, you may need to run this command as a privileged user, eg
|
49
|
+
|
50
|
+
sudo gem install <filename>
|
51
|
+
|
52
|
+
== Proper instructions for gem installation
|
53
|
+
|
54
|
+
To install wxRuby using Rubygems, open a command prompt and type:
|
55
|
+
|
56
|
+
gem install wxruby # Ruby 1.8
|
57
|
+
gem install wxruby-ruby19 # Ruby 1.9
|
58
|
+
|
59
|
+
If you are on Linux or OS X, you will likely need to run this as a
|
60
|
+
privileged user, something like:
|
61
|
+
|
62
|
+
sudo gem install wxruby
|
63
|
+
|
64
|
+
Wait whilst rubygems updates its gem list. You will then be offered a
|
65
|
+
choice of gems to install. Choose the most up-to-date one available for
|
66
|
+
your platform. Rubygems will download and install the desired gem.
|
67
|
+
|
68
|
+
On Linux, you should also install your distro's wxwidgets 2.8
|
69
|
+
libraries. On Windows and OS X, the gem contains everything needed to
|
70
|
+
create and run wxRuby applications; you're ready to go.
|
71
|
+
|
72
|
+
=== Gem Installation Notes - Microsoft Windows
|
73
|
+
|
74
|
+
* x86-mswin32 gems are for ruby on Windows NT/2000/XP/Vista on Intel-32,
|
75
|
+
built with the Microsoft compiler. This includes current releases of
|
76
|
+
the One-Click Installer.
|
77
|
+
|
78
|
+
* x86-mingw gems are compatible with ruby built on Windows using the
|
79
|
+
MingW compiler
|
80
|
+
|
81
|
+
* If using NT or 2000, you may need to install the free library
|
82
|
+
gdiplus.dll in your Windows/system32 directory.
|
83
|
+
|
84
|
+
* If using a recent fresh install of NT, 2000 or XP, you may need to
|
85
|
+
install the dll msvcp71.dll. This can be downloaded for free.
|
86
|
+
|
87
|
+
* To get native XP-style widgets on XP you need to create a manifest.exe
|
88
|
+
file for ruby; see here for more information:
|
89
|
+
http://rubyonwindows.blogspot.com/2007/10/windows-xp-visual-style-controls-with.html
|
90
|
+
|
91
|
+
* Unfortunately, wxRuby2 does not currently work on Windows 3.1, 98 or
|
92
|
+
Me, as these do not have adequate unicode support. The old
|
93
|
+
wxruby-0.6.0 release should work (to the best of its limited
|
94
|
+
abilities) on these platforms.
|
95
|
+
|
96
|
+
=== Gem Installation Notes - OS X
|
97
|
+
|
98
|
+
* Gems are provided as single universal binary for both Intel and
|
99
|
+
PowerPC Apple machines
|
100
|
+
|
101
|
+
* wxRuby binary gems are compatible with versions 10.4 (Tiger) and 10.5
|
102
|
+
(Leopard)
|
103
|
+
|
104
|
+
=== Gem Installation Notes - Linux
|
105
|
+
|
106
|
+
* The wxRuby gems for Linux are intended to work with your system's
|
107
|
+
existing packages and libraries. Therefore, you should install the
|
108
|
+
wxwidgets-2.8 package(s) for your system, eg libwx-2.8
|
109
|
+
|
110
|
+
* The gems are built on recent versions of Ubuntu; due to the wide
|
111
|
+
variation between the configuration of different distros, they may not
|
112
|
+
work correctly with other distributions and versions. If you
|
113
|
+
experience errors after installing the gem, you will need to compile
|
114
|
+
your own version of wxRuby.
|
115
|
+
|
116
|
+
* On some systems libselinux1-related shutdown crashs are reported with
|
117
|
+
wxRuby. On Ubuntu Hardy, this workaround fixed it:
|
118
|
+
http://www.libavg.de/wiki/index.php/Libavg_on_Ubuntu#8.04_known_issue
|
119
|
+
|
120
|
+
= Compiling wxRuby from Source
|
121
|
+
|
122
|
+
The remainder of this document covers compiling ruby from source.
|
123
|
+
|
124
|
+
Compiling wxRuby is recommended if you wish to use the latest
|
125
|
+
development version, or if you want to work with a specific
|
126
|
+
configuration of wxWidgets - for example, that provided by a Linux
|
127
|
+
distro. You may also need to compile wxRuby if a binary gem is not
|
128
|
+
available for your platform.
|
129
|
+
|
130
|
+
== Compilation prerequisites
|
131
|
+
|
132
|
+
* A C++ compiler: MSVC or MingW for Windows; gcc (g++) for Linux and OS X
|
133
|
+
* A recent version of SWIG, especially for Ruby 1.9.
|
134
|
+
* rake
|
135
|
+
* A compiled wxWidgets library, either built yourself or installed from
|
136
|
+
via a package manager
|
137
|
+
|
138
|
+
wxWidgets has a huge range of compile-time options, and wxRuby tries to
|
139
|
+
support as many of these as possible. In particular, both debug and
|
140
|
+
release builds are supported; a debug build is recommended if you're
|
141
|
+
interested in working on wxRuby. On windows, only static builds are
|
142
|
+
supported; on Linux and OS X, either statically or dynamically linked
|
143
|
+
libraries can be used.
|
144
|
+
|
145
|
+
wxRuby will skip several optional features if they are not supported by
|
146
|
+
your wxWidgets library; these include StyledTextCtrl, GraphicsContext
|
147
|
+
and OpenGL classes.
|
148
|
+
|
149
|
+
== Obtaining wxRuby source code
|
150
|
+
|
151
|
+
Tarballs containing the wxRuby source for released versions can be
|
152
|
+
downloaded from the wxRuby Rubyforge pages:
|
153
|
+
http://rubyforge.org/frs/?group_id=35
|
154
|
+
|
155
|
+
If you wish to use the latest development code, it's hosted in
|
156
|
+
Subversion at rubyforge.org. Note that this code may be incomplete or
|
157
|
+
buggy. To check it out do
|
158
|
+
|
159
|
+
svn co svn://rubyforge.org/var/svn/wxruby/trunk/wxruby2
|
160
|
+
|
161
|
+
== Setting build options
|
162
|
+
|
163
|
+
If you're compiling on Windows, you *must* set an environment variable
|
164
|
+
to indicate where the WxWidgets libraries and header files can be found:
|
165
|
+
|
166
|
+
set WXWIN=C:/path/to/wxMSW-2.8.9
|
167
|
+
|
168
|
+
The path should be the top-level directory of the unpacked wxWidgets
|
169
|
+
tarball; it's recommended that the path does not contain spaces.
|
170
|
+
|
171
|
+
If you have multiple parallel versions of wxWidgets installed, you may
|
172
|
+
influence which build is selected by setting or unsetting the
|
173
|
+
environment variables WXRUBY_DEBUG, WXRUBY_RELEASE, WXRUBY_STATIC and
|
174
|
+
WXRUBY_DYNAMIC. eg
|
175
|
+
|
176
|
+
export WXRUBY_DEBUG=1
|
177
|
+
|
178
|
+
Forces wxRuby to be built against a -debug version of wxWidgets.
|
179
|
+
|
180
|
+
Lastly, you may specifically exclude certain classes; this is most often
|
181
|
+
useful if a particular class is causing problems:
|
182
|
+
|
183
|
+
export WXRUBY_EXCLUDE=ThisClass,ThatClass
|
184
|
+
|
185
|
+
== Running the compile task
|
186
|
+
|
187
|
+
From the top-level directory of the unpacked or downloaded wxRuby
|
188
|
+
directory, just start the rake build with the command:
|
189
|
+
|
190
|
+
rake
|
191
|
+
|
192
|
+
There is no ./configure step, nor do you need to run ruby
|
193
|
+
extconf.rb. wxRuby has approaching 300 classes to generate, compile and
|
194
|
+
link, so the process may take some time.
|
195
|
+
|
196
|
+
== Using a compiled library
|
197
|
+
|
198
|
+
To run a wxRuby program using the newly compiled library, you can run
|
199
|
+
ruby with the -I flag pointing to the lib directory. For example, a
|
200
|
+
quick test of a newly compiled library might be:
|
201
|
+
|
202
|
+
ruby -Ilib samples/minimal/minimal.rb
|
203
|
+
|
204
|
+
== Installing a compiled library
|
205
|
+
|
206
|
+
Rubygems has emerged as the standard for managing user ruby libraries,
|
207
|
+
so you may wish to create a gem from your compiled code and install
|
208
|
+
it. To create a gem, do:
|
209
|
+
|
210
|
+
rake gem
|
211
|
+
|
212
|
+
This will create a gem file, which you can install as above.
|
213
|
+
|
214
|
+
If you do not wish to use Rubygems, you can also do
|
215
|
+
|
216
|
+
rake install
|
217
|
+
|
218
|
+
This will install wxRuby into your site_ruby directories. As with gem
|
219
|
+
commands, you may need to be root do this. Note that as Rubygems has
|
220
|
+
become the standard installation method for Ruby libraries, the
|
221
|
+
'install' task is no longer regularly maintained and tested.
|
222
|
+
|
223
|
+
= Porting to other platforms
|
224
|
+
|
225
|
+
The instructions above cover all the platforms that are in current use
|
226
|
+
for wxRuby. It should however be possible to use wxRuby on any platform
|
227
|
+
supported by wxWidgets and Ruby:
|
228
|
+
|
229
|
+
http://wiki.wxwidgets.org/Supported_Platforms
|
230
|
+
|
231
|
+
Platform-dependent rakefiles are used to set up compiler-specific
|
232
|
+
settings. The following platforms are currently fully supported:
|
233
|
+
|
234
|
+
Mac OSX (gcc): rakemacosx.rb
|
235
|
+
Linux (GTK2 + gcc): rakelinux.rb
|
236
|
+
Windows (shared): rakewindows.rb
|
237
|
+
Windows (MSVC): rakemswin.rb
|
238
|
+
Windows (MingW): rakemingw.rb
|
239
|
+
|
240
|
+
For other platforms, you will need to create or edit the appropriate
|
241
|
+
platform-dependent rake file if your system is not yet supported, or if
|
242
|
+
it is unusual. These files are found in the rake subdirectory, for
|
243
|
+
example:
|
244
|
+
|
245
|
+
NetBSD: rakenetbsd.rb
|
246
|
+
|
247
|
+
The existing rake files should provide a starting point. When editing a
|
248
|
+
platform-dependent rakefile, you might merely need to set one or more of
|
249
|
+
the following variables:
|
250
|
+
|
251
|
+
$extra_cppflags
|
252
|
+
$extra_ldflags
|
253
|
+
$extra_objs
|
254
|
+
$extra_libs
|
data/LICENSE
ADDED
@@ -0,0 +1,53 @@
|
|
1
|
+
wxRuby2
|
2
|
+
Copyright (c) 2004-2007 wxRuby Development Team
|
3
|
+
|
4
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
5
|
+
of this software and associated documentation files (the "Software"), to deal
|
6
|
+
in the Software without restriction, including without limitation the rights
|
7
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
8
|
+
copies of the Software, and to permit persons to whom the Software is
|
9
|
+
furnished to do so, subject to the following conditions:
|
10
|
+
|
11
|
+
The above copyright notice and this permission notice shall be included in
|
12
|
+
all copies or substantial portions of the Software.
|
13
|
+
|
14
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
15
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
16
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
17
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
18
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
19
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
20
|
+
SOFTWARE.
|
21
|
+
|
22
|
+
|
23
|
+
|
24
|
+
|
25
|
+
|
26
|
+
|
27
|
+
============================================================================
|
28
|
+
THE FOLLOWING IS NOT PART OF THE LICENSE, NOR IS IT LEGAL ADVICE!
|
29
|
+
|
30
|
+
wxRuby and wxWidgets
|
31
|
+
--------------------
|
32
|
+
Normally, wxRuby is distributed with a binary copy of wxWidgets. If you
|
33
|
+
distribute the wxRuby gem, you are bound to the requirements of the
|
34
|
+
copy of wxWidgets within. Fortunately, those requirements do not impose
|
35
|
+
any serious restrictions.
|
36
|
+
|
37
|
+
|
38
|
+
wxWidgets License Summary (from the wxWidgets README)
|
39
|
+
-----------------------------------------------------
|
40
|
+
In summary, the licence is LGPL plus a clause allowing unrestricted
|
41
|
+
distribution of application binaries. To answer a FAQ, you don't have to
|
42
|
+
distribute any source if you wish to write commercial applications using
|
43
|
+
wxWidgets.
|
44
|
+
|
45
|
+
|
46
|
+
Required Credits and Attribution
|
47
|
+
--------------------------------
|
48
|
+
|
49
|
+
Generally, neither wxWidgets nor wxRuby require attribution, beyond
|
50
|
+
retaining existing copyright notices. However, if you build your own
|
51
|
+
custom wxWidgets library, there may be portions that require specific
|
52
|
+
attributions or credits, such as TIFF or JPEG support. See the wxWidgets
|
53
|
+
README and license files for details.
|
data/README
ADDED
@@ -0,0 +1,198 @@
|
|
1
|
+
= README for wxRuby version 2.0
|
2
|
+
|
3
|
+
== Introduction
|
4
|
+
|
5
|
+
wxRuby is a cross-platform GUI library for Ruby, based on the wxWidgets
|
6
|
+
GUI toolkit for C++. It uses native widgets wherever possible, providing
|
7
|
+
the correct look, feel and behaviour to GUI applications on Windows, OS
|
8
|
+
X and Linux/GTK. wxRuby aims to provide a comprehensive solution to
|
9
|
+
developing professional-standard desktop applications in Ruby.
|
10
|
+
|
11
|
+
== Installing wxRuby
|
12
|
+
|
13
|
+
wxRuby is distributed as pre-compiled binaries and source from the
|
14
|
+
project's site on Rubyforge: http://wxruby.rubyforge.org/
|
15
|
+
|
16
|
+
For the majority of users, installation simply requires running 'gem
|
17
|
+
install wxruby' on the command line. See INSTALL for further
|
18
|
+
information.
|
19
|
+
|
20
|
+
== wxRuby licence
|
21
|
+
|
22
|
+
wxRuby is free and open-source. It is distributed under a liberal
|
23
|
+
licence which is compatible with both free and commercial development.
|
24
|
+
See LICENSE for more details.
|
25
|
+
|
26
|
+
== FAQ
|
27
|
+
|
28
|
+
=== What platforms and operating systems are supported in wxRuby2?
|
29
|
+
|
30
|
+
Currently the following are fully supported:
|
31
|
+
|
32
|
+
* Windows NT/2000/XP/Vista (i686, MSVC and MingW)
|
33
|
+
* OS X 10.4+ (i686 and PowerPc)
|
34
|
+
* Linux (i686 + AMD-64)
|
35
|
+
|
36
|
+
Support for other platforms is not being actively developed at present,
|
37
|
+
but patches are welcome. It is likely to be much simpler to get wxRuby
|
38
|
+
working on similar modern systems (eg FreeBSD or Solaris with GTK) than
|
39
|
+
on legacy systems (eg Windows 98, Mac OS 9).
|
40
|
+
|
41
|
+
=== Why would I choose wxruby over FXRuby, Ruby/GTK, Shoes etc?
|
42
|
+
|
43
|
+
There are several fine GUI toolkits available for Ruby, but we consider
|
44
|
+
that wxRuby offers a combination of features that no other toolkit can match:
|
45
|
+
|
46
|
+
* Cross-platform (MS Windows, Mac OS X, Linux)
|
47
|
+
* Real native widgets wherever possible
|
48
|
+
* Provides a comprehensive selection of widgets and other GUI features
|
49
|
+
* Useful non-GUI support classes, eg for Images and internationalisation
|
50
|
+
* Simple licence that is compatible with proprietary and Free Software
|
51
|
+
* Mature and actively developed foundation in wxWidgets
|
52
|
+
* Easy to install and redistribute
|
53
|
+
|
54
|
+
=== Why are native widgets important or helpful?
|
55
|
+
|
56
|
+
The really important feature among the above is, for many people, native
|
57
|
+
widgets. Several toolkits are to some degree able to simulate the native
|
58
|
+
appearance of widgets, but wxRuby widgets are actually native widgets -
|
59
|
+
so they behave and interact exactly according to the desktop's GUI
|
60
|
+
conventions.
|
61
|
+
|
62
|
+
For one thing, this means that end-users do not have to adjust to a
|
63
|
+
"foreign" interface. It ensures maximum compatibility with "assistive
|
64
|
+
technology" such as screen readers for blind users. It also allows apps
|
65
|
+
to respect any themes the user may have chosen through their operating
|
66
|
+
system.
|
67
|
+
|
68
|
+
Desktop conventions go beyond widget appearance, to the labelling and
|
69
|
+
positioning of items in standard dialogs and menus. wxRuby offers
|
70
|
+
features to help with these too.
|
71
|
+
|
72
|
+
== Where can I ask a question, or report a bug?
|
73
|
+
|
74
|
+
The main mailing list for those using wxRuby for GUI development is
|
75
|
+
wxruby-users. General questions and queries of all sorts are appropriate
|
76
|
+
for this list, and new users are welcome.
|
77
|
+
|
78
|
+
When asking a question, if something is not working as you expect,
|
79
|
+
please provide a *minimal*, *runnable* sample of code that demonstrates
|
80
|
+
the problem, and say what you expected to happen, and what actually
|
81
|
+
happened. Please also provide basic details of your platform, ruby and
|
82
|
+
wxruby version, and make a reasonable effort to find answers in the
|
83
|
+
archive and documentation before posting. People on the list are happy
|
84
|
+
to help, but it's too much to expect them to guess what you're trying to
|
85
|
+
do, or try and debug 1,000 lines of your application.
|
86
|
+
|
87
|
+
There is a bug-tracker and feature-request system on the rubyforge
|
88
|
+
project pages for wxRuby. Using these helps ensure that a bug is
|
89
|
+
followed through and resolved. You're strongly encouraged to post to
|
90
|
+
these logged-in to rubyforge and not anonymously. You won't receive any
|
91
|
+
requests for follow-up information on anonymous items, and so these can
|
92
|
+
end up being closed without being resolved if needed information isn't
|
93
|
+
supplied.
|
94
|
+
|
95
|
+
wxruby-development is a secondary mailing list for all those interested
|
96
|
+
in the current and future development of wxRuby. The discussion on this
|
97
|
+
list tends to deal more with the internals of the library.
|
98
|
+
|
99
|
+
== How can I learn to use wxRuby?
|
100
|
+
|
101
|
+
wxRuby is a large API and takes some time to learn. The wxRuby
|
102
|
+
distribution comes with numerous samples which illustrate how to use
|
103
|
+
many specific parts of the API. A good one to start with is the
|
104
|
+
'minimal' sample, which provides an application skeleton. All the
|
105
|
+
bundled samples are expected to work with current wxRuby 2.0, although
|
106
|
+
some use a more modern coding style than others.
|
107
|
+
|
108
|
+
Complete wxRuby API documentation can downloaded separately; this tends
|
109
|
+
to focus on how to use specific classes and methods, rather than on how
|
110
|
+
to construct an application overall.
|
111
|
+
|
112
|
+
There are also tutorials on the wiki, as well as on third-party
|
113
|
+
websites. These typically provide in-depth view of a particular topic,
|
114
|
+
but some may be out-of-date.
|
115
|
+
|
116
|
+
One of the advantages of wxRuby is the much larger ecosystem of
|
117
|
+
wxWidgets and wxPython resources out there. There is a book for
|
118
|
+
wxWidgets,"Cross-Platform Programming in wxWidgets", whcih can be freely
|
119
|
+
downloaded as a PDF. This provides very comprehensive coverage of the
|
120
|
+
wxWidgets API in C++. The code may not be directly useful, but the
|
121
|
+
descriptions of how widgets and events and so forth work are almost
|
122
|
+
always relevant to wxRuby.
|
123
|
+
|
124
|
+
When using a search engine to find answers about a wxRuby class, it can
|
125
|
+
be worth searching for the same term but with 'wx' prepended. For
|
126
|
+
example, if you wanted answers about the "Grid" class, try searching for
|
127
|
+
"wxGrid" as this will turn up results relating to wxWidgets and wxPython
|
128
|
+
which may be relevant.
|
129
|
+
|
130
|
+
== What wxWidgets features are supported by wxRuby?
|
131
|
+
|
132
|
+
wxRuby supports almost all of the wxWidgets 2.8.9 GUI API, around 300
|
133
|
+
classes in total. wxWidgets classes that provide general programming
|
134
|
+
support features, such as strings, networking, threading and database
|
135
|
+
access are not and will never be ported, as it's assumed that in all
|
136
|
+
these cases it's preferable to use a Ruby library.
|
137
|
+
|
138
|
+
If you know of a feature in wxWidgets that you would like to see
|
139
|
+
supported in wxRuby
|
140
|
+
|
141
|
+
== How does wxRuby 2.0 relate to the wxruby 0.6.0 release?
|
142
|
+
|
143
|
+
wxRuby 0.6.0 was the last in a series of releases developed using a
|
144
|
+
different approach in the early days of wxRuby. Work on this series
|
145
|
+
stopped in early 2005, in favour of what is now wxRuby 2.0. Several
|
146
|
+
years of development have gone into wxRuby since, making it vastly more
|
147
|
+
capable and correct than the 0.6.0 release, which is only offered for
|
148
|
+
legacy applications.
|
149
|
+
|
150
|
+
== I am getting an error trying to install or compile wxRuby
|
151
|
+
|
152
|
+
Please double-check the INSTALL documents, and search the mailing list
|
153
|
+
archives. If this doesn't help, please post your question on the wxruby
|
154
|
+
mailing list (http://wxruby.rubyforge.org/wiki/wiki.pl?MailingLists)
|
155
|
+
|
156
|
+
= Credits
|
157
|
+
|
158
|
+
Kevin Smith established the wxRuby 2.0 project using SWIG in 2005. Since
|
159
|
+
then it has benefitted from the input of dozens of volunteers, who have
|
160
|
+
contributed code, documentation, testing, bug reports and feature
|
161
|
+
requests.
|
162
|
+
|
163
|
+
The alphabetic list shows (some of) those who've contributed code to
|
164
|
+
wxRuby 2.0.
|
165
|
+
|
166
|
+
Albin Holmgren
|
167
|
+
Alex Fenton
|
168
|
+
Artur Kuptel
|
169
|
+
Cezar Espinola
|
170
|
+
Chauk-Mean Proum
|
171
|
+
Christophe Bludau
|
172
|
+
Curt Hibbs
|
173
|
+
Dale Edmons
|
174
|
+
Daniel Savarese
|
175
|
+
David Whetstone
|
176
|
+
Dirk Traulsen
|
177
|
+
Hawley Waldman
|
178
|
+
Jani Monoses
|
179
|
+
Joe Seeley
|
180
|
+
Jonathan Maasland
|
181
|
+
Kevin Smith
|
182
|
+
Mario Steele
|
183
|
+
Nic
|
184
|
+
Pascal Hurni
|
185
|
+
Robert Carlin
|
186
|
+
Roy Sutton
|
187
|
+
Ryuichi Sakamoto
|
188
|
+
Sean Lindsay
|
189
|
+
Sean Long
|
190
|
+
Tobias Gruetzmacher
|
191
|
+
Zach Dennis
|
192
|
+
|
193
|
+
If your name is missing and should be here, please get in touch
|
194
|
+
with the current development team.
|
195
|
+
|
196
|
+
== Lead Maintainer
|
197
|
+
|
198
|
+
Alex Fenton: alex at pressure dot to
|