wxruby64 2.0.1-x64-mingw32

Sign up to get free protection for your applications and to get access to all the features.
Files changed (279) hide show
  1. checksums.yaml +7 -0
  2. data/INSTALL +254 -0
  3. data/LICENSE +53 -0
  4. data/README +198 -0
  5. data/art/wxruby-128x128.png +0 -0
  6. data/art/wxruby-256x256.png +0 -0
  7. data/art/wxruby-64x64.png +0 -0
  8. data/art/wxruby.png +0 -0
  9. data/lib/wx.rb +53 -0
  10. data/lib/wx/accessors.rb +68 -0
  11. data/lib/wx/classes/acceleratortable.rb +28 -0
  12. data/lib/wx/classes/animation.rb +18 -0
  13. data/lib/wx/classes/app.rb +51 -0
  14. data/lib/wx/classes/artprovider.rb +31 -0
  15. data/lib/wx/classes/auinotebook.rb +9 -0
  16. data/lib/wx/classes/bitmap.rb +59 -0
  17. data/lib/wx/classes/busycursor.rb +12 -0
  18. data/lib/wx/classes/checklistbox.rb +46 -0
  19. data/lib/wx/classes/choice.rb +4 -0
  20. data/lib/wx/classes/clientdc.rb +13 -0
  21. data/lib/wx/classes/clipboard.rb +56 -0
  22. data/lib/wx/classes/colour.rb +49 -0
  23. data/lib/wx/classes/combobox.rb +4 -0
  24. data/lib/wx/classes/commandevent.rb +7 -0
  25. data/lib/wx/classes/controlwithitems.rb +10 -0
  26. data/lib/wx/classes/data_object.rb +14 -0
  27. data/lib/wx/classes/data_object_simple.rb +6 -0
  28. data/lib/wx/classes/dataformat.rb +23 -0
  29. data/lib/wx/classes/dc.rb +57 -0
  30. data/lib/wx/classes/event.rb +5 -0
  31. data/lib/wx/classes/evthandler.rb +1039 -0
  32. data/lib/wx/classes/font.rb +118 -0
  33. data/lib/wx/classes/functions.rb +44 -0
  34. data/lib/wx/classes/gauge.rb +12 -0
  35. data/lib/wx/classes/genericdirctrl.rb +36 -0
  36. data/lib/wx/classes/grid.rb +146 -0
  37. data/lib/wx/classes/hboxsizer.rb +6 -0
  38. data/lib/wx/classes/helpcontroller.rb +5 -0
  39. data/lib/wx/classes/helpcontrollerhelpprovider.rb +23 -0
  40. data/lib/wx/classes/helpprovider.rb +15 -0
  41. data/lib/wx/classes/htmlhelpcontroller.rb +5 -0
  42. data/lib/wx/classes/htmlwindow.rb +14 -0
  43. data/lib/wx/classes/icon.rb +32 -0
  44. data/lib/wx/classes/iconbundle.rb +3 -0
  45. data/lib/wx/classes/image.rb +53 -0
  46. data/lib/wx/classes/imagelist.rb +3 -0
  47. data/lib/wx/classes/listbox.rb +4 -0
  48. data/lib/wx/classes/listctrl.rb +33 -0
  49. data/lib/wx/classes/locale.rb +28 -0
  50. data/lib/wx/classes/mediactrl.rb +48 -0
  51. data/lib/wx/classes/menu.rb +62 -0
  52. data/lib/wx/classes/menuitem.rb +7 -0
  53. data/lib/wx/classes/notebook.rb +9 -0
  54. data/lib/wx/classes/object.rb +14 -0
  55. data/lib/wx/classes/paintdc.rb +12 -0
  56. data/lib/wx/classes/point.rb +56 -0
  57. data/lib/wx/classes/previewframe.rb +13 -0
  58. data/lib/wx/classes/rect.rb +19 -0
  59. data/lib/wx/classes/richtextctrl.rb +63 -0
  60. data/lib/wx/classes/simplehelpprovider.rb +38 -0
  61. data/lib/wx/classes/size.rb +58 -0
  62. data/lib/wx/classes/sizer.rb +43 -0
  63. data/lib/wx/classes/sound.rb +23 -0
  64. data/lib/wx/classes/splitterwindow.rb +10 -0
  65. data/lib/wx/classes/standardpaths.rb +9 -0
  66. data/lib/wx/classes/styledtextctrl.rb +92 -0
  67. data/lib/wx/classes/textctrl.rb +14 -0
  68. data/lib/wx/classes/texturlevent.rb +18 -0
  69. data/lib/wx/classes/timer.rb +96 -0
  70. data/lib/wx/classes/toolbar.rb +36 -0
  71. data/lib/wx/classes/toolbartool.rb +4 -0
  72. data/lib/wx/classes/treectrl.rb +44 -0
  73. data/lib/wx/classes/validator.rb +7 -0
  74. data/lib/wx/classes/vboxsizer.rb +6 -0
  75. data/lib/wx/classes/window.rb +89 -0
  76. data/lib/wx/classes/xmlresource.rb +54 -0
  77. data/lib/wx/helpers.rb +54 -0
  78. data/lib/wx/keyword_ctors.rb +204 -0
  79. data/lib/wx/keyword_defs.rb +585 -0
  80. data/lib/wx/version.rb +3 -0
  81. data/lib/wxruby2.so +0 -0
  82. data/samples/SAMPLES-LICENSE.TXT +18 -0
  83. data/samples/aui/aui.rb +1356 -0
  84. data/samples/bigdemo/About.rbw +39 -0
  85. data/samples/bigdemo/ColorPanel.rbw +23 -0
  86. data/samples/bigdemo/GridSimple.rbw +78 -0
  87. data/samples/bigdemo/MDIDemo.rbw +57 -0
  88. data/samples/bigdemo/PopupMenu.rbw +149 -0
  89. data/samples/bigdemo/ShapedWindow.rbw +128 -0
  90. data/samples/bigdemo/Sizers.rbw +543 -0
  91. data/samples/bigdemo/bigdemo.rb +823 -0
  92. data/samples/bigdemo/demoTemplate.rbw +33 -0
  93. data/samples/bigdemo/helpfile.htb +0 -0
  94. data/samples/bigdemo/icons/Test 015.jpg +0 -0
  95. data/samples/bigdemo/icons/Test 015.png +0 -0
  96. data/samples/bigdemo/icons/choice.bmp +0 -0
  97. data/samples/bigdemo/icons/choice.xpm +27 -0
  98. data/samples/bigdemo/icons/combo.bmp +0 -0
  99. data/samples/bigdemo/icons/combo.xpm +27 -0
  100. data/samples/bigdemo/icons/copy.xpm +25 -0
  101. data/samples/bigdemo/icons/cut.xpm +24 -0
  102. data/samples/bigdemo/icons/gauge.bmp +0 -0
  103. data/samples/bigdemo/icons/gauge.xpm +27 -0
  104. data/samples/bigdemo/icons/help.xpm +25 -0
  105. data/samples/bigdemo/icons/list.bmp +0 -0
  106. data/samples/bigdemo/icons/list.xpm +27 -0
  107. data/samples/bigdemo/icons/mondrian.ico +0 -0
  108. data/samples/bigdemo/icons/mondrian.xpm +44 -0
  109. data/samples/bigdemo/icons/new.xpm +24 -0
  110. data/samples/bigdemo/icons/ogl.ico +0 -0
  111. data/samples/bigdemo/icons/ogl.xpm +45 -0
  112. data/samples/bigdemo/icons/open.xpm +26 -0
  113. data/samples/bigdemo/icons/paste.bmp +0 -0
  114. data/samples/bigdemo/icons/paste.xpm +38 -0
  115. data/samples/bigdemo/icons/pointy.png +0 -0
  116. data/samples/bigdemo/icons/preview.xpm +26 -0
  117. data/samples/bigdemo/icons/print.xpm +26 -0
  118. data/samples/bigdemo/icons/radio.bmp +0 -0
  119. data/samples/bigdemo/icons/radio.xpm +27 -0
  120. data/samples/bigdemo/icons/robert.xpm +415 -0
  121. data/samples/bigdemo/icons/sashtest.ico +0 -0
  122. data/samples/bigdemo/icons/save.xpm +25 -0
  123. data/samples/bigdemo/icons/smiles.bmp +0 -0
  124. data/samples/bigdemo/icons/smiles.xpm +39 -0
  125. data/samples/bigdemo/icons/smiley.ico +0 -0
  126. data/samples/bigdemo/icons/smiley.xpm +42 -0
  127. data/samples/bigdemo/icons/stattext.xpm +24 -0
  128. data/samples/bigdemo/icons/test2.bmp +0 -0
  129. data/samples/bigdemo/icons/test2.png +0 -0
  130. data/samples/bigdemo/icons/test2.xpm +79 -0
  131. data/samples/bigdemo/icons/text.bmp +0 -0
  132. data/samples/bigdemo/icons/text.xpm +27 -0
  133. data/samples/bigdemo/icons/tog1.bmp +0 -0
  134. data/samples/bigdemo/icons/tog1.xpm +38 -0
  135. data/samples/bigdemo/icons/tog2.bmp +0 -0
  136. data/samples/bigdemo/icons/tog2.xpm +38 -0
  137. data/samples/bigdemo/icons/wxruby-128x128.png +0 -0
  138. data/samples/bigdemo/icons/wxwin.ico +0 -0
  139. data/samples/bigdemo/icons/wxwin16x16.png +0 -0
  140. data/samples/bigdemo/icons/wxwin16x16.xpm +25 -0
  141. data/samples/bigdemo/icons/wxwin32x32.png +0 -0
  142. data/samples/bigdemo/icons/wxwin48x48.png +0 -0
  143. data/samples/bigdemo/run.rb +90 -0
  144. data/samples/bigdemo/tips.txt +7 -0
  145. data/samples/bigdemo/utils.rb +12 -0
  146. data/samples/bigdemo/wxArtProvider.rbw +281 -0
  147. data/samples/bigdemo/wxBitmapButton.rbw +65 -0
  148. data/samples/bigdemo/wxButton.rbw +64 -0
  149. data/samples/bigdemo/wxCalendarCtrl.rbw +60 -0
  150. data/samples/bigdemo/wxCheckBox.rbw +50 -0
  151. data/samples/bigdemo/wxCheckListBox.rbw +65 -0
  152. data/samples/bigdemo/wxChoice.rbw +47 -0
  153. data/samples/bigdemo/wxChoicebook.rbw +78 -0
  154. data/samples/bigdemo/wxColourDialog.rbw +31 -0
  155. data/samples/bigdemo/wxComboBox.rbw +77 -0
  156. data/samples/bigdemo/wxCursor.rbw +136 -0
  157. data/samples/bigdemo/wxDialog.rbw +74 -0
  158. data/samples/bigdemo/wxDirDialog.rbw +29 -0
  159. data/samples/bigdemo/wxDragImage.rbw +70 -0
  160. data/samples/bigdemo/wxFileDialog.rbw +37 -0
  161. data/samples/bigdemo/wxFileDialog_Save.rbw +35 -0
  162. data/samples/bigdemo/wxFindReplaceDialog.rbw +82 -0
  163. data/samples/bigdemo/wxFontDialog.rbw +173 -0
  164. data/samples/bigdemo/wxFrame.rbw +53 -0
  165. data/samples/bigdemo/wxGauge.rbw +71 -0
  166. data/samples/bigdemo/wxGenericDirCtrl.rbw +74 -0
  167. data/samples/bigdemo/wxGrid.rbw +66 -0
  168. data/samples/bigdemo/wxHtmlHelpController.rbw +52 -0
  169. data/samples/bigdemo/wxListBox.rbw +140 -0
  170. data/samples/bigdemo/wxListCtrl_virtual.rbw +112 -0
  171. data/samples/bigdemo/wxMDIWindows.rbw +50 -0
  172. data/samples/bigdemo/wxMenu.rbw +236 -0
  173. data/samples/bigdemo/wxMessageDialog.rbw +27 -0
  174. data/samples/bigdemo/wxMiniFrame.rbw +70 -0
  175. data/samples/bigdemo/wxMultipleChoiceDialog.rbw +32 -0
  176. data/samples/bigdemo/wxNotebook.rbw +136 -0
  177. data/samples/bigdemo/wxProgressDialog.rbw +43 -0
  178. data/samples/bigdemo/wxRadioBox.rbw +72 -0
  179. data/samples/bigdemo/wxRadioButton.rbw +125 -0
  180. data/samples/bigdemo/wxSashWindow.rbw +141 -0
  181. data/samples/bigdemo/wxScrolledMessageDialog.rbw +57 -0
  182. data/samples/bigdemo/wxScrolledWindow.rbw +199 -0
  183. data/samples/bigdemo/wxSingleChoiceDialog.rbw +33 -0
  184. data/samples/bigdemo/wxSlider.rbw +42 -0
  185. data/samples/bigdemo/wxSpinButton.rbw +50 -0
  186. data/samples/bigdemo/wxSpinCtrl.rbw +51 -0
  187. data/samples/bigdemo/wxSplitterWindow.rbw +63 -0
  188. data/samples/bigdemo/wxStaticBitmap.rbw +47 -0
  189. data/samples/bigdemo/wxStaticText.rbw +55 -0
  190. data/samples/bigdemo/wxStatusBar.rbw +126 -0
  191. data/samples/bigdemo/wxTextCtrl.rbw +149 -0
  192. data/samples/bigdemo/wxTextEntryDialog.rbw +31 -0
  193. data/samples/bigdemo/wxToggleButton.rbw +49 -0
  194. data/samples/bigdemo/wxToolBar.rbw +131 -0
  195. data/samples/bigdemo/wxTreeCtrl.rbw +191 -0
  196. data/samples/calendar/calendar.rb +348 -0
  197. data/samples/caret/caret.rb +282 -0
  198. data/samples/caret/mondrian.xpm +44 -0
  199. data/samples/controls/controls.rb +1136 -0
  200. data/samples/controls/get_item_sample.rb +87 -0
  201. data/samples/controls/icons/choice.xpm +27 -0
  202. data/samples/controls/icons/combo.xpm +27 -0
  203. data/samples/controls/icons/gauge.xpm +27 -0
  204. data/samples/controls/icons/list.xpm +27 -0
  205. data/samples/controls/icons/radio.xpm +27 -0
  206. data/samples/controls/icons/stattext.xpm +24 -0
  207. data/samples/controls/icons/text.xpm +27 -0
  208. data/samples/controls/mondrian.ico +0 -0
  209. data/samples/controls/mondrian.xpm +44 -0
  210. data/samples/controls/test2.bmp +0 -0
  211. data/samples/dialogs/dialogs.rb +797 -0
  212. data/samples/dialogs/tips.txt +18 -0
  213. data/samples/dragdrop/dragdrop.rb +177 -0
  214. data/samples/drawing/bitmap.rb +49 -0
  215. data/samples/drawing/bitmap_image.rb +92 -0
  216. data/samples/drawing/graphics_drawing.rb +235 -0
  217. data/samples/drawing/maths_images.rb +265 -0
  218. data/samples/drawing/rmagic_bitmap_image.rb +110 -0
  219. data/samples/drawing/ruby-logo.jpg +0 -0
  220. data/samples/etc/activation.rb +102 -0
  221. data/samples/etc/choice.rb +67 -0
  222. data/samples/etc/miniframe.rb +79 -0
  223. data/samples/etc/sash.rb +130 -0
  224. data/samples/etc/scrollwin.rb +110 -0
  225. data/samples/etc/system_settings.rb +252 -0
  226. data/samples/etc/threaded.rb +72 -0
  227. data/samples/etc/toolbar_sizer_additem.rb +55 -0
  228. data/samples/etc/wizard.rb +74 -0
  229. data/samples/event/event.rb +182 -0
  230. data/samples/event/update_ui_event.rb +70 -0
  231. data/samples/grid/grid.rb +198 -0
  232. data/samples/grid/gridtablebase.rb +148 -0
  233. data/samples/html/html.rb +262 -0
  234. data/samples/listbook/listbook.rb +174 -0
  235. data/samples/listbook/listbook.xrc +370 -0
  236. data/samples/mdi/mdi.rb +85 -0
  237. data/samples/media/mediactrl.rb +167 -0
  238. data/samples/minimal/minimal.rb +77 -0
  239. data/samples/minimal/mondrian.ico +0 -0
  240. data/samples/minimal/mondrian.png +0 -0
  241. data/samples/minimal/nothing.rb +16 -0
  242. data/samples/opengl/cube.rb +130 -0
  243. data/samples/opengl/cube_anim_lighting.rb +191 -0
  244. data/samples/printing/mondrian.ico +0 -0
  245. data/samples/printing/mondrian.xpm +44 -0
  246. data/samples/printing/printing.rb +487 -0
  247. data/samples/sockets/SocketPackets.rb +27 -0
  248. data/samples/sockets/res/message-new.png +0 -0
  249. data/samples/sockets/res/user.png +0 -0
  250. data/samples/sockets/wxClient.rb +395 -0
  251. data/samples/sockets/wxServer.rb +422 -0
  252. data/samples/sockets/wxSocketGUI.rb +97 -0
  253. data/samples/text/document-open.png +0 -0
  254. data/samples/text/document-save.png +0 -0
  255. data/samples/text/edit-copy.png +0 -0
  256. data/samples/text/edit-cut.png +0 -0
  257. data/samples/text/edit-paste.png +0 -0
  258. data/samples/text/edit-redo.png +0 -0
  259. data/samples/text/edit-undo.png +0 -0
  260. data/samples/text/format-text-bold.png +0 -0
  261. data/samples/text/format-text-italic.png +0 -0
  262. data/samples/text/format-text-underline.png +0 -0
  263. data/samples/text/mondrian.ico +0 -0
  264. data/samples/text/mondrian.xpm +44 -0
  265. data/samples/text/preferences-desktop-font.png +0 -0
  266. data/samples/text/rich_textctrl.rb +290 -0
  267. data/samples/text/scintilla.rb +169 -0
  268. data/samples/text/textctrl.rb +111 -0
  269. data/samples/text/unicode.rb +242 -0
  270. data/samples/text/utf8.txt +15 -0
  271. data/samples/treectrl/icon1.xpm +79 -0
  272. data/samples/treectrl/icon2.xpm +53 -0
  273. data/samples/treectrl/icon3.xpm +79 -0
  274. data/samples/treectrl/icon4.xpm +43 -0
  275. data/samples/treectrl/icon5.xpm +79 -0
  276. data/samples/treectrl/treectrl.rb +1166 -0
  277. data/samples/xrc/samples.xrc +46 -0
  278. data/samples/xrc/xrc_sample.rb +76 -0
  279. metadata +330 -0
@@ -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