fxruby 1.6.19 → 1.6.20

Sign up to get free protection for your applications and to get access to all the features.
Files changed (633) hide show
  1. data/History.txt +10 -0
  2. data/Manifest.txt +922 -0
  3. data/{LICENSE → README.txt} +27 -1
  4. data/Rakefile +191 -0
  5. data/TODO +47 -0
  6. data/doap.rdf +87 -0
  7. data/examples/icons/bluebullet14x14.gif +0 -0
  8. data/examples/icons/transpbullet14x14.gif +0 -0
  9. data/ext/fox16/FXRbApp.cpp +2 -2
  10. data/ext/fox16/FXRbDataTarget.cpp +2 -2
  11. data/ext/fox16/FXRbGLViewer.cpp +2 -2
  12. data/ext/fox16/FXRuby.cpp +7 -3
  13. data/ext/fox16/extconf.rb +18 -85
  14. data/ext/fox16/impl.cpp +0 -0
  15. data/ext/fox16/include/FXMemoryBuffer.h +2 -2
  16. data/ext/fox16/include/FXRb4Splitter.h +2 -2
  17. data/ext/fox16/include/FXRb7Segment.h +2 -2
  18. data/ext/fox16/include/FXRbAccelTable.h +2 -2
  19. data/ext/fox16/include/FXRbApp.h +2 -2
  20. data/ext/fox16/include/FXRbAppVirtuals.h +0 -0
  21. data/ext/fox16/include/FXRbArrowButton.h +2 -2
  22. data/ext/fox16/include/FXRbBMPIcon.h +2 -2
  23. data/ext/fox16/include/FXRbBMPImage.h +2 -2
  24. data/ext/fox16/include/FXRbBitmap.h +2 -2
  25. data/ext/fox16/include/FXRbBitmapFrame.h +1 -1
  26. data/ext/fox16/include/FXRbBitmapView.h +2 -2
  27. data/ext/fox16/include/FXRbBitmapVirtuals.h +0 -0
  28. data/ext/fox16/include/FXRbButton.h +2 -2
  29. data/ext/fox16/include/FXRbCURCursor.h +2 -2
  30. data/ext/fox16/include/FXRbCanvas.h +2 -2
  31. data/ext/fox16/include/FXRbCheckButton.h +2 -2
  32. data/ext/fox16/include/FXRbChoiceBox.h +1 -1
  33. data/ext/fox16/include/FXRbColorBar.h +2 -2
  34. data/ext/fox16/include/FXRbColorDialog.h +2 -2
  35. data/ext/fox16/include/FXRbColorList.h +2 -2
  36. data/ext/fox16/include/FXRbColorRing.h +2 -2
  37. data/ext/fox16/include/FXRbColorSelector.h +2 -2
  38. data/ext/fox16/include/FXRbColorWell.h +2 -2
  39. data/ext/fox16/include/FXRbColorWheel.h +2 -2
  40. data/ext/fox16/include/FXRbComboBox.h +2 -2
  41. data/ext/fox16/include/FXRbCommon.h +2 -2
  42. data/ext/fox16/include/FXRbComposite.h +2 -2
  43. data/ext/fox16/include/FXRbCursor.h +2 -2
  44. data/ext/fox16/include/FXRbCursorVirtuals.h +0 -0
  45. data/ext/fox16/include/FXRbDC.h +2 -2
  46. data/ext/fox16/include/FXRbDCPrint.h +2 -2
  47. data/ext/fox16/include/FXRbDCVirtuals.h +0 -0
  48. data/ext/fox16/include/FXRbDCWindow.h +2 -2
  49. data/ext/fox16/include/FXRbDataTarget.h +2 -2
  50. data/ext/fox16/include/FXRbDebugTarget.h +2 -2
  51. data/ext/fox16/include/FXRbDelegator.h +2 -2
  52. data/ext/fox16/include/FXRbDial.h +2 -2
  53. data/ext/fox16/include/FXRbDialogBox.h +2 -2
  54. data/ext/fox16/include/FXRbDialogBoxVirtuals.h +0 -0
  55. data/ext/fox16/include/FXRbDict.h +2 -2
  56. data/ext/fox16/include/FXRbDirBox.h +2 -2
  57. data/ext/fox16/include/FXRbDirDialog.h +2 -2
  58. data/ext/fox16/include/FXRbDirList.h +2 -2
  59. data/ext/fox16/include/FXRbDirSelector.h +2 -2
  60. data/ext/fox16/include/FXRbDockBar.h +1 -1
  61. data/ext/fox16/include/FXRbDockBarVirtuals.h +0 -0
  62. data/ext/fox16/include/FXRbDockHandler.h +2 -2
  63. data/ext/fox16/include/FXRbDockSite.h +0 -0
  64. data/ext/fox16/include/FXRbDockSiteVirtuals.h +0 -0
  65. data/ext/fox16/include/FXRbDockTitle.h +2 -2
  66. data/ext/fox16/include/FXRbDocument.h +2 -2
  67. data/ext/fox16/include/FXRbDragCorner.h +2 -2
  68. data/ext/fox16/include/FXRbDrawable.h +2 -2
  69. data/ext/fox16/include/FXRbDrawableVirtuals.h +0 -0
  70. data/ext/fox16/include/FXRbDriveBox.h +2 -2
  71. data/ext/fox16/include/FXRbFileDialog.h +2 -2
  72. data/ext/fox16/include/FXRbFileDict.h +2 -2
  73. data/ext/fox16/include/FXRbFileDictVirtuals.h +0 -0
  74. data/ext/fox16/include/FXRbFileList.h +2 -2
  75. data/ext/fox16/include/FXRbFileSelector.h +2 -2
  76. data/ext/fox16/include/FXRbFoldingItemVirtuals.h +0 -0
  77. data/ext/fox16/include/FXRbFoldingList.h +2 -2
  78. data/ext/fox16/include/FXRbFoldingListVirtuals.h +0 -0
  79. data/ext/fox16/include/FXRbFont.h +2 -2
  80. data/ext/fox16/include/FXRbFontDialog.h +2 -2
  81. data/ext/fox16/include/FXRbFontSelector.h +2 -2
  82. data/ext/fox16/include/FXRbFontVirtuals.h +0 -0
  83. data/ext/fox16/include/FXRbFrame.h +2 -2
  84. data/ext/fox16/include/FXRbGIFCursor.h +2 -2
  85. data/ext/fox16/include/FXRbGIFIcon.h +2 -2
  86. data/ext/fox16/include/FXRbGIFImage.h +2 -2
  87. data/ext/fox16/include/FXRbGLCanvas.h +2 -2
  88. data/ext/fox16/include/FXRbGLCanvasVirtuals.h +0 -0
  89. data/ext/fox16/include/FXRbGLContext.h +2 -2
  90. data/ext/fox16/include/FXRbGLObject.h +2 -2
  91. data/ext/fox16/include/FXRbGLObjectVirtuals.h +0 -0
  92. data/ext/fox16/include/FXRbGLShape.h +2 -2
  93. data/ext/fox16/include/FXRbGLShapeVirtuals.h +0 -0
  94. data/ext/fox16/include/FXRbGLViewer.h +2 -2
  95. data/ext/fox16/include/FXRbGLViewerVirtuals.h +0 -0
  96. data/ext/fox16/include/FXRbGLVisual.h +2 -2
  97. data/ext/fox16/include/FXRbGradientBar.h +1 -1
  98. data/ext/fox16/include/FXRbGroupBox.h +2 -2
  99. data/ext/fox16/include/FXRbHeader.h +2 -2
  100. data/ext/fox16/include/FXRbHeaderItemVirtuals.h +0 -0
  101. data/ext/fox16/include/FXRbHorizontalFrame.h +2 -2
  102. data/ext/fox16/include/FXRbICOIcon.h +2 -2
  103. data/ext/fox16/include/FXRbICOImage.h +2 -2
  104. data/ext/fox16/include/FXRbIcon.h +2 -2
  105. data/ext/fox16/include/FXRbIconItemVirtuals.h +0 -0
  106. data/ext/fox16/include/FXRbIconList.h +2 -2
  107. data/ext/fox16/include/FXRbIconListVirtuals.h +0 -0
  108. data/ext/fox16/include/FXRbIconSource.h +2 -2
  109. data/ext/fox16/include/FXRbIconSourceVirtuals.h +0 -0
  110. data/ext/fox16/include/FXRbId.h +2 -2
  111. data/ext/fox16/include/FXRbIdVirtuals.h +0 -0
  112. data/ext/fox16/include/FXRbImage.h +2 -2
  113. data/ext/fox16/include/FXRbImageFrame.h +1 -1
  114. data/ext/fox16/include/FXRbImageView.h +2 -2
  115. data/ext/fox16/include/FXRbImageVirtuals.h +0 -0
  116. data/ext/fox16/include/FXRbInputDialog.h +2 -2
  117. data/ext/fox16/include/FXRbJPGIcon.h +2 -2
  118. data/ext/fox16/include/FXRbJPGImage.h +2 -2
  119. data/ext/fox16/include/FXRbKnob.h +2 -2
  120. data/ext/fox16/include/FXRbLabel.h +2 -2
  121. data/ext/fox16/include/FXRbList.h +2 -2
  122. data/ext/fox16/include/FXRbListBox.h +2 -2
  123. data/ext/fox16/include/FXRbListBoxVirtuals.h +0 -0
  124. data/ext/fox16/include/FXRbListItemVirtuals.h +0 -0
  125. data/ext/fox16/include/FXRbListVirtuals.h +0 -0
  126. data/ext/fox16/include/FXRbMDIButton.h +2 -2
  127. data/ext/fox16/include/FXRbMDIChild.h +2 -2
  128. data/ext/fox16/include/FXRbMDIChildVirtuals.h +0 -0
  129. data/ext/fox16/include/FXRbMDIClient.h +2 -2
  130. data/ext/fox16/include/FXRbMDIClientVirtuals.h +0 -0
  131. data/ext/fox16/include/FXRbMainWindow.h +2 -2
  132. data/ext/fox16/include/FXRbMatrix.h +2 -2
  133. data/ext/fox16/include/FXRbMenuBar.h +1 -1
  134. data/ext/fox16/include/FXRbMenuButton.h +2 -2
  135. data/ext/fox16/include/FXRbMenuCaption.h +2 -2
  136. data/ext/fox16/include/FXRbMenuCascade.h +2 -2
  137. data/ext/fox16/include/FXRbMenuCheck.h +1 -1
  138. data/ext/fox16/include/FXRbMenuCommand.h +2 -2
  139. data/ext/fox16/include/FXRbMenuPane.h +2 -2
  140. data/ext/fox16/include/FXRbMenuRadio.h +1 -1
  141. data/ext/fox16/include/FXRbMenuSeparator.h +2 -2
  142. data/ext/fox16/include/FXRbMenuTitle.h +2 -2
  143. data/ext/fox16/include/FXRbMessageBox.h +2 -2
  144. data/ext/fox16/include/FXRbObject.h +2 -2
  145. data/ext/fox16/include/FXRbObjectVirtuals.h +0 -0
  146. data/ext/fox16/include/FXRbOptionMenu.h +2 -2
  147. data/ext/fox16/include/FXRbPCXIcon.h +2 -2
  148. data/ext/fox16/include/FXRbPCXImage.h +2 -2
  149. data/ext/fox16/include/FXRbPNGIcon.h +2 -2
  150. data/ext/fox16/include/FXRbPNGImage.h +2 -2
  151. data/ext/fox16/include/FXRbPPMIcon.h +2 -2
  152. data/ext/fox16/include/FXRbPPMImage.h +2 -2
  153. data/ext/fox16/include/FXRbPacker.h +2 -2
  154. data/ext/fox16/include/FXRbPicker.h +2 -2
  155. data/ext/fox16/include/FXRbPopup.h +2 -2
  156. data/ext/fox16/include/FXRbPopupVirtuals.h +0 -0
  157. data/ext/fox16/include/FXRbPrintDialog.h +2 -2
  158. data/ext/fox16/include/FXRbProgressBar.h +2 -2
  159. data/ext/fox16/include/FXRbProgressDialog.h +2 -2
  160. data/ext/fox16/include/FXRbRGBIcon.h +2 -2
  161. data/ext/fox16/include/FXRbRGBImage.h +2 -2
  162. data/ext/fox16/include/FXRbRadioButton.h +2 -2
  163. data/ext/fox16/include/FXRbRealSlider.h +2 -2
  164. data/ext/fox16/include/FXRbRealSpinner.h +2 -2
  165. data/ext/fox16/include/FXRbRealSpinnerVirtuals.h +0 -0
  166. data/ext/fox16/include/FXRbRecentFiles.h +2 -2
  167. data/ext/fox16/include/FXRbRegistry.h +2 -2
  168. data/ext/fox16/include/FXRbReplaceDialog.h +2 -2
  169. data/ext/fox16/include/FXRbRootWindow.h +2 -2
  170. data/ext/fox16/include/FXRbRuler.h +1 -1
  171. data/ext/fox16/include/FXRbRulerView.h +1 -1
  172. data/ext/fox16/include/FXRbScintilla.h +2 -2
  173. data/ext/fox16/include/FXRbScrollArea.h +2 -2
  174. data/ext/fox16/include/FXRbScrollAreaVirtuals.h +0 -0
  175. data/ext/fox16/include/FXRbScrollBar.h +1 -1
  176. data/ext/fox16/include/FXRbScrollPane.h +2 -2
  177. data/ext/fox16/include/FXRbScrollWindow.h +2 -2
  178. data/ext/fox16/include/FXRbSearchDialog.h +2 -2
  179. data/ext/fox16/include/FXRbSeparator.h +2 -2
  180. data/ext/fox16/include/FXRbSettings.h +2 -2
  181. data/ext/fox16/include/FXRbShell.h +2 -2
  182. data/ext/fox16/include/FXRbShutter.h +2 -2
  183. data/ext/fox16/include/FXRbShutterVirtuals.h +0 -0
  184. data/ext/fox16/include/FXRbSlider.h +2 -2
  185. data/ext/fox16/include/FXRbSpinner.h +2 -2
  186. data/ext/fox16/include/FXRbSpinnerVirtuals.h +0 -0
  187. data/ext/fox16/include/FXRbSplashWindow.h +2 -2
  188. data/ext/fox16/include/FXRbSplitter.h +2 -2
  189. data/ext/fox16/include/FXRbSpring.h +2 -2
  190. data/ext/fox16/include/FXRbStatusBar.h +1 -1
  191. data/ext/fox16/include/FXRbStatusLine.h +1 -1
  192. data/ext/fox16/include/FXRbStream.h +2 -2
  193. data/ext/fox16/include/FXRbStreamVirtuals.h +0 -0
  194. data/ext/fox16/include/FXRbStringDict.h +2 -2
  195. data/ext/fox16/include/FXRbSwitcher.h +2 -2
  196. data/ext/fox16/include/FXRbTGAIcon.h +2 -2
  197. data/ext/fox16/include/FXRbTGAImage.h +2 -2
  198. data/ext/fox16/include/FXRbTIFIcon.h +2 -2
  199. data/ext/fox16/include/FXRbTIFImage.h +2 -2
  200. data/ext/fox16/include/FXRbTabBar.h +2 -2
  201. data/ext/fox16/include/FXRbTabBarVirtuals.h +0 -0
  202. data/ext/fox16/include/FXRbTabBook.h +2 -2
  203. data/ext/fox16/include/FXRbTabItem.h +2 -2
  204. data/ext/fox16/include/FXRbTable.h +2 -2
  205. data/ext/fox16/include/FXRbTableItemVirtuals.h +0 -0
  206. data/ext/fox16/include/FXRbTableVirtuals.h +0 -0
  207. data/ext/fox16/include/FXRbText.h +2 -2
  208. data/ext/fox16/include/FXRbTextField.h +2 -2
  209. data/ext/fox16/include/FXRbTextVirtuals.h +0 -0
  210. data/ext/fox16/include/FXRbToggleButton.h +2 -2
  211. data/ext/fox16/include/FXRbToolBar.h +1 -1
  212. data/ext/fox16/include/FXRbToolBarGrip.h +1 -1
  213. data/ext/fox16/include/FXRbToolBarShell.h +1 -1
  214. data/ext/fox16/include/FXRbToolBarTab.h +1 -1
  215. data/ext/fox16/include/FXRbToolTip.h +1 -1
  216. data/ext/fox16/include/FXRbTopWindow.h +2 -2
  217. data/ext/fox16/include/FXRbTopWindowVirtuals.h +0 -0
  218. data/ext/fox16/include/FXRbTranslator.h +2 -2
  219. data/ext/fox16/include/FXRbTranslatorVirtuals.h +0 -0
  220. data/ext/fox16/include/FXRbTreeItemVirtuals.h +0 -0
  221. data/ext/fox16/include/FXRbTreeList.h +2 -2
  222. data/ext/fox16/include/FXRbTreeListBox.h +2 -2
  223. data/ext/fox16/include/FXRbTreeListBoxVirtuals.h +0 -0
  224. data/ext/fox16/include/FXRbTreeListVirtuals.h +0 -0
  225. data/ext/fox16/include/FXRbTriStateButton.h +2 -2
  226. data/ext/fox16/include/FXRbVerticalFrame.h +2 -2
  227. data/ext/fox16/include/FXRbVisual.h +2 -2
  228. data/ext/fox16/include/FXRbWindow.h +2 -2
  229. data/ext/fox16/include/FXRbWindowVirtuals.h +0 -0
  230. data/ext/fox16/include/FXRbWizard.h +1 -1
  231. data/ext/fox16/include/FXRbXBMIcon.h +2 -2
  232. data/ext/fox16/include/FXRbXBMImage.h +2 -2
  233. data/ext/fox16/include/FXRbXPMIcon.h +2 -2
  234. data/ext/fox16/include/FXRbXPMImage.h +2 -2
  235. data/ext/fox16/include/FXRuby.h +2 -2
  236. data/ext/fox16/include/impl.h +2 -2
  237. data/ext/fox16/make_impl.rb +121 -0
  238. data/ext/fox16/markfuncs.cpp +0 -0
  239. data/lib/fox16.rb +8 -0
  240. data/lib/fox16/bitmapview.rb +223 -0
  241. data/lib/fox16/scintilla.rb +103 -3
  242. data/lib/fox16/version.rb +1 -5
  243. data/rdoc-sources/Makefile +23 -0
  244. data/scripts/build-fox.rb +31 -0
  245. data/scripts/generate_kwargs_lib.rb +414 -0
  246. data/scripts/iface.rb +391 -0
  247. data/swig-interfaces/FX4Splitter.i +149 -0
  248. data/swig-interfaces/FX7Segment.i +141 -0
  249. data/swig-interfaces/FXAccelTable.i +100 -0
  250. data/swig-interfaces/FXApp.i +735 -0
  251. data/swig-interfaces/FXArrowButton.i +136 -0
  252. data/swig-interfaces/FXBMPIcon.i +88 -0
  253. data/swig-interfaces/FXBMPImage.i +54 -0
  254. data/swig-interfaces/FXBitmap.i +90 -0
  255. data/swig-interfaces/FXBitmapFrame.i +72 -0
  256. data/swig-interfaces/FXBitmapView.i +94 -0
  257. data/swig-interfaces/FXButton.i +130 -0
  258. data/swig-interfaces/FXCURCursor.i +49 -0
  259. data/swig-interfaces/FXCanvas.i +61 -0
  260. data/swig-interfaces/FXCheckButton.i +108 -0
  261. data/swig-interfaces/FXChoiceBox.i +91 -0
  262. data/swig-interfaces/FXColorBar.i +110 -0
  263. data/swig-interfaces/FXColorDialog.i +79 -0
  264. data/swig-interfaces/FXColorList.i +99 -0
  265. data/swig-interfaces/FXColorRing.i +148 -0
  266. data/swig-interfaces/FXColorSelector.i +157 -0
  267. data/swig-interfaces/FXColorWell.i +133 -0
  268. data/swig-interfaces/FXColorWheel.i +108 -0
  269. data/swig-interfaces/FXComboBox.i +280 -0
  270. data/swig-interfaces/FXComposeContext.i +66 -0
  271. data/swig-interfaces/FXComposite.i +103 -0
  272. data/swig-interfaces/FXCursor.i +120 -0
  273. data/swig-interfaces/FXDC.i +280 -0
  274. data/swig-interfaces/FXDCPrint.i +141 -0
  275. data/swig-interfaces/FXDCWindow.i +75 -0
  276. data/swig-interfaces/FXDataTarget.i +115 -0
  277. data/swig-interfaces/FXDebugTarget.i +60 -0
  278. data/swig-interfaces/FXDelegator.i +56 -0
  279. data/swig-interfaces/FXDial.i +168 -0
  280. data/swig-interfaces/FXDialogBox.i +131 -0
  281. data/swig-interfaces/FXDict.i +200 -0
  282. data/swig-interfaces/FXDirBox.i +68 -0
  283. data/swig-interfaces/FXDirDialog.i +97 -0
  284. data/swig-interfaces/FXDirList.i +274 -0
  285. data/swig-interfaces/FXDirSelector.i +142 -0
  286. data/swig-interfaces/FXDockBar.i +180 -0
  287. data/swig-interfaces/FXDockHandler.i +94 -0
  288. data/swig-interfaces/FXDockSite.i +91 -0
  289. data/swig-interfaces/FXDockTitle.i +91 -0
  290. data/swig-interfaces/FXDocument.i +70 -0
  291. data/swig-interfaces/FXDragCorner.i +72 -0
  292. data/swig-interfaces/FXDrawable.i +90 -0
  293. data/swig-interfaces/FXDriveBox.i +63 -0
  294. data/swig-interfaces/FXExtentd.i +131 -0
  295. data/swig-interfaces/FXExtentf.i +131 -0
  296. data/swig-interfaces/FXFileDialog.i +268 -0
  297. data/swig-interfaces/FXFileDict.i +121 -0
  298. data/swig-interfaces/FXFileList.i +345 -0
  299. data/swig-interfaces/FXFileSelector.i +347 -0
  300. data/swig-interfaces/FXFileStream.i +49 -0
  301. data/swig-interfaces/FXFoldingList.i +556 -0
  302. data/swig-interfaces/FXFont.i +333 -0
  303. data/swig-interfaces/FXFontDialog.i +63 -0
  304. data/swig-interfaces/FXFontSelector.i +127 -0
  305. data/swig-interfaces/FXFrame.i +245 -0
  306. data/swig-interfaces/FXGIFCursor.i +86 -0
  307. data/swig-interfaces/FXGIFIcon.i +54 -0
  308. data/swig-interfaces/FXGIFImage.i +54 -0
  309. data/swig-interfaces/FXGLCanvas.i +90 -0
  310. data/swig-interfaces/FXGLContext.i +85 -0
  311. data/swig-interfaces/FXGLObject.i +70 -0
  312. data/swig-interfaces/FXGLShape.i +152 -0
  313. data/swig-interfaces/FXGLViewer.i +691 -0
  314. data/swig-interfaces/FXGLVisual.i +136 -0
  315. data/swig-interfaces/FXGradientBar.i +310 -0
  316. data/swig-interfaces/FXGroupBox.i +94 -0
  317. data/swig-interfaces/FXHeader.i +432 -0
  318. data/swig-interfaces/FXHorizontalFrame.i +60 -0
  319. data/swig-interfaces/FXICOIcon.i +92 -0
  320. data/swig-interfaces/FXICOImage.i +54 -0
  321. data/swig-interfaces/FXIcon.i +128 -0
  322. data/swig-interfaces/FXIconDict.i +90 -0
  323. data/swig-interfaces/FXIconList.i +596 -0
  324. data/swig-interfaces/FXIconSource.i +55 -0
  325. data/swig-interfaces/FXId.i +103 -0
  326. data/swig-interfaces/FXImage.i +197 -0
  327. data/swig-interfaces/FXImageFrame.i +66 -0
  328. data/swig-interfaces/FXImageView.i +88 -0
  329. data/swig-interfaces/FXInputDialog.i +180 -0
  330. data/swig-interfaces/FXJPGIcon.i +101 -0
  331. data/swig-interfaces/FXJPGImage.i +67 -0
  332. data/swig-interfaces/FXKnob.i +182 -0
  333. data/swig-interfaces/FXLabel.i +199 -0
  334. data/swig-interfaces/FXList.i +476 -0
  335. data/swig-interfaces/FXListBox.i +234 -0
  336. data/swig-interfaces/FXMDIButton.i +173 -0
  337. data/swig-interfaces/FXMDIChild.i +242 -0
  338. data/swig-interfaces/FXMDIClient.i +149 -0
  339. data/swig-interfaces/FXMainWindow.i +53 -0
  340. data/swig-interfaces/FXMat3d.i +102 -0
  341. data/swig-interfaces/FXMat3f.i +102 -0
  342. data/swig-interfaces/FXMat4d.i +122 -0
  343. data/swig-interfaces/FXMat4f.i +138 -0
  344. data/swig-interfaces/FXMatrix.i +101 -0
  345. data/swig-interfaces/FXMemoryBuffer.i +64 -0
  346. data/swig-interfaces/FXMemoryStream.i +73 -0
  347. data/swig-interfaces/FXMenuBar.i +67 -0
  348. data/swig-interfaces/FXMenuButton.i +152 -0
  349. data/swig-interfaces/FXMenuCaption.i +176 -0
  350. data/swig-interfaces/FXMenuCascade.i +76 -0
  351. data/swig-interfaces/FXMenuCheck.i +90 -0
  352. data/swig-interfaces/FXMenuCommand.i +69 -0
  353. data/swig-interfaces/FXMenuPane.i +60 -0
  354. data/swig-interfaces/FXMenuRadio.i +93 -0
  355. data/swig-interfaces/FXMenuSeparator.i +65 -0
  356. data/swig-interfaces/FXMenuTitle.i +74 -0
  357. data/swig-interfaces/FXMessageBox.i +128 -0
  358. data/swig-interfaces/FXObject.i +169 -0
  359. data/swig-interfaces/FXOptionMenu.i +140 -0
  360. data/swig-interfaces/FXPCXIcon.i +91 -0
  361. data/swig-interfaces/FXPCXImage.i +55 -0
  362. data/swig-interfaces/FXPNGIcon.i +95 -0
  363. data/swig-interfaces/FXPNGImage.i +59 -0
  364. data/swig-interfaces/FXPPMIcon.i +91 -0
  365. data/swig-interfaces/FXPPMImage.i +55 -0
  366. data/swig-interfaces/FXPacker.i +255 -0
  367. data/swig-interfaces/FXPicker.i +54 -0
  368. data/swig-interfaces/FXPoint.i +52 -0
  369. data/swig-interfaces/FXPopup.i +162 -0
  370. data/swig-interfaces/FXPrintDialog.i +154 -0
  371. data/swig-interfaces/FXProgressBar.i +133 -0
  372. data/swig-interfaces/FXProgressDialog.i +105 -0
  373. data/swig-interfaces/FXQuatd.i +128 -0
  374. data/swig-interfaces/FXQuatf.i +122 -0
  375. data/swig-interfaces/FXRGBIcon.i +90 -0
  376. data/swig-interfaces/FXRGBImage.i +56 -0
  377. data/swig-interfaces/FXRadioButton.i +117 -0
  378. data/swig-interfaces/FXRanged.i +163 -0
  379. data/swig-interfaces/FXRangef.i +172 -0
  380. data/swig-interfaces/FXRealSlider.i +166 -0
  381. data/swig-interfaces/FXRealSpinner.i +215 -0
  382. data/swig-interfaces/FXRecentFiles.i +119 -0
  383. data/swig-interfaces/FXRectangle.i +104 -0
  384. data/swig-interfaces/FXRegion.i +88 -0
  385. data/swig-interfaces/FXRegistry.i +96 -0
  386. data/swig-interfaces/FXReplaceDialog.i +131 -0
  387. data/swig-interfaces/FXRootWindow.i +50 -0
  388. data/swig-interfaces/FXRuler.i +245 -0
  389. data/swig-interfaces/FXRulerView.i +233 -0
  390. data/swig-interfaces/FXScintilla.i +192 -0
  391. data/swig-interfaces/FXScrollArea.i +211 -0
  392. data/swig-interfaces/FXScrollBar.i +178 -0
  393. data/swig-interfaces/FXScrollPane.i +83 -0
  394. data/swig-interfaces/FXScrollWindow.i +67 -0
  395. data/swig-interfaces/FXSearchDialog.i +48 -0
  396. data/swig-interfaces/FXSeparator.i +138 -0
  397. data/swig-interfaces/FXSettings.i +160 -0
  398. data/swig-interfaces/FXShell.i +91 -0
  399. data/swig-interfaces/FXShutter.i +140 -0
  400. data/swig-interfaces/FXSize.i +71 -0
  401. data/swig-interfaces/FXSlider.i +181 -0
  402. data/swig-interfaces/FXSphered.i +126 -0
  403. data/swig-interfaces/FXSpheref.i +126 -0
  404. data/swig-interfaces/FXSpinner.i +212 -0
  405. data/swig-interfaces/FXSplashWindow.i +82 -0
  406. data/swig-interfaces/FXSplitter.i +123 -0
  407. data/swig-interfaces/FXSpring.i +79 -0
  408. data/swig-interfaces/FXStatusBar.i +68 -0
  409. data/swig-interfaces/FXStatusLine.i +100 -0
  410. data/swig-interfaces/FXStream.i +150 -0
  411. data/swig-interfaces/FXStringDict.i +61 -0
  412. data/swig-interfaces/FXSwitcher.i +110 -0
  413. data/swig-interfaces/FXTGAIcon.i +85 -0
  414. data/swig-interfaces/FXTGAImage.i +56 -0
  415. data/swig-interfaces/FXTIFIcon.i +73 -0
  416. data/swig-interfaces/FXTIFImage.i +93 -0
  417. data/swig-interfaces/FXTabBar.i +121 -0
  418. data/swig-interfaces/FXTabBook.i +70 -0
  419. data/swig-interfaces/FXTabItem.i +82 -0
  420. data/swig-interfaces/FXTable.i +861 -0
  421. data/swig-interfaces/FXText.i +763 -0
  422. data/swig-interfaces/FXTextField.i +290 -0
  423. data/swig-interfaces/FXToggleButton.i +136 -0
  424. data/swig-interfaces/FXToolBar.i +75 -0
  425. data/swig-interfaces/FXToolBarGrip.i +82 -0
  426. data/swig-interfaces/FXToolBarShell.i +98 -0
  427. data/swig-interfaces/FXToolBarTab.i +114 -0
  428. data/swig-interfaces/FXToolTip.i +93 -0
  429. data/swig-interfaces/FXTopWindow.i +263 -0
  430. data/swig-interfaces/FXTranslator.i +55 -0
  431. data/swig-interfaces/FXTreeList.i +549 -0
  432. data/swig-interfaces/FXTreeListBox.i +317 -0
  433. data/swig-interfaces/FXTriStateButton.i +77 -0
  434. data/swig-interfaces/FXURL.i +35 -0
  435. data/swig-interfaces/FXVec2d.i +87 -0
  436. data/swig-interfaces/FXVec2f.i +87 -0
  437. data/swig-interfaces/FXVec3d.i +111 -0
  438. data/swig-interfaces/FXVec3f.i +109 -0
  439. data/swig-interfaces/FXVec4d.i +115 -0
  440. data/swig-interfaces/FXVec4f.i +115 -0
  441. data/swig-interfaces/FXVerticalFrame.i +69 -0
  442. data/swig-interfaces/FXVisual.i +162 -0
  443. data/swig-interfaces/FXWindow.i +851 -0
  444. data/swig-interfaces/FXWizard.i +125 -0
  445. data/swig-interfaces/FXXBMIcon.i +56 -0
  446. data/swig-interfaces/FXXBMImage.i +118 -0
  447. data/swig-interfaces/FXXPMIcon.i +122 -0
  448. data/swig-interfaces/FXXPMImage.i +56 -0
  449. data/swig-interfaces/README +17 -0
  450. data/swig-interfaces/common.i +48 -0
  451. data/swig-interfaces/core.i +85 -0
  452. data/swig-interfaces/dcmodule.i +36 -0
  453. data/swig-interfaces/dialogs.i +49 -0
  454. data/swig-interfaces/exceptions.i +249 -0
  455. data/swig-interfaces/framesmodule.i +54 -0
  456. data/swig-interfaces/freefuncs.i +93 -0
  457. data/swig-interfaces/fx3d.i +60 -0
  458. data/swig-interfaces/fxdefs.i +419 -0
  459. data/swig-interfaces/handlers.i +615 -0
  460. data/swig-interfaces/iconlistmodule.i +37 -0
  461. data/swig-interfaces/icons.i +48 -0
  462. data/swig-interfaces/ignore-message-handlers.rb +16 -0
  463. data/swig-interfaces/image.i +49 -0
  464. data/swig-interfaces/labelmodule.i +47 -0
  465. data/swig-interfaces/layout.i +47 -0
  466. data/swig-interfaces/listmodule.i +37 -0
  467. data/swig-interfaces/macros.i +1326 -0
  468. data/swig-interfaces/markfuncs.i +210 -0
  469. data/swig-interfaces/mdi.i +38 -0
  470. data/swig-interfaces/menumodule.i +44 -0
  471. data/swig-interfaces/ruby-typemaps.i +772 -0
  472. data/swig-interfaces/scintilla.i +57 -0
  473. data/swig-interfaces/table-module.i +36 -0
  474. data/swig-interfaces/text-module.i +36 -0
  475. data/swig-interfaces/treelist-module.i +37 -0
  476. data/swig-interfaces/ui.i +63 -0
  477. data/{tests → test}/README +0 -0
  478. data/{tests → test}/TC_FXAccelTable.rb +0 -0
  479. data/{tests → test}/TC_FXApp.rb +0 -0
  480. data/{tests → test}/TC_FXArc.rb +0 -0
  481. data/{tests → test}/TC_FXBMPIcon.rb +0 -0
  482. data/{tests → test}/TC_FXBMPImage.rb +0 -0
  483. data/{tests → test}/TC_FXButton.rb +0 -0
  484. data/{tests → test}/TC_FXCheckButton.rb +0 -0
  485. data/{tests → test}/TC_FXComboBox.rb +0 -0
  486. data/{tests → test}/TC_FXDC.rb +0 -0
  487. data/{tests → test}/TC_FXDCPrint.rb +0 -0
  488. data/{tests → test}/TC_FXDCWindow.rb +0 -0
  489. data/{tests → test}/TC_FXDataTarget.rb +0 -0
  490. data/{tests → test}/TC_FXDialogBox.rb +0 -0
  491. data/{tests → test}/TC_FXDirList.rb +0 -0
  492. data/{tests → test}/TC_FXExtentd.rb +0 -0
  493. data/{tests → test}/TC_FXExtentf.rb +0 -0
  494. data/{tests → test}/TC_FXFileAssoc.rb +0 -0
  495. data/{tests → test}/TC_FXFileStream.rb +0 -0
  496. data/{tests → test}/TC_FXFoldingList.rb +0 -0
  497. data/{tests → test}/TC_FXFont.rb +0 -0
  498. data/{tests → test}/TC_FXFontDesc.rb +0 -0
  499. data/{tests → test}/TC_FXGLGroup.rb +0 -0
  500. data/{tests → test}/TC_FXGLShape.rb +0 -0
  501. data/{tests → test}/TC_FXGLViewer.rb +0 -0
  502. data/{tests → test}/TC_FXGradientBar.rb +0 -0
  503. data/{tests → test}/TC_FXHeader.rb +0 -0
  504. data/{tests → test}/TC_FXHiliteStyle.rb +0 -0
  505. data/{tests → test}/TC_FXIconDict.rb +0 -0
  506. data/{tests → test}/TC_FXIconList.rb +0 -0
  507. data/{tests → test}/TC_FXId.rb +0 -0
  508. data/{tests → test}/TC_FXImage.rb +0 -0
  509. data/{tests → test}/TC_FXLight.rb +0 -0
  510. data/{tests → test}/TC_FXList.rb +0 -0
  511. data/{tests → test}/TC_FXListBox.rb +0 -0
  512. data/{tests → test}/TC_FXMainWindow.rb +0 -0
  513. data/{tests → test}/TC_FXMat4f.rb +0 -0
  514. data/{tests → test}/TC_FXMaterial.rb +0 -0
  515. data/{tests → test}/TC_FXMemoryStream.rb +0 -0
  516. data/{tests → test}/TC_FXMenuCheck.rb +0 -0
  517. data/{tests → test}/TC_FXMenuCommand.rb +0 -0
  518. data/{tests → test}/TC_FXMenuRadio.rb +0 -0
  519. data/{tests → test}/TC_FXMessageBox.rb +0 -0
  520. data/{tests → test}/TC_FXPoint.rb +0 -0
  521. data/{tests → test}/TC_FXQuatf.rb +0 -0
  522. data/{tests → test}/TC_FXRadioButton.rb +0 -0
  523. data/{tests → test}/TC_FXRanged.rb +0 -0
  524. data/{tests → test}/TC_FXRangef.rb +0 -0
  525. data/{tests → test}/TC_FXRectangle.rb +0 -0
  526. data/{tests → test}/TC_FXRegion.rb +0 -0
  527. data/{tests → test}/TC_FXRegistry.rb +0 -0
  528. data/{tests → test}/TC_FXScrollArea.rb +0 -0
  529. data/{tests → test}/TC_FXScrollWindow.rb +0 -0
  530. data/{tests → test}/TC_FXSegment.rb +0 -0
  531. data/{tests → test}/TC_FXSettings.rb +0 -0
  532. data/{tests → test}/TC_FXShell.rb +0 -0
  533. data/{tests → test}/TC_FXSize.rb +0 -0
  534. data/{tests → test}/TC_FXStream.rb +0 -0
  535. data/{tests → test}/TC_FXTable.rb +0 -0
  536. data/{tests → test}/TC_FXTableItem.rb +0 -0
  537. data/{tests → test}/TC_FXText.rb +0 -0
  538. data/{tests → test}/TC_FXTopWindow.rb +0 -0
  539. data/{tests → test}/TC_FXTreeList.rb +0 -0
  540. data/{tests → test}/TC_FXTreeListBox.rb +0 -0
  541. data/{tests → test}/TC_FXUndoList.rb +0 -0
  542. data/{tests → test}/TC_FXVec2d.rb +0 -0
  543. data/{tests → test}/TC_FXVec2f.rb +0 -0
  544. data/{tests → test}/TC_FXVec3d.rb +0 -0
  545. data/{tests → test}/TC_FXVec3f.rb +0 -0
  546. data/{tests → test}/TC_FXVec4f.rb +0 -0
  547. data/{tests → test}/TC_FXViewport.rb +0 -0
  548. data/{tests → test}/TC_FXXBMIcon.rb +0 -0
  549. data/{tests → test}/TC_FXXBMImage.rb +0 -0
  550. data/{tests → test}/TC_FXXPMIcon.rb +0 -0
  551. data/{tests → test}/TC_FXXPMImage.rb +0 -0
  552. data/{tests → test}/TC_Misc.rb +0 -0
  553. data/{tests → test}/TC_downcast.rb +0 -0
  554. data/{tests → test}/TS_All.rb +0 -0
  555. data/{tests → test}/blankpage.ps +0 -0
  556. data/{tests → test}/howdypage.ps +0 -0
  557. data/{tests → test}/stress1.rb +0 -0
  558. data/{tests → test}/stress2.rb +0 -0
  559. data/{tests → test}/stress3.rb +0 -0
  560. data/{tests → test}/testcase.rb +0 -0
  561. metadata +718 -458
  562. data/doc/apes02.html +0 -21
  563. data/doc/apes03.html +0 -39
  564. data/doc/book.html +0 -3
  565. data/doc/build.html +0 -132
  566. data/doc/ch03s02.html +0 -23
  567. data/doc/ch03s03.html +0 -52
  568. data/doc/ch03s04.html +0 -36
  569. data/doc/ch03s05.html +0 -60
  570. data/doc/ch04s02.html +0 -71
  571. data/doc/ch04s03.html +0 -37
  572. data/doc/ch04s04.html +0 -72
  573. data/doc/ch05s02.html +0 -260
  574. data/doc/ch05s03.html +0 -127
  575. data/doc/changes.html +0 -777
  576. data/doc/clipboardtut.html +0 -67
  577. data/doc/differences.html +0 -190
  578. data/doc/dragdroptut.html +0 -263
  579. data/doc/events.html +0 -36
  580. data/doc/examples.html +0 -104
  581. data/doc/gems.html +0 -73
  582. data/doc/goals.html +0 -41
  583. data/doc/images/babelfish.png +0 -0
  584. data/doc/images/browser.png +0 -0
  585. data/doc/images/button.png +0 -0
  586. data/doc/images/call-chain-example.png +0 -0
  587. data/doc/images/colordialog.png +0 -0
  588. data/doc/images/datatarget.png +0 -0
  589. data/doc/images/dialog.png +0 -0
  590. data/doc/images/dilbert.png +0 -0
  591. data/doc/images/dirlist.png +0 -0
  592. data/doc/images/dropsite-droprejected.png +0 -0
  593. data/doc/images/foursplit.png +0 -0
  594. data/doc/images/gltest.png +0 -0
  595. data/doc/images/glviewer.png +0 -0
  596. data/doc/images/groupbox.png +0 -0
  597. data/doc/images/header.png +0 -0
  598. data/doc/images/hello-with-button.png +0 -0
  599. data/doc/images/hello-with-icon-1.png +0 -0
  600. data/doc/images/hello-with-icon-2.png +0 -0
  601. data/doc/images/hello-with-icon-3.png +0 -0
  602. data/doc/images/hello-with-tooltip.png +0 -0
  603. data/doc/images/hello-without-button.png +0 -0
  604. data/doc/images/hello.png +0 -0
  605. data/doc/images/hello2.png +0 -0
  606. data/doc/images/iconlist-bigicons.png +0 -0
  607. data/doc/images/iconlist-details.png +0 -0
  608. data/doc/images/image.png +0 -0
  609. data/doc/images/imageviewer.png +0 -0
  610. data/doc/images/inheritance.png +0 -0
  611. data/doc/images/mditest.png +0 -0
  612. data/doc/images/raabrowser.png +0 -0
  613. data/doc/images/scribble.png +0 -0
  614. data/doc/images/shutter.png +0 -0
  615. data/doc/images/splitter.png +0 -0
  616. data/doc/images/tabbook.png +0 -0
  617. data/doc/images/table.png +0 -0
  618. data/doc/images/tutorial1.png +0 -0
  619. data/doc/implementation.html +0 -16
  620. data/doc/infosources.html +0 -33
  621. data/doc/library.html +0 -30
  622. data/doc/opengl.html +0 -73
  623. data/doc/pt01.html +0 -3
  624. data/doc/pt02.html +0 -3
  625. data/doc/scintilla.html +0 -36
  626. data/doc/style.css +0 -247
  627. data/doc/subversion.html +0 -21
  628. data/doc/tutorial1.html +0 -90
  629. data/doc/unicode.html +0 -56
  630. data/web/community.html +0 -81
  631. data/web/documentation.html +0 -83
  632. data/web/downloads.html +0 -85
  633. data/web/index.html +0 -88
data/doc/apes02.html DELETED
@@ -1,21 +0,0 @@
1
- <html><head>
2
- <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
3
- <title>Object Life Cycles and Garbage Collection</title><link rel="stylesheet" href="style.css" type="text/css"><meta name="generator" content="DocBook v5 XSL Stylesheets V1.72.0"><link rel="start" href="book.html" title="Developing Graphical User Interfaces with FXRuby"><link rel="up" href="implementation.html" title="Appendix&nbsp;E.&nbsp;Implementation"><link rel="prev" href="implementation.html" title="Appendix&nbsp;E.&nbsp;Implementation"><link rel="next" href="apes03.html" title="Virtual Functions"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Object Life Cycles and Garbage Collection</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="implementation.html">Prev</a>&nbsp;</td><th width="60%" align="center">Appendix&nbsp;E.&nbsp;Implementation</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="apes03.html">Next</a></td></tr></table><hr></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="d0e5816"></a>Object Life Cycles and Garbage Collection</h2></div></div></div><p>One of the more difficult issues to deal with was understanding
4
- the "life cycle" of FOX objects (that is, the actual C++ objects) and
5
- their relationship to the associated Ruby instances. Understanding this
6
- relationship is critical when dealing with Ruby's garbage collector,
7
- to ensure that objects are disposed of at the right time.</p><p>For our purposes, we can divide the set of all objects in an FXRuby
8
- program into two groups, those objects that Ruby "owns" and those that
9
- it doesn't. The first group (the "owned" objects) includes those that you
10
- create explicitly from Ruby code. This is usually done by calling a class'
11
- <code class="methodname">new</code> method, e.g.</p><pre class="programlisting">myIcon = FXPNGIcon.new(myApp, File.open("icon.png", "rb").read)
12
- myButton = FXButton.new(parentWin, "Hello, World!", myIcon)</pre><p>It's important to keep in mind that when you create an object like
13
- this you're not only creating the Ruby instance part (i.e. whatever
14
- overhead is usually associated with a Ruby instance) but a C++ FOX object
15
- as well. Because we created these objects, we would reasonably expect them
16
- to be destroyed when they are garbage-collected so that our programs
17
- don't leak memory.</p><p>The other group of objects (those not owned by Ruby) are those
18
- returned from most class instance methods; they are references to already-
19
- existing objects. For example, <code class="methodname">FXStatusBar#statusline
20
- </code> returns a reference to the status bar's enclosed status line
21
- instance.</p><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="d0e5835"></a>GL Objects</h3></div></div></div><p>A C++ <code class="classname">FXGLGroup</code> object owns all of the <code class="classname">FXGLObject</code> objects it "contains". In other words, when that <code class="classname">FXGLGroup</code> object is destroyed, it will also destroy all of the <code class="classname">FXGLObject</code> objects for which it holds pointers.</p><p>In order to keep track of <span class="emphasis"><em>which</em></span> GL objects have been added to an <code class="classname">FXGLGroup</code>, all of the FXRuby C++ classes derived from <code class="classname">FXGLObject</code> have a boolean member variable <em class="structfield"><code>owned</code></em> that indicates whether this object is "owned" or not. Until an <code class="classname">FXGLObject</code> object is added to a group, this member variable should stay false.</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="implementation.html">Prev</a>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="implementation.html">Up</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="apes03.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Appendix&nbsp;E.&nbsp;Implementation&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="book.html">Home</a></td><td width="40%" align="right" valign="top">&nbsp;Virtual Functions</td></tr></table></div></body></html>
data/doc/apes03.html DELETED
@@ -1,39 +0,0 @@
1
- <html><head>
2
- <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
3
- <title>Virtual Functions</title><link rel="stylesheet" href="style.css" type="text/css"><meta name="generator" content="DocBook v5 XSL Stylesheets V1.72.0"><link rel="start" href="book.html" title="Developing Graphical User Interfaces with FXRuby"><link rel="up" href="implementation.html" title="Appendix&nbsp;E.&nbsp;Implementation"><link rel="prev" href="apes02.html" title="Object Life Cycles and Garbage Collection"><link rel="next" href="subversion.html" title="Appendix&nbsp;F.&nbsp;Getting the Sources from Subversion"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Virtual Functions</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="apes02.html">Prev</a>&nbsp;</td><th width="60%" align="center">Appendix&nbsp;E.&nbsp;Implementation</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="subversion.html">Next</a></td></tr></table><hr></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="d0e5869"></a>Virtual Functions</h2></div></div></div><p>
4
- One of the design requirements for FXRuby was to ensure that any
5
- virtual function call made on a FOX object (from the C++ library
6
- layer) is routed to the proper Ruby instance method, even if that
7
- method has been overridden in a derived class.
8
- </p><p>
9
- For example, many of the FXRuby example programs are structured with a
10
- main window class that subclasses <code class="classname">FXMainWindow</code>
11
- and then overrides its <code class="methodname">create</code> instance method:</p><pre class="programlisting">class MyMainWindow &lt; Fox::FXMainWindow
12
- # overrides the base class version, FXMainWindow#create
13
- def create
14
- end
15
- end</pre><p>This <code class="methodname">create</code> method isn't called directly from Ruby code, however; it's called as a side effect of calling <code class="methodname">FXApp#create</code>. Inside the C++ FOX library, the <code class="methodname">FXApp::create()</code> member function recursively calls <code class="methodname">create()</code> on all of the application's windows and eventually calls the virtual <code class="methodname">FXMainWindow::create()</code> member function as well:
16
- </p><div class="screenshot"><div class="mediaobject" align="center"><img src="images/call-chain-example.png" align="middle"></div></div><p>
17
- To ensure that our main window's overridden <code class="methodname">create
18
- </code> method is invoked instead of the base class implementation,
19
- we need some special machinery in place.
20
- </p><p>
21
- For every C++ class that declares virtual member functions, we derive
22
- a new C++ class that overrides all of those virtual functions with special
23
- stubs that know how to make method calls on Ruby instances. The naming
24
- convention for these classes is that the "FX" prefix is replaced with
25
- "FXRb"; for example, our <code class="classname">FXRbButton</code> C++ class is
26
- derived from FOX's <code class="classname">FXButton</code>:
27
- </p><div class="screenshot"><div class="mediaobject" align="center"><img src="images/inheritance.png" align="middle"></div></div><p>
28
- Although the implementation of these "stubs" varies from function to function, the
29
- basic requirements are always the same:
30
- </p><div class="orderedlist"><ol type="1"><li><p>Look up the Ruby object associated with this C++ object.</p></li><li><p>Convert each of the function's arguments to their Ruby
31
- representation. For example, arguments of type <span class="type">FXint</span> are
32
- converted to Ruby <code class="classname">Fixnum</code>s.</p></li><li><p>Call the Ruby object's method, using the <code class="function">
33
- rb_funcall()</code> function from Ruby's C API, and capture its
34
- result (which is itself a Ruby object).</p></li><li><p>Convert the method call's result back to the virtual
35
- function's C++ return type, and then return that result from the C++
36
- function. For example, if the C++ function has a <span class="type"> FXbool</span>
37
- return type, we would expect the corresponding Ruby method to return
38
- either <code class="constant">Qtrue</code> or <code class="constant">Qfalse</code>.</p></li></ol></div><p>
39
- </p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="apes02.html">Prev</a>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="implementation.html">Up</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="subversion.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Object Life Cycles and Garbage Collection&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="book.html">Home</a></td><td width="40%" align="right" valign="top">&nbsp;Appendix&nbsp;F.&nbsp;Getting the Sources from Subversion</td></tr></table></div></body></html>
data/doc/book.html DELETED
@@ -1,3 +0,0 @@
1
- <html><head>
2
- <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
3
- <title>Developing Graphical User Interfaces with FXRuby</title><link rel="stylesheet" href="style.css" type="text/css"><meta name="generator" content="DocBook v5 XSL Stylesheets V1.72.0"><link rel="start" href="book.html" title="Developing Graphical User Interfaces with FXRuby"><link rel="next" href="pt01.html" title="Part&nbsp;I.&nbsp;The Basics"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Developing Graphical User Interfaces with FXRuby</th></tr><tr><td width="20%" align="left">&nbsp;</td><th width="60%" align="center">&nbsp;</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="pt01.html">Next</a></td></tr></table><hr></div><div class="book" lang="en"><div class="titlepage"><div><div><h1 class="title"><a name="book"></a>Developing Graphical User Interfaces with FXRuby</h1></div><div><h2 class="subtitle">Covers FXRuby Version 1.6</h2></div><div><div class="author"><h3 class="author"><span class="firstname">Lyle</span> <span class="surname">Johnson</span></h3></div></div><div><p class="copyright">Copyright &copy; 2006 J. Lyle Johnson</p></div></div><hr></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="part"><a href="pt01.html">I. The Basics</a></span></dt><dd><dl><dt><span class="preface"><a href="goals.html">History and Goals</a></span></dt><dt><span class="chapter"><a href="build.html">1. Building from Source Code</a></span></dt><dt><span class="chapter"><a href="gems.html">2. Installing from Gems</a></span></dt><dt><span class="chapter"><a href="tutorial1.html">3. Hello, World!</a></span></dt><dd><dl><dt><span class="section"><a href="tutorial1.html#d0e614">First Things First</a></span></dt><dt><span class="section"><a href="ch03s02.html">Better living through buttons</a></span></dt><dt><span class="section"><a href="ch03s03.html">Messages</a></span></dt><dt><span class="section"><a href="ch03s04.html">Adding a tool tip</a></span></dt><dt><span class="section"><a href="ch03s05.html">Adding an icon</a></span></dt></dl></dd><dt><span class="chapter"><a href="clipboardtut.html">4. Working With the Clipboard</a></span></dt><dd><dl><dt><span class="section"><a href="clipboardtut.html#d0e1003">Basic Application</a></span></dt><dt><span class="section"><a href="ch04s02.html">Acquiring the Clipboard</a></span></dt><dt><span class="section"><a href="ch04s03.html">Sending Data to the Clipboard</a></span></dt><dt><span class="section"><a href="ch04s04.html">Pasting Data from the Clipboard</a></span></dt></dl></dd><dt><span class="chapter"><a href="dragdroptut.html">5. Drag and Drop</a></span></dt><dd><dl><dt><span class="section"><a href="dragdroptut.html#d0e1218">Drop Sites</a></span></dt><dt><span class="section"><a href="ch05s02.html">Drag Sources</a></span></dt><dt><span class="section"><a href="ch05s03.html">Putting It All Together</a></span></dt></dl></dd><dt><span class="chapter"><a href="unicode.html">6. Unicode and FXRuby</a></span></dt><dd><dl><dt><span class="section"><a href="unicode.html#d0e1628">Basic Application</a></span></dt></dl></dd><dt><span class="chapter"><a href="examples.html">7. Examples</a></span></dt><dt><span class="chapter"><a href="events.html">8. FXRuby's Message-Target System</a></span></dt><dt><span class="chapter"><a href="infosources.html">9. Other Sources of Information</a></span></dt><dt><span class="chapter"><a href="changes.html">10. Change History</a></span></dt></dl></dd><dt><span class="part"><a href="pt02.html">II. Appendices</a></span></dt><dd><dl><dt><span class="appendix"><a href="opengl.html">A. Using OpenGL with FXRuby</a></span></dt><dt><span class="appendix"><a href="scintilla.html">B. Using Scintilla with FXRuby</a></span></dt><dt><span class="appendix"><a href="differences.html">C. Differences between FOX and FXRuby</a></span></dt><dt><span class="appendix"><a href="library.html">D. The FXRuby Standard Library</a></span></dt><dt><span class="appendix"><a href="implementation.html">E. Implementation</a></span></dt><dd><dl><dt><span class="section"><a href="implementation.html#d0e5797">Code Generation</a></span></dt><dt><span class="section"><a href="apes02.html">Object Life Cycles and Garbage Collection</a></span></dt><dd><dl><dt><span class="section"><a href="apes02.html#d0e5835">GL Objects</a></span></dt></dl></dd><dt><span class="section"><a href="apes03.html">Virtual Functions</a></span></dt></dl></dd><dt><span class="appendix"><a href="subversion.html">F. Getting the Sources from Subversion</a></span></dt></dl></dd></dl></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left">&nbsp;</td><td width="20%" align="center">&nbsp;</td><td width="40%" align="right">&nbsp;<a accesskey="n" href="pt01.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">&nbsp;</td><td width="20%" align="center">&nbsp;</td><td width="40%" align="right" valign="top">&nbsp;Part&nbsp;I.&nbsp;The Basics</td></tr></table></div></body></html>
data/doc/build.html DELETED
@@ -1,132 +0,0 @@
1
- <html><head>
2
- <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
3
- <title>Chapter&nbsp;1.&nbsp;Building from Source Code</title><link rel="stylesheet" href="style.css" type="text/css"><meta name="generator" content="DocBook v5 XSL Stylesheets V1.72.0"><link rel="start" href="book.html" title="Developing Graphical User Interfaces with FXRuby"><link rel="up" href="pt01.html" title="Part&nbsp;I.&nbsp;The Basics"><link rel="prev" href="goals.html" title="History and Goals"><link rel="next" href="gems.html" title="Chapter&nbsp;2.&nbsp;Installing from Gems"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter&nbsp;1.&nbsp;Building from Source Code</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="goals.html">Prev</a>&nbsp;</td><th width="60%" align="center">Part&nbsp;I.&nbsp;The Basics</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="gems.html">Next</a></td></tr></table><hr></div><div class="chapter" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="build"></a>Chapter&nbsp;1.&nbsp;Building from Source Code</h2></div></div></div><p>This chapter provides instructions for building and installing FXRuby
4
- directly from source, and not using some more direct means (such as
5
- installing a gem, or via some package manager).</p><div class="itemizedlist"><ul type="disc"><li><p>If you're planning to use FXRuby on Windows, with the standard
6
- <a xmlns:xlink="http://www.w3.org/1999/xlink" href="http://rubyinstaller.rubyforge.org" target="_top">Ruby Installer for
7
- Windows</a>, you may wish to just download the pre-compiled binaries
8
- from the <a xmlns:xlink="http://www.w3.org/1999/xlink" href="http://rubyforge.org/projects/fxruby" target="_top">RubyForge
9
- project page</a> for FXRuby.</p></li><li><p>If you're already using the <a xmlns:xlink="http://www.w3.org/1999/xlink" href="http://www.macports.org/" target="_top">MacPorts</a> version of ruby, you may
10
- wish to just install the <code class="filename">rb-fxruby</code> port.</p></li></ul></div><div class="simplesect" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="d0e109"></a>Building From Source on Unix/Linux</h2></div></div></div><p>These instructions assume that you've already downloaded, compiled
11
- and installed FOX. Next, you'll need to download the FXRuby source code
12
- tarball and unpack it by typing:</p><pre class="screen">$ <span><strong class="command">tar xzf FXRuby-1.6.13.tar.gz</strong></span></pre><p>This will create a new directory called <code class="filename">FXRuby-1.6.13</code>. Change to the top-level
13
- directory and configure the build by typing:</p><pre class="screen">$ <span><strong class="command">ruby install.rb config</strong></span></pre><p>By default, the <code class="filename">install.rb</code> script will look for
14
- the FOX include files and library in the standard <code class="filename">/usr/local/include/fox-1.6</code> and <code class="filename">/usr/local/lib</code> directories, respectively. You
15
- can override these locations by passing a few additional arguments to
16
- <code class="filename">install.rb</code> during this step, e.g.</p><pre class="screen">$ <span><strong class="command">ruby install.rb config -- \
17
- --with-fox-include=/home/lyle/fox-1.6.32/include \
18
- --with-fox-lib=/home/lyle/fox-1.6.32/src/.libs</strong></span></pre><p>Once the build has been configured, you can start the build by
19
- typing:</p><pre class="screen">$ <span><strong class="command">ruby install.rb setup</strong></span></pre><p>It will take quite awhile to build FXRuby, even on a fast machine,
20
- so this might be a good time to take a coffee break. If you run into
21
- problems during the compilation, please check the <a href="build.html#tragedies" title="Things That Can Go Wrong">list of things that can go wrong</a> for
22
- workarounds for those problems.</p><p>Once it's finished compiling, install FXRuby by typing:</p><pre class="screen">$ <span><strong class="command">ruby install.rb install</strong></span></pre><p>As a quick sanity check, to make sure that all is well, you should
23
- probably fire up <code class="filename">irb</code> and try to import FXRuby:</p><pre class="screen">$ <span><strong class="command">irb</strong></span>
24
- irb(main):001:0&gt; <strong class="userinput"><code>require 'fox16'</code></strong>
25
- true
26
- irb(main):002:0&gt;</pre><p>If the import failed (usually with a message along the lines of
27
- "Cannot load library"), check the <a href="build.html#tragedies" title="Things That Can Go Wrong">list of things
28
- that can go wrong</a> for known problems. If that still doesn't solve
29
- your problem, drop me an e-mail or ask around on the Ruby newsgroup or
30
- mailing list; it's quite likely that someone else has run into this
31
- problem too. Once you do have a working FXRuby installation, you're ready
32
- to check out the example programs.</p></div><div class="simplesect" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="d0e180"></a>Building From Source on Windows (Using Visual C++)</h2></div></div></div><p>This section describes how to compile FXRuby using Microsoft Visual
33
- C++, for use with a Ruby that was also compiled using Visual C++.</p><p>This discussion assumes that you've built Ruby using the
34
- instructions and build files distributed with the standard Ruby source
35
- code. To review, you should have started by unpacking the source code
36
- tarball, changing into the top-level source code directory (e.g. <code class="filename">C:\ruby-1.8.6</code>) and then typing:</p><pre class="screen">C:\ruby-1.8.6&gt;<span><strong class="command">win32\configure</strong></span>
37
- type 'nmake' to make ruby for mswin32.
38
- C:\ruby-1.8.6&gt;<span><strong class="command">nmake</strong></span></pre><p>After the compilation finished, you installed Ruby somewhere by
39
- typing, e.g.,</p><pre class="screen">C:\ruby-1.8.6&gt;<span><strong class="command">nmake DESTDIR=C:\ruby install</strong></span></pre><p>Similarly, I'm assuming that you built the FOX library using the
40
- Developer Studio project files distributed with the standard FOX source
41
- code distribution.</p><p>Now you can configure the FXRuby build by typing:</p><pre class="screen">C:\FXRuby-1.6.13&gt;<span><strong class="command">ruby install.rb config --make-prog=nmake -- \
42
- --with-fox-include=C:\fox-1.6.32\include \
43
- --with-fox-lib=C:\fox-1.6.32\lib</strong></span></pre><p>Once the build has been configured, you can start the build by
44
- typing:</p><pre class="screen">C:\FXRuby-1.6.13&gt; <span><strong class="command">ruby install.rb setup</strong></span></pre><p>It will take quite awhile to build FXRuby, even on a fast machine,
45
- so this might be a good time to take a coffee break. Because Visual C++ is
46
- such a strict compiler (usually a good thing), you will probably run into
47
- a few problems with non-ANSI declarations in the Ruby header files. If you
48
- do run into problems during the compilation, just check the next section
49
- for a list of things that could go wrong, and workarounds for those
50
- problems. None of them are showstoppers and none require you to restart
51
- the compile from scratch (just type <span><strong class="command">ruby install.rb
52
- setup</strong></span> to pick up where you left off).</p><p>Once it's finished compiling, install FXRuby by typing:</p><pre class="screen">C:\FXRuby-1.6.13&gt; <span><strong class="command">ruby install.rb install</strong></span></pre><p>As a quick sanity check, to make sure that all is well, you should
53
- probably fire up <code class="filename">irb</code> and try to import FXRuby:</p><pre class="screen">C:\FXRuby-1.6.13&gt; <span><strong class="command">irb</strong></span>
54
- irb(main):001:0&gt; <strong class="userinput"><code>require 'fox16'</code></strong>
55
- true
56
- irb(main):002:0&gt;</pre><p>If the import failed (usually with a message along the lines of
57
- "Cannot load library"), check the list of things that can go wrong for
58
- known problems. If that still doesn't solve your problem, drop me an
59
- e-mail or ask around on the Ruby newsgroup or mailing list; it's quite
60
- likely that someone else has run into this problem too. Once you do have a
61
- working FXRuby installation, you're ready to check out the example
62
- programs.</p></div><div class="simplesect" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="tragedies"></a>Things That Can Go Wrong</h2></div></div></div><p><span class="emphasis"><em>"Too many arguments to function..."</em></span></p><p>The include files for Ruby versions 1.6.7 and earlier still have
63
- several function prototypes in the older "K &amp; R" C style, where the
64
- function's argument list is not included; for example, the function
65
- <code class="function">rb_thread_wait_for()</code> takes a single argument of type
66
- <span class="type">struct timeval</span>, but its prototype in
67
- <code class="filename">intern.h</code> is:</p><pre class="programlisting">void rb_thread_wait_for();</pre><p>Because FXRuby is written in C++, and C++ requires strict ANSI
68
- C-style function prototypes, code that attempts to call one of these
69
- functions will fail to compile under some compilers. For example, the
70
- error message from gcc will look something like this:</p><pre class="screen">FXRbApp.cpp: In method `long int FXRbApp::onChoreThreads (FXObject *, unsigned int, void *)':
71
- /usr/local/lib/ruby/1.8/i686-linux/intern.h:172: too many arguments to function `void rb_thread_wait_for ()'
72
- FXRbApp.cpp:100: at this point in file
73
- make: *** [FXRbApp.o] Error 1</pre><p>while the error message from Microsoft's Visual C++ compiler looks
74
- something like this:</p><pre class="screen">FXRbApp.cpp(109): error C2660: 'rb_thread_wait_for' : function does not take 1 parameters
75
- NMAKE : fatal error U1077: 'cl' : return code '0x2'
76
- Stop.</pre><p>This problem with the Ruby header files has been corrected for Ruby
77
- versions 1.6.8 (and later), but if you're building for an older version of
78
- Ruby you can do one of two things to work around the problem:</p><div class="itemizedlist"><ul type="bullet"><li style="list-style-type: disc"><p>If you're using gcc version 2.95 or earlier, try modifying the
79
- compiler flags (<code class="constant">CFLAGS</code>) in the FXRuby
80
- <code class="filename">Makefile</code> to include the
81
- <code class="option">-fno-strict-prototype</code> option; this should instruct
82
- the compiler to allow these kinds of discrepancies. Unfortunately,
83
- this flag is not supported in more recent versions of gcc.</p></li><li style="list-style-type: disc"><p>A more direct approach is to just fix the offending declarations
84
- in the Ruby include file(s), i.e. change the declaration for
85
- <code class="function">rb_thread_wait_for()</code> in
86
- <code class="filename">intern.h</code> to read:</p><pre class="programlisting">void rb_thread_wait_for(struct timeval);</pre><p>and change the declaration for <code class="function">rb_gc_mark()</code>
87
- in <code class="filename">intern.h</code> to read:</p><pre class="programlisting">void rb_gc_mark(VALUE);</pre></li></ul></div><p><span class="emphasis"><em>"Virtual Memory Exhausted"</em></span></p><p>For FXRuby releases earlier than version 0.99.173 it was common for
88
- the compiler to run out of memory trying to compile
89
- <code class="filename">core_wrap.cpp</code>, with an error message like:</p><pre class="screen">core_wrap.cpp: In function 'void Init_core()':
90
- core_wrap.cpp:108596: virtual memory exhausted</pre><p>This failure was due to the use of optimizations by the compiler;
91
- the FXRuby source code makes heavy use of C++ templates and some versions
92
- of gcc require a lot of memory to process these. Starting with FXRuby
93
- version 0.99.173, the <code class="filename">extconf.rb</code> script
94
- <span class="emphasis"><em>should</em></span> disable compiler optimizations when it
95
- generates the FXRuby <code class="filename">Makefile</code>. If you suspect that
96
- it's not disabling optimizations (or can see this by watching the compile
97
- command lines), try modifying the compiler flags
98
- (<code class="constant">CFLAGS</code>) in the <code class="filename">Makefile</code> by hand
99
- to do so.</p><p><span class="emphasis"><em>"Cannot load library"</em></span></p><p>On Linux and other Unix systems that support shared libraries, FOX
100
- is typically installed as a shared library named
101
- <code class="filename">libFOX-1.6.so</code>. After all of the source files for
102
- FXRuby are compiled, the last step is to link all of the FXRuby object
103
- files together with the FOX library (and possibly other system libraries)
104
- to produce a new shared library, named <code class="filename">fox16.so</code>, that
105
- Ruby can import as an extension module.</p><p>There are a few things that can go wrong when you try to import this
106
- extension into Ruby. A common problem is that the operating system cannot
107
- locate the FOX shared library (<code class="filename">libFOX-1.6.so</code>) when it
108
- tries to dynamically load the FXRuby extension module; when this happens,
109
- the error message will look something like:</p><pre class="screen">$ <span><strong class="command">irb</strong></span>
110
- irb(main):001:0&gt; <strong class="userinput"><code>require 'fox16'</code></strong>
111
- LoadError: libFOX-1.6.so: cannot open shared object file: No such file or directory - /usr/local/lib/ruby/1.8/i686-linux/fox16.so
112
- from (irb):1:in 'require'
113
- from (irb):1
114
- </pre><p>One workaround for this problem is to modify the
115
- <code class="constant">LD_LIBRARY_PATH</code> environment variable to include the
116
- directory where <code class="filename">libFOX-1.6.so</code> is installed. For
117
- example, if <code class="filename">libFOX-1.6.so</code> is installed in <code class="filename">/usr/local/lib</code>, try setting:</p><pre class="screen">$ <span><strong class="command">export LD_LIBRARY_PATH=/usr/local/lib</strong></span>
118
- $ <span><strong class="command">irb</strong></span>
119
- irb(main):001:0&gt; <strong class="userinput"><code>require 'fox16'</code></strong>
120
- </pre><p>If this works, you can of course permanently add the
121
- <code class="constant">LD_LIBRARY_PATH</code> setting to your login file(s) so that
122
- you don't have to remember to type it each time. Another approach that
123
- should work for Linux is to modify your
124
- <code class="filename">/etc/ld.so.conf</code> file to include the installation
125
- directory (e.g. <code class="filename">/usr/local/lib</code>). If you'd like to do
126
- this instead, you'll need to (as root):</p><div class="orderedlist"><ol type="1" compact><li><p>Edit your <code class="filename">/etc/ld.so.conf</code> file and add the
127
- directory where <code class="filename">libFOX-1.6.so</code> is installed;
128
- and,</p></li><li><p>At the shell prompt, type <span><strong class="command">ldconfig</strong></span> to reload
129
- the linker configuration.</p></li></ol></div><p><span class="emphasis"><em>"Undefined symbol..."</em></span></p><p>Another problem that has been reported by users of both Debian
130
- GNU/Linux and NetBSD 1.5 is an error message along the lines of:</p><pre class="screen">/usr/lib/libstdc++.so.2: Undefined symbol "__vt_9exception"...</pre><p>The fix for this problem is reported to be to modify the FXRuby
131
- <code class="filename">Makefile</code> and add <code class="option">-lgcc</code> to the
132
- <code class="constant">LIBS</code> line.</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="goals.html">Prev</a>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="pt01.html">Up</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="gems.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">History and Goals&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="book.html">Home</a></td><td width="40%" align="right" valign="top">&nbsp;Chapter&nbsp;2.&nbsp;Installing from Gems</td></tr></table></div></body></html>
data/doc/ch03s02.html DELETED
@@ -1,23 +0,0 @@
1
- <html><head>
2
- <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
3
- <title>Better living through buttons</title><link rel="stylesheet" href="style.css" type="text/css"><meta name="generator" content="DocBook v5 XSL Stylesheets V1.72.0"><link rel="start" href="book.html" title="Developing Graphical User Interfaces with FXRuby"><link rel="up" href="tutorial1.html" title="Chapter&nbsp;3.&nbsp;Hello, World!"><link rel="prev" href="tutorial1.html" title="Chapter&nbsp;3.&nbsp;Hello, World!"><link rel="next" href="ch03s03.html" title="Messages"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Better living through buttons</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="tutorial1.html">Prev</a>&nbsp;</td><th width="60%" align="center">Chapter&nbsp;3.&nbsp;Hello, World!</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="ch03s03.html">Next</a></td></tr></table><hr></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="d0e741"></a>Better living through buttons</h2></div></div></div><p>Obviously, we need to add a few things to make it more interesting.
4
- Let's start by putting a button inside the main window. The
5
- <code class="classname">FXButton</code> class provides a standard push-button
6
- widget:</p><pre class="programlisting">require 'fox16'
7
-
8
- include Fox
9
-
10
- theApp = FXApp.new
11
-
12
- theMainWindow = FXMainWindow.new(theApp, "Hello")
13
- <span class="bold"><strong>FXButton.new(theMainWindow, "Hello, World!")</strong></span>
14
- theApp.create
15
-
16
- theMainWindow.show
17
-
18
- theApp.run</pre><p>As you might guess, passing <em class="parameter"><code>theMainWindow</code></em> as
19
- the first argument to <code class="methodname">FXButton.new</code> tells FXRuby
20
- that the new button is a child of the main window. The second argument to
21
- <code class="methodname">FXButton.new</code> is a string that will be displayed
22
- on the button. If you run the program <span class="emphasis"><em>now</em></span>, you should
23
- see this:</p><div class="screenshot"><div class="mediaobject" align="center"><img src="images/hello-with-button.png" align="middle"></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="tutorial1.html">Prev</a>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="tutorial1.html">Up</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="ch03s03.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter&nbsp;3.&nbsp;Hello, World!&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="book.html">Home</a></td><td width="40%" align="right" valign="top">&nbsp;Messages</td></tr></table></div></body></html>
data/doc/ch03s03.html DELETED
@@ -1,52 +0,0 @@
1
- <html><head>
2
- <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
3
- <title>Messages</title><link rel="stylesheet" href="style.css" type="text/css"><meta name="generator" content="DocBook v5 XSL Stylesheets V1.72.0"><link rel="start" href="book.html" title="Developing Graphical User Interfaces with FXRuby"><link rel="up" href="tutorial1.html" title="Chapter&nbsp;3.&nbsp;Hello, World!"><link rel="prev" href="ch03s02.html" title="Better living through buttons"><link rel="next" href="ch03s04.html" title="Adding a tool tip"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Messages</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch03s02.html">Prev</a>&nbsp;</td><th width="60%" align="center">Chapter&nbsp;3.&nbsp;Hello, World!</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="ch03s04.html">Next</a></td></tr></table><hr></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="d0e772"></a>Messages</h2></div></div></div><p>Now we're cookin' with Crisco, but let's press on and see what other
4
- things we can do to improve this. You may have noticed by now that the
5
- only way to quit the program is to close the window using the window
6
- manager's "close window" option, or to just kill the program outright. We
7
- can do better than that. Let's add a message handler for the
8
- <code class="classname">FXButton</code> such that when you click the button, it
9
- causes the program to exit:</p><pre class="programlisting">require 'fox16'
10
-
11
- include Fox
12
-
13
- theApp = FXApp.new
14
-
15
- theMainWindow = FXMainWindow.new(theApp, "Hello")
16
- theButton = FXButton.new(theMainWindow, "Hello, World!")
17
- <span class="bold"><strong>theButton.connect(SEL_COMMAND) do |sender, selector, data|
18
- exit
19
- end</strong></span>
20
- theApp.create
21
-
22
- theMainWindow.show
23
-
24
- theApp.run</pre><p>Most FOX objects send out messages (also known as
25
- <span class="emphasis"><em>events</em></span>) when something interesting happens. FOX
26
- messages have four important elements:</p><div class="orderedlist"><ol type="1"><li><p>The message <span class="emphasis"><em>sender</em></span> is the object that sends
27
- the message. In this case, the <code class="classname">FXButton</code>
28
- instance is the sender.</p></li><li><p>The message <span class="emphasis"><em>type</em></span> is a predefined integer
29
- constant that indicates what kind of event has occurred (i.e. why this
30
- message is being sent). In this case, the message type is
31
- <code class="constant">SEL_COMMAND</code>, which indicates that the command
32
- associated with this widget should be invoked.</p></li><li><p>The message <span class="emphasis"><em>identifier</em></span> is another integer
33
- constant that is used to distinguish between different messages of the
34
- same type. For example, the message that tells a FOX window to make
35
- itself visible is a <code class="constant">SEL_COMMAND</code> message with the
36
- identifier <code class="constant">FXWindow::ID_SHOW</code> (where
37
- <code class="constant">ID_SHOW</code> is a constant defined in the
38
- <code class="classname">FXWindow</code> class). A different message
39
- identifier, <code class="constant">FXWindow::ID_HIDE</code>, tells an
40
- <code class="classname">FXWindow</code> instance to make itself
41
- invisible.</p></li><li><p>The message <span class="emphasis"><em>data</em></span> is an object containing
42
- message-specific information. For this case (the
43
- <code class="classname">FXButton</code>'s <code class="constant">SEL_COMMAND</code>
44
- message, there is no interesting message data, but we'll see other
45
- kinds of messages where the message data is useful.</p></li></ol></div><p>For historical reasons, the message type and identifier are usually
46
- packed into a single 32-bit unsigned integer known as the
47
- <span class="emphasis"><em>selector</em></span>, and this is the value that is passed into
48
- the message handler block. Since we don't actually need to use the
49
- <em class="parameter"><code>sender</code></em>, <em class="parameter"><code>selector</code></em> or
50
- <em class="parameter"><code>data</code></em> arguments for this particular message handler,
51
- we can just ignore them and shorten the code to:</p><pre class="programlisting">theButton.connect(SEL_COMMAND) { exit }</pre><p>Re-run the program and push the button to convince yourself that it
52
- works.</p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch03s02.html">Prev</a>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="tutorial1.html">Up</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="ch03s04.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Better living through buttons&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="book.html">Home</a></td><td width="40%" align="right" valign="top">&nbsp;Adding a tool tip</td></tr></table></div></body></html>
data/doc/ch03s04.html DELETED
@@ -1,36 +0,0 @@
1
- <html><head>
2
- <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
3
- <title>Adding a tool tip</title><link rel="stylesheet" href="style.css" type="text/css"><meta name="generator" content="DocBook v5 XSL Stylesheets V1.72.0"><link rel="start" href="book.html" title="Developing Graphical User Interfaces with FXRuby"><link rel="up" href="tutorial1.html" title="Chapter&nbsp;3.&nbsp;Hello, World!"><link rel="prev" href="ch03s03.html" title="Messages"><link rel="next" href="ch03s05.html" title="Adding an icon"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Adding a tool tip</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch03s03.html">Prev</a>&nbsp;</td><th width="60%" align="center">Chapter&nbsp;3.&nbsp;Hello, World!</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="ch03s05.html">Next</a></td></tr></table><hr></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="d0e863"></a>Adding a tool tip</h2></div></div></div><p>To wrap up this introduction, we'd like to add a few finishing
4
- touches to the program. The first addition is to add a tool tip to the
5
- button, such that when the mouse cursor hovers over the button for a short
6
- while, it will pop up a little message describing what the button
7
- does:</p><pre class="programlisting">require 'fox16'
8
-
9
- include Fox
10
-
11
- theApp = FXApp.new
12
-
13
- theMainWindow = FXMainWindow.new(theApp, "Hello")
14
-
15
- theButton = FXButton.new(theMainWindow, "Hello, World!")
16
- <span class="bold"><strong>theButton.tipText = "Push Me!"</strong></span>
17
- theButton.connect(SEL_COMMAND) { exit }
18
-
19
- <span class="bold"><strong>FXToolTip.new(theApp)</strong></span>
20
-
21
- theApp.create
22
-
23
- theMainWindow.show
24
-
25
- theApp.run</pre><p>There are two changes involved here. The first is to set the tool
26
- tip text for the button using the <code class="methodname">tipText</code>
27
- accessor, and for this example we're setting the button's tip text to
28
- "Push Me!". The second change is to create the (single)
29
- <code class="classname">FXToolTip</code> instance for the application. Although
30
- this program shows the <code class="classname">FXToolTip</code> instance being
31
- created after the <code class="classname">FXButton</code>, it doesn't really
32
- matter when you do it. You just want to have instantiated the
33
- <code class="classname">FXToolTip</code> before you drop into the main event loop
34
- by calling <code class="methodname">FXApp#run</code>. If you run this version and
35
- hover over the button for a second or so, you should see the tooltip pop
36
- up:</p><div class="screenshot"><div class="mediaobject" align="center"><img src="images/hello-with-tooltip.png" align="middle"></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch03s03.html">Prev</a>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="tutorial1.html">Up</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="ch03s05.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Messages&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="book.html">Home</a></td><td width="40%" align="right" valign="top">&nbsp;Adding an icon</td></tr></table></div></body></html>
data/doc/ch03s05.html DELETED
@@ -1,60 +0,0 @@
1
- <html><head>
2
- <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
3
- <title>Adding an icon</title><link rel="stylesheet" href="style.css" type="text/css"><meta name="generator" content="DocBook v5 XSL Stylesheets V1.72.0"><link rel="start" href="book.html" title="Developing Graphical User Interfaces with FXRuby"><link rel="up" href="tutorial1.html" title="Chapter&nbsp;3.&nbsp;Hello, World!"><link rel="prev" href="ch03s04.html" title="Adding a tool tip"><link rel="next" href="clipboardtut.html" title="Chapter&nbsp;4.&nbsp;Working With the Clipboard"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Adding an icon</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch03s04.html">Prev</a>&nbsp;</td><th width="60%" align="center">Chapter&nbsp;3.&nbsp;Hello, World!</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="clipboardtut.html">Next</a></td></tr></table><hr></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="d0e900"></a>Adding an icon</h2></div></div></div><p>The final change is to add an icon to the button to make things a
4
- little more festive. FOX supports all of the popular image file formats
5
- (e.g. BMP, GIF, JPEG, PNG and TIFF) and you can use any of them as icons
6
- on buttons and labels. For this example, we'll use the one of the "Powered
7
- By Ruby" images created by Hal Fulton (and posted at the <a xmlns:xlink="http://www.w3.org/1999/xlink" href="http://www.rubygarden.org/ruby?PoweredByRubyButtons" target="_top">Ruby Garden
8
- Wiki</a>):</p><pre class="programlisting">require 'fox16'
9
-
10
- include Fox
11
-
12
- theApp = FXApp.new
13
-
14
- theMainWindow = FXMainWindow.new(theApp, "Hello")
15
-
16
- theButton = FXButton.new(theMainWindow, "Hello, World!")
17
- theButton.tipText = "Push Me!"
18
- <span class="bold"><strong>iconFile = File.open("pbr.jpg", "rb")
19
- theButton.icon = FXJPGIcon.new(theApp, iconFile.read)
20
- iconFile.close</strong></span>
21
- theButton.connect(SEL_COMMAND) { exit }
22
-
23
- FXToolTip.new(theApp)
24
-
25
- theApp.create
26
-
27
- theMainWindow.show
28
-
29
- theApp.run</pre><p>Here, <code class="filename">pbr.jpg</code> is the file name of the JPEG
30
- image file. You want to be sure to open the file in
31
- <span class="emphasis"><em>binary</em></span> mode (i.e. including the "b" mode flag),
32
- because there is a difference on the Windows platform. Since it's a JPEG
33
- image, we need to use the <code class="classname">FXJPGIcon</code> class to
34
- instantiate this icon. The first argument to
35
- <code class="methodname">FXJPGIcon.new</code> is just a reference to the
36
- <code class="classname">FXApp</code> instance, and the second argument is the
37
- contents of the image file. We associate this icon object with our button
38
- using the button's <code class="methodname">icon</code> accessor method. If you
39
- run this example, you should see:</p><div class="screenshot"><div class="mediaobject" align="center"><img src="images/hello-with-icon-1.png" align="middle"></div></div><p>When you have both text and an icon displayed on a button (or its
40
- superclass, <code class="classname">FXLabel</code>) the default positioning is to
41
- display the icon to the left of the text. For this particular example,
42
- however, it would probably be more appropriate to display the icon
43
- <span class="emphasis"><em>above</em></span> the text. We can achieve this using the
44
- button's <code class="methodname">iconPosition</code> accessor method:</p><pre class="programlisting">theButton.iconPosition = ICON_ABOVE_TEXT</pre><p>If you re-run the program after adding this line, you should
45
- see:</p><div class="screenshot"><div class="mediaobject" align="center"><img src="images/hello-with-icon-2.png" align="middle"></div></div><p>The last change we're going to make is to make the icon transparent.
46
- FOX allows you to specify that some regions of an icon should be treated
47
- as "transparent", meaning that whatever's underneath them shows through.
48
- FOX distinguishes those transparent regions from the non-transparent ones
49
- using a transparency color, and any pixels in the original image that have
50
- that color become transparent. In most cases, FOX can determine this
51
- transparency color automatically (indeed, for image file formats like GIF
52
- it's part of the image information). You can also specify the transparency
53
- color explicitly if you like.</p><p>For the icon we've chosen, it's pretty obvious that the transparency
54
- color is white, but let's let FOX figure that out for us. We want to
55
- activate two options for the icon:</p><div class="itemizedlist"><ul type="bullet"><li style="list-style-type: disc"><p>the <code class="constant">IMAGE_ALPHACOLOR</code> option, which tells
56
- FOX that some regions of this image should be treated as transparent;
57
- and,</p></li><li style="list-style-type: disc"><p>the <code class="constant">IMAGE_ALPHAGUESS</code> option, which tells
58
- FOX to guess the appropriate transparency color using the colors used
59
- in the four corners of the image.</p></li></ul></div><p>To set these options, add this line to the program:</p><pre class="programlisting">theButton.icon.options = IMAGE_ALPHACOLOR | IMAGE_ALPHAGUESS</pre><p>and then re-run the program after making this change to see the
60
- final result:</p><div class="screenshot"><div class="mediaobject" align="center"><img src="images/hello-with-icon-3.png" align="middle"></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch03s04.html">Prev</a>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="tutorial1.html">Up</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="clipboardtut.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Adding a tool tip&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="book.html">Home</a></td><td width="40%" align="right" valign="top">&nbsp;Chapter&nbsp;4.&nbsp;Working With the Clipboard</td></tr></table></div></body></html>
data/doc/ch04s02.html DELETED
@@ -1,71 +0,0 @@
1
- <html><head>
2
- <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
3
- <title>Acquiring the Clipboard</title><link rel="stylesheet" href="style.css" type="text/css"><meta name="generator" content="DocBook v5 XSL Stylesheets V1.72.0"><link rel="start" href="book.html" title="Developing Graphical User Interfaces with FXRuby"><link rel="up" href="clipboardtut.html" title="Chapter&nbsp;4.&nbsp;Working With the Clipboard"><link rel="prev" href="clipboardtut.html" title="Chapter&nbsp;4.&nbsp;Working With the Clipboard"><link rel="next" href="ch04s03.html" title="Sending Data to the Clipboard"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Acquiring the Clipboard</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="clipboardtut.html">Prev</a>&nbsp;</td><th width="60%" align="center">Chapter&nbsp;4.&nbsp;Working With the Clipboard</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="ch04s03.html">Next</a></td></tr></table><hr></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="d0e1022"></a>Acquiring the Clipboard</h2></div></div></div><p>Let's begin by augmenting the GUI to include a row of buttons along
4
- the bottom of the main window for copying and pasting:</p><pre class="programlisting">require 'fox16'
5
- require 'customer'
6
-
7
- include Fox
8
-
9
- class ClipMainWindow &lt; FXMainWindow
10
- def initialize(anApp)
11
- # Initialize base class first
12
- super(anApp, "Clipboard Example", :opts =&gt; DECOR_ALL, :width =&gt; 400, :height =&gt; 300)
13
- <span class="bold"><strong>
14
- # Horizontal frame contains buttons
15
- buttons = FXHorizontalFrame.new(self, LAYOUT_SIDE_BOTTOM|LAYOUT_FILL_X|PACK_UNIFORM_WIDTH)
16
- </strong></span><span class="bold"><strong>
17
- # Cut and paste buttons
18
- copyButton = FXButton.new(buttons, "Copy")
19
- pasteButton = FXButton.new(buttons, "Paste")
20
- </strong></span>
21
- # Place the list in a sunken frame
22
- sunkenFrame = FXVerticalFrame.new(self,
23
- LAYOUT_FILL_X|LAYOUT_FILL_Y|FRAME_SUNKEN|FRAME_THICK, :padding =&gt; 0)
24
-
25
- # Customer list
26
- customerList = FXList.new(sunkenFrame, :opts =&gt; LIST_BROWSESELECT|LAYOUT_FILL_X|LAYOUT_FILL_Y)
27
- $customers.each do |customer|
28
- customerList.appendItem(customer.name, nil, customer)
29
- end
30
- end
31
-
32
- def create
33
- super
34
- show(PLACEMENT_SCREEN)
35
- end
36
- end
37
-
38
- if __FILE__ == $0
39
- FXApp.new("ClipboardExample", "FXRuby") do |theApp|
40
- ClipMainWindow.new(theApp)
41
- theApp.create
42
- theApp.run
43
- end
44
- end
45
- </pre><p>Note that the lines which appear in bold face are those which have
46
- been added (or changed) since the previous source code listing.</p><p>The clipboard is a kind of shared resource in the operating system.
47
- Copying (or cutting) data to the clipboard begins with some window in your
48
- application requesting "ownership" of the clipboard by calling the
49
- <code class="methodname">acquireClipboard()</code> instance method. Let's add a
50
- handler for the "Copy" button press which does just that:</p><pre class="programlisting"># User clicks Copy
51
- copyButton.connect(SEL_COMMAND) do
52
- customer = customerList.getItemData(customerList.currentItem)
53
- types = [ FXWindow.stringType ]
54
- if acquireClipboard(types)
55
- @clippedCustomer = customer
56
- end
57
- end
58
- </pre><p>The <code class="methodname">acquireClipboard()</code> method takes as its
59
- input an array of drag types. A <span class="emphasis"><em>drag type</em></span> is just a
60
- unique value, assigned by the window system, that identifies a particular
61
- kind of data. In this case, we're using one of FOX's pre-registered drag
62
- types (<code class="constant">stringType</code>) to indicate that we have some
63
- string data to place on the clipboard. Later, we'll see how to register
64
- customized, application-specific drag types as well.</p><p>The <code class="methodname">acquireClipboard()</code> method returns
65
- <code class="constant">true</code> on success; since we called
66
- <code class="methodname">acquireClipboard()</code> on the main window, this means
67
- that the main window is now the clipboard owner. At this time, we want to
68
- save a reference to the currently selected customer in the
69
- <code class="varname">@clippedCustomer</code> instance variable so that if its value
70
- is requested later, we'll be able to return the
71
- <span class="emphasis"><em>correct</em></span> customer's information.</p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="clipboardtut.html">Prev</a>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="clipboardtut.html">Up</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="ch04s03.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter&nbsp;4.&nbsp;Working With the Clipboard&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="book.html">Home</a></td><td width="40%" align="right" valign="top">&nbsp;Sending Data to the Clipboard</td></tr></table></div></body></html>