iup-ffi 0.12.0 → 0.13.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4da0308e74093ebf8c476f7f3583ff762013eafe1be412894daf037c507829fe
-  data.tar.gz: 1d20c7fb3d37676ce2a375dbb6e7a29582cf97283cd0d31d1338dccc4bafb6ad
+  metadata.gz: ea00447c91daa75cf96893d3220254365ed3fae24436ab053e85e62844ebe7e3
+  data.tar.gz: 9f4970854bba59a5927d7725cababd42ea76b5af9d0c00b95b4ee3fb3d21326d
 SHA512:
-  metadata.gz: febbb65f5bcdf7897ac7b7e504337ae8188e907b5242f5c8f95f9283318736d703be6806fe5519242e32107a17413c428b9cfa864bb513c41ae5f313d39c4c7e
-  data.tar.gz: cef7c7426dc4af9b20a23e3e27e1f8687264044459c5fd4a73128308a816771856e36c63188c1fcf95549913f22a2987af376e89938f1320c7c8a97ea4238bbd
+  metadata.gz: 0054d4678c2605c8a850cae83d6f3a14782984b4d0a79901567d9d018cf17d76f6508bf3f9041dcb8db4d5753bdbdb57ee812f8d62b8b6db848f067c048d5726
+  data.tar.gz: df029fefd4c1ac476b234d35b137cb533f1e3f0bd72605da9788f1632c30952b5451160725e08bec34cf51b7d228e52390396abb151600e32fc6a9441db8ad4b

data/{LICENCE.txt → LICENCE.md}

@@ -1,4 +1,4 @@
-The MIT Licence (MIT)
+# The MIT Licence (MIT)
 
 Copyright (c) 2014-26, Peter Lane.
 

data/README.md

@@ -0,0 +1,139 @@
+# iup-ffi
+
+FFI binding for Ruby to [Tecgraf's IUP](http://www.tecgraf.puc-rio.br/iup/)
+portable user interface toolkit; IUP is a multi-platform toolkit for building
+graphical user interfaces.  The library provides both a low-level binding to
+the C library calls, and a high-level wrapping of most widgets to give a more
+natural Ruby syntax.
+
+This library is available as a [rubygem](https://rubygems.org/gems/iup-ffi) or
+in [source](https://codeberg.org/peterlane/iup-ffi) format.
+
+[Tecgraf's IUP](http://www.tecgraf.puc-rio.br/iup/) documentation (Version
+3.32) should be read along with the API documentation for iup-ffi.  A number of
+examples can be found in the source, or downloaded with the latest tagged
+[version](https://codeberg.org/peterlane/iup-ffi/tags).
+
+## Description
+
+The module Iup provides a Ruby-flavoured syntax for creating a GUI, wrapping
+each IUP component in a Ruby class with suitable mutators/accessors for the
+attributes and associated methods.  For example:
+
+```
+require "iup-ffi"
+
+Iup.mainloop do
+  btn = Iup::Button.new("click me", ->{ puts "clicked" }) do |b|
+    b.font = "Times, Bold 18"
+  end
+  puts "Button font is: ", btn.font
+
+  Iup::Dialog.new(btn) do |d|
+    d.title = "Example program"
+  end.show
+end
+```
+
+For direct access to the shared libraries, the bound functions for IUP, CD and
+IM are available in separate modules (names ending in "Lib"). These low-level
+functions provide a direct mapping to the C API of IUP.  This can be useful
+when converting code from other sources or when something is missing from the
+wrapper.  For example, the C program
+(https://www.tecgraf.puc-rio.br/iup/examples/C/message.c):
+
+```
+/* IupMessage Example */
+
+#include <stdlib.h>
+#include <stdio.h>
+
+/* IUP libraries include */
+#include <iup.h>
+
+/* Main program */
+int main(int argc, char **argv)
+{
+  /* Initializes IUP */
+  IupOpen(&argc, &argv);
+  
+  /* Executes IupMessage */
+  IupMessage("IupMessage Example", "Press the button");
+
+  /* Finishes IUP */
+  IupClose ();
+
+  /* Program finished successfully */
+  return EXIT_SUCCESS;
+
+}
+```
+
+is translated into Ruby as:
+
+```
+require "iup-ffi" # or "iup-ffi-plain" for just the low-level bindings
+
+IupLib.IupOpen(0, nil)
+IupLib.IupMessage("IupMessage Example", "Press the button")
+IupLib.IupClose
+```
+
+## Supported Widgets
+
+(As IUP is a large library and continues to be expanded, the list of supported
+widgets and their properties is at best partial.)
+
+Top-level containers:
+
+* Iup::ColorDialog, Iup::Dialog, Iup::FileDialog,
+Iup::FontDialog, Iup::MessageDialog, Iup::ProgressDialog
+
+Layout containers to arrange child widgets:
+
+* Iup::Fill, Iup::GridBox, Iup::HBox, Iup::VBox, Iup::ZBox, Iup::ScrollBox, Iup::SplitBox, Iup::StretchBox, 
+
+Grouping containers to organise related controls: 
+
+* Iup::BackgroundBox, Iup::Expander, Iup::Frame, Iup::Radio, Iup::Tabs
+
+Information controls to display data: 
+
+* Iup::Image, Iup::ImageRGB, Iup::ImageRGBA, Iup::Label, Iup::Link, Iup::ProgressBar
+
+Interactive controls: 
+
+* Iup::Button, Iup::ColorBar, Iup::Dial, Iup::List, Iup::Text, Iup::Toggle, Iup::Tree, Iup::Val
+
+Specialised/complex widgets: 
+
+* Iup::Canvas, Iup::Matrix, Iup::Scintilla
+
+Non-visual controls and menus:
+
+* Iup::Menu, Iup::MenuItem, Iup::Separator, Iup::SubMenu, Iup::Timer
+  
+## Installation
+
+Pre-built binaries are supported on Linux and Windows (x64) platforms:
+
+```
+$ gem install iup-ffi
+```
+
+* Windows gem does not include Iup::Scintilla.
+
+From source, download the CD, IM and IUP shared libraries from
+https://www.tecgraf.puc-rio.br/iup/en/download_tips.html into the appropriate
+"lib/library" folder: Linux68_64 and Win64_dllw6 are used in the pre-built
+binaries.
+
+## Support
+
+File bugs at the [codeberg issues page](https://codeberg.org/peterlane/iup-ffi/issues), or send an email to `peterlane@gmx.com`.
+
+## Copyright/Licence
+
+iup-ffi is copyright (c) 2014-26 Peter Lane, and released under the [MIT Licence](https://opensource.org/license/MIT).
+Tecgraf IUP products are also released under the MIT licence: https://www.tecgraf.puc-rio.br/iup/en/copyright.html
+

data/lib/iup-ffi-plain.rb

@@ -1,9 +1,51 @@
 # Provides the direct bindings through FFI to the IUP libraries.
 
+require 'ffi'
+require 'rbconfig'
+require "securerandom"
+
+module Iup
+  # :nodoc:
+  library_base = File.expand_path("../library", __FILE__)
+  IUP_LIBS = case RbConfig::CONFIG['host_os']
+             when /linux|cygwin/
+               library_path = File.join(library_base, "linux")
+               [
+                 "gobject-2.0", "pango-1.0",
+                 File.join(library_path, 'libcd.so'),
+                 File.join(library_path, 'libim.so'),
+                 File.join(library_path, "libiup.so"),
+                 File.join(library_path, 'libiupcd.so'),
+                 File.join(library_path, 'libiupcontrols.so'),
+                 File.join(library_path, 'libiupim.so'),
+                 File.join(library_path, 'libiupimglib.so'),
+                 File.join(library_path, 'libiup_scintilla.so')
+               ]
+             when /mswin|mingw/
+               library_path = File.join(library_base, "windows")
+               [
+                 File.join(library_path, "freetype6.dll"),
+                 File.join(library_path, "zlib1.dll"),
+                 File.join(library_path, 'cd.dll'),
+                 File.join(library_path, 'im.dll'),
+                 File.join(library_path, "iup.dll"),
+                 File.join(library_path, 'iupcd.dll'),
+                 File.join(library_path, 'iupcontrols.dll'),
+                 File.join(library_path, 'iupim.dll'),
+                 File.join(library_path, 'iupimglib.dll') #,
+                 #               File.join(library_path, 'iup_scintilla.dll')
+               ]
+             else
+               raise Exception, 
+                 'iup libraries not found this platform', 
+                 RbConfig::CONFIG['host_os']
+             end
+end
+
 require 'wrapped/constants'
 require 'plain/iuplib'
 require 'plain/iupcdlib'
 require 'plain/iupcontrolslib'
 require 'plain/iupimlib'
 require 'plain/iupimglib'
-require 'plain/scintilla-lib'
+require 'plain/scintilla-lib' unless /mswin|mingw/ === RbConfig::CONFIG['host_os']

data/lib/iup-ffi.rb

@@ -1,8 +1,5 @@
 # Requires files needed for wrapping the plain Iup libraries.
 #
-require 'ffi'
-require 'rbconfig'
-
 require 'iup-ffi-plain'
 
 # helper code
@@ -13,13 +10,10 @@ require 'wrapped/common-attributes'
 require 'wrapped/image-attributes'
 require 'wrapped/callback-setter'
 require 'wrapped/drag-drop-attributes'
-require 'wrapped/internal-drag-drop-attributes'
 require 'wrapped/scrollbar-attributes'
 
 # the wrapper classes themselves
 # -- core libraries
-require 'wrapped/dialogs'
-
 require 'wrapped/widget'
 require 'wrapped/button'
 require 'wrapped/canvas'
@@ -35,8 +29,8 @@ require 'wrapped/tree'
 require 'wrapped/val'
 
 # -- dialogs
-require 'wrapped/colourdialog'
 require 'wrapped/dialog'
+require 'wrapped/colordialog'
 require 'wrapped/filedialog'
 require 'wrapped/fontdialog'
 require 'wrapped/messagedialog'
@@ -67,7 +61,7 @@ require 'wrapped/zbox'
 require 'wrapped/scintilla'
 
 # -- additional controls
-require 'wrapped/colourbar'
+require 'wrapped/colorbar'
 require 'wrapped/dial'
 require 'wrapped/matrix'
 

data/lib/plain/iupcdlib.rb

@@ -1,20 +1,71 @@
-# Binding to the CD library
+# Binding to the iupcd shared library: CD is a vector graphics
+# toolkit.
+# This module can be used to access features not available 
+# in Iup. 
 #
+# For reference, the following functions are bound:
+#
+# * cdContextIup, [], :pointer
+# * cdCreateCanvas, [:pointer, :pointer], :pointer
+# * cdKillCanvas, [:pointer], :void
+# * cdCanvasActivate, [:pointer], :int
+# * cdCanvasDeactivate, [:pointer], :void
+# * cdUseContextPlus, [:int], :int
+# * cdCanvasGetContext, [:pointer], :pointer
+# * cdContextCaps, [:pointer], :int
+# * cdContextType, [:pointer], :int
+# * cdContextIsPlus, [:pointer], :int
+# * cdCanvasSimulate, [:pointer, :int], :int
+# * wdCanvasViewport, [:pointer, :int, :int, :int, :int], :void
+# * wdCanvasWindow, [:pointer, :double, :double, :double, :double], :void
+# * cdCanvasForeground, [:pointer, :long], :long
+# * cdCanvasBackground, [:pointer, :long], :long
+# * cdCanvasWriteMode, [:pointer, :int], :int
+# * cdCanvasClear, [:pointer], :int
+# * cdCanvasBegin, [:pointer, :int], :void
+# * cdCanvasVertex, [:pointer, :int, :int], :void
+# * cdCanvasEnd, [:pointer], :void
+# * cdCanvasPathSet, [:pointer, :int], :void
+# * cdCanvasPixel, [:pointer, :int, :int], :void
+# * cdCanvasMark, [:pointer, :int, :int], :void
+# * cdCanvasMarkType, [:pointer, :int], :int
+# * cdCanvasMarkSize, [:pointer, :int], :int
+# * cdCanvasLine, [:pointer, :int, :int, :int, :int], :void
+# * cdCanvasRect, [:pointer, :int, :int, :int, :int], :void
+# * cdCanvasArc, [:pointer, :int, :int, :int, :int, :double, :double], :void
+# * cdCanvasLineStyle, [:pointer, :int], :int
+# * cdCanvasLineWidth, [:pointer, :int], :int
+# * cdCanvasLineJoin, [:pointer, :int], :int
+# * cdCanvasLineCap, [:pointer, :int], :int
+# * cdCanvasBox, [:pointer, :int, :int, :int, :int], :void
+# * cdCanvasSector, [:pointer, :int, :int, :int, :int, :double, :double], :int
+# * cdCanvasChord, [:pointer, :int, :int, :int, :int, :double, :double], :int
+# * cdCanvasBackOpacity, [:pointer, :int], :int
+# * cdCanvasFillMode, [:pointer, :int], :int
+# * cdCanvasInteriorStyle, [:pointer, :int], :int
+# * cdCanvasHatch, [:pointer, :int], :int
+# * cdCanvasStipple, [:pointer, :int, :int, :string], :void
+# * cdCanvasText, [:pointer, :int, :int, :string], :void
+# * cdCanvasFont, [:pointer, :string, :int, :int], :void
+# * cdCanvasNativeFont, [:pointer, :string], :string
+# * cdCanvasTextAlignment, [:pointer, :int], :int
+# * cdCanvasTextOrientation, [:pointer, :double], :double
+# * cdCanvasVectorText, [:pointer, :int, :int, :string], :void
+# * cdCanvasVectorTextDirection, [:pointer, :int, :int, :int, :int], :void
+# * cdCanvasVectorTextSize, [:pointer, :int, :int, :string], :void
+# * cdCanvasVectorCharSize, [:pointer, :int], :void
+# * cdCanvasVectorFontSize, [:pointer, :double, :double], :void
+# * cdCanvasVectorFont, [:pointer, :string], :string
+# * cdEncodeColor, [:int, :int, :int], :long
+# 
 # TODO: 
 # - images
 # - various get functions
 #
-module CdLib # :nodoc:
+module CdLib 
   extend FFI::Library
 
-  case RbConfig::CONFIG['host_os']
-#  when /mswin|mingw/
-#    ffi_lib 'lib/library/iup.dll'
-  when /linux|cygwin/
-    ffi_lib 'libiupcd'
-  else
-    raise Exception, 'iup libraries not found for this platform'
-  end
+  ffi_lib *Iup::IUP_LIBS
 
   attach_function :cdContextIup, [], :pointer
 
@@ -25,7 +76,7 @@ module CdLib # :nodoc:
   attach_function :cdCanvasActivate, [:pointer], :int
   attach_function :cdCanvasDeactivate, [:pointer], :void
   attach_function :cdUseContextPlus, [:int], :int
- # attach_function :cdInitContextPlus, [:void], :void
+  # attach_function :cdInitContextPlus, [:void], :void
   attach_function :cdCanvasGetContext, [:pointer], :pointer
   attach_function :cdContextCaps, [:pointer], :int
   attach_function :cdContextType, [:pointer], :int
@@ -62,7 +113,7 @@ module CdLib # :nodoc:
   attach_function :cdCanvasRect, [:pointer, :int, :int, :int, :int], :void
   attach_function :cdCanvasArc, [:pointer, :int, :int, :int, :int, :double, :double], :void
   attach_function :cdCanvasLineStyle, [:pointer, :int], :int
-#  attach_function :cdCanvasLineStyleDashes, [:pointer, :pointer, :int], :void # TODO: pointer to int array?
+  #  attach_function :cdCanvasLineStyleDashes, [:pointer, :pointer, :int], :void # TODO: pointer to int array?
   attach_function :cdCanvasLineWidth, [:pointer, :int], :int
   attach_function :cdCanvasLineJoin, [:pointer, :int], :int
   attach_function :cdCanvasLineCap, [:pointer, :int], :int

data/lib/plain/iupcontrolslib.rb

@@ -1,14 +1,18 @@
-module ControlsLib # :nodoc:
+# Binding to the iupcontrols shared library.
+# This module can be used to access features not available 
+# in Iup. 
+#
+# For reference, the following functions are bound:
+#
+# * IupControlsOpen, [], :int
+# * IupColorbar, [], :pointer
+# * IupDial, [:string], :pointer
+# * IupMatrix, [:string], :pointer
+#
+module ControlsLib
   extend FFI::Library
 
-  case RbConfig::CONFIG['host_os']
-    #  when /mswin|mingw/
-    #    ffi_lib 'lib/library/iupcontrols.dll'
-  when /linux|cygwin/
-    ffi_lib 'libiupcontrols'
-  else
-    raise Exception, 'iup libraries not found for this platform'
-  end
+  ffi_lib *Iup::IUP_LIBS
 
   attach_function :IupControlsOpen, [], :int
 

data/lib/plain/iupimglib.rb

@@ -1,14 +1,15 @@
-module ImgLib # :nodoc:
+# Binding to the iupimglib shared library.
+# This module can be used to access features not available 
+# in Iup. 
+#
+# For reference, the following functions are bound:
+#
+# * IupImageLibOpen, [], :void
+#
+module ImgLib
   extend FFI::Library
 
-  case RbConfig::CONFIG['host_os']
-  when /mswin|mingw/
-    ffi_lib 'lib/library/iupimglib.lib'
-  when /linux|cygwin/
-    ffi_lib 'libiupimglib'
-  else
-    raise Exception, 'iup libraries not found for this platform'
-  end
+  ffi_lib *Iup::IUP_LIBS
 
   attach_function :IupImageLibOpen, [], :void
 end

data/lib/plain/iupimlib.rb

@@ -1,14 +1,16 @@
-module ImLib # :nodoc:
+# Binding to the imlib shared library: IM is a toolkit for images.
+# This module can be used to access features not available 
+# in Iup. 
+#
+# For reference, the following functions are bound:
+#
+# * IupLoadImage, [:string], :pointer
+# * IupSaveImage, [:string, :string], :int
+#
+module ImLib
   extend FFI::Library
 
-  case RbConfig::CONFIG['host_os']
-#  when /mswin|mingw/
-#    ffi_lib 'lib/library/iup.dll'
-  when /linux|cygwin/
-    ffi_lib 'libiupim'
-  else
-    raise Exception, 'iup libraries not found for this platform'
-  end
+  ffi_lib *Iup::IUP_LIBS
 
   attach_function :IupLoadImage, [:string], :pointer
   attach_function :IupSaveImage, [:string, :string], :int

data/lib/plain/iuplib.rb

@@ -1,14 +1,157 @@
-module IupLib # :nodoc:
+# Binding to the libiup shared library.
+# This module can be used to access features not available 
+# in Iup.
+#
+# As an example of using the library:
+#
+#   require 'iup-ffi-plain'
+#   
+#   IupLib.IupOpen(0, nil)
+#   IupLib.IupMessage("IupMessage Example", "Press the button")
+#   IupLib.IupClose
+#
+# For reference, the following functions are bound:
+#
+# * pango_font_family_get_type, [], :ulong
+# * pango_font_face_get_type,   [], :ulong
+# * pango_font_description_get_type, [], :ulong
+# * IupSetAttribute, [:pointer, :string, :string], :void
+# * IupSetAttributes, [:pointer, :string], :pointer
+# * IupGetAttribute, [:pointer, :string], :strptr
+# * IupSetAttributeHandle, [:pointer, :string, :pointer], :void
+# * IupSetGlobal, [:string, :string], :void
+# * IupGetGlobal, [:string], :strptr
+# * IupSetFunction, [:string, :iup_callback], :iup_callback
+# * IupGetInt, [:pointer, :string], :int
+# * IupOpen, [:int, :pointer], :int
+# * IupMainLoop, [], :void
+# * IupClose, [], :void
+# * IupDestroy, [:pointer], :void
+# * IupRedraw, [:pointer], :void
+# * IupMap, [:pointer], :void
+# * IupSetCallbackD_I, :IupSetCallback, [:pointer, :string, :iup_callback_d_i], :iup_callback_d_i
+# * IupSetCallbackFF_I, :IupSetCallback, [:pointer, :string, :iup_callback_ff_i], :iup_callback_ff_i
+# * IupSetCallbackFIIS_I, :IupSetCallback, [:pointer, :string, :iup_callback_fiis_i], :iup_callback_fiis_i
+# * IupSetCallbackS_I, :IupSetCallback, [:pointer, :string, :iup_callback_s_i], :iup_callback_s_i
+# * IupSetCallbackSII_I, :IupSetCallback, [:pointer, :string, :iup_callback_sii_i], :iup_callback_sii_i
+# * IupSetCallbackI_I, :IupSetCallback, [:pointer, :string, :iup_callback_i_i], :iup_callback_i_i
+# * IupSetCallbackI_S, :IupSetCallback, [:pointer, :string, :iup_callback_i_s], :iup_callback_i_s
+# * IupSetCallbackIFF_I, :IupSetCallback, [:pointer, :string, :iup_callback_iff_i], :iup_callback_iff_i
+# * IupSetCallbackII_I, :IupSetCallback, [:pointer, :string, :iup_callback_ii_i], :iup_callback_ii_i
+# * IupSetCallbackIIFF_I, :IupSetCallback, [:pointer, :string, :iup_callback_iiff_i], :iup_callback_iiff_i
+# * IupSetCallbackIIFFI_I, :IupSetCallback, [:pointer, :string, :iup_callback_iiffi_i], :iup_callback_iiffi_i
+# * IupSetCallbackIIFFFF_I, :IupSetCallback, [:pointer, :string, :iup_callback_iiffff_i], :iup_callback_iiffff_i
+# * IupSetCallbackIS_I, :IupSetCallback, [:pointer, :string, :iup_callback_is_i], :iup_callback_is_i
+# * IupSetCallbackIIS_I, :IupSetCallback, [:pointer, :string, :iup_callback_iis_i], :iup_callback_iis_i
+# * IupSetCallbackIII_I, :IupSetCallback, [:pointer, :string, :iup_callback_iii_i], :iup_callback_iii_i
+# * IupSetCallbackIIII_I, :IupSetCallback, [:pointer, :string, :iup_callback_iiii_i], :iup_callback_iiii_i
+# * IupSetCallbackIIS_I, :IupSetCallback, [:pointer, :string, :iup_callback_iis_i], :iup_callback_iis_i
+# * IupSetCallbackIIIIS_I, :IupSetCallback, [:pointer, :string, :iup_callback_iiiis_i], :iup_callback_iiiis_i
+# * IupSetCallbackPlain, :IupSetCallback, [:pointer, :string, :iup_callback_plain], :iup_callback_plain
+# * IupSetCallbackPlain_V, :IupSetCallback, [:pointer, :string, :iup_callback_plain_v], :iup_callback_plain_v
+# * IupSetCallbackP_I, :IupSetCallback, [:pointer, :string, :iup_callback_p_i], :iup_callback_p_i
+# * IupSetCallbackPP_I, :IupSetCallback, [:pointer, :string, :iup_callback_pp_i], :iup_callback_pp_i
+# * IupSetCallbackSS_I, :IupSetCallback, [:pointer, :string, :iup_callback_ss_i], :iup_callback_ss_i
+# * IupSetCallbackSSI_I, :IupSetCallback, [:pointer, :string, :iup_callback_ssi_i], :iup_callback_ssi_i
+# * IupSetCallbackSSIII_I, :IupSetCallback, [:pointer, :string, :iup_callback_ssiii_i], :iup_callback_ssiii_i
+# * IupFill, [], :pointer
+# * IupGridBox, [:pointer, :varargs], :pointer
+# * IupVbox, [:pointer, :varargs], :pointer
+# * IupHbox, [:pointer, :varargs], :pointer
+# * IupZbox, [:pointer, :varargs], :pointer
+# * IupRadio, [:pointer], :pointer
+# * IupNormalizer, [:pointer, :varargs], :pointer
+# * IupBackgroundBox, [:pointer], :pointer
+# * IupCbox, [:pointer, :varargs], :pointer
+# * IupDetachBox, [:pointer], :pointer
+# * IupExpander, [:pointer], :pointer
+# * IupSbox, [:pointer], :pointer
+# * IupScrollBox, [:pointer], :pointer
+# * IupSplit, [:pointer, :pointer], :pointer
+# * IupAppend, [:pointer, :pointer], :pointer
+# * IupDetach, [:pointer], :void
+# * IupInsert, [:pointer, :pointer, :pointer], :pointer
+# * IupReparent, [:pointer, :pointer, :pointer], :int
+# * IupGetParent, [:pointer], :pointer
+# * IupGetChild, [:pointer, :int], :pointer
+# * IupGetChildPos, [:pointer, :pointer], :int
+# * IupGetChildCount, [:pointer], :int
+# * IupGetNextChild, [:pointer, :pointer], :pointer
+# * IupGetBrother, [:pointer], :pointer
+# * IupGetDialog, [:pointer], :pointer
+# * IupGetDialogChild, [:pointer, :string], :pointer
+# * IupRefresh, [:pointer], :void
+# * IupRefreshChildren, [:pointer], :void
+# * IupUpdate, [:pointer], :void
+# * IupRedraw, [:pointer, :int], :void
+# * IupConvertXYToPos, [:pointer, :int, :int], :int
+# * IupDialog, [:pointer], :pointer
+# * IupPopup, [:pointer, :int, :int], :int
+# * IupShow, [:pointer], :void
+# * IupShowXY, [:pointer, :int, :int], :int
+# * IupHide, [:pointer], :void
+# * IupFileDlg, [], :pointer
+# * IupMessageDlg, [], :pointer
+# * IupColorDlg, [], :pointer
+# * IupFontDlg, [], :pointer
+# * IupProgressDlg, [], :pointer
+# * IupAlarm, [:string, :string, :string, :string, :string], :int
+# * IupGetFile, [:string], :int
+# * IupGetColor, [:int, :int, :pointer, :pointer, :pointer], :int
+# * IupGetText, [:pointer, :pointer], :int
+# * IupListDialog, [:int, :string, :int, :pointer, :int, :int, :int, :pointer], :int
+# * IupMessage, [:string, :string], :void
+# * IupButton, [:string, :string], :pointer
+# * IupCanvas, [:string], :pointer
+# * IupFrame, [:pointer], :pointer
+# * IupLabel, [:string], :pointer
+# * IupLink, [:string, :string], :pointer
+# * IupList, [:string], :pointer
+# * IupProgressBar, [], :pointer
+# * IupSpin, [], :pointer
+# * IupTabs, [:pointer, :varargs], :pointer
+# * IupText, [:string], :pointer
+# * IupToggle, [:string, :string], :pointer
+# * IupTree, [], :pointer
+# * IupVal, [:string], :pointer
+# * IupImage, [:int, :int, :pointer], :pointer
+# * IupImageRGB, [:int, :int, :pointer], :pointer
+# * IupImageRGBA, [:int, :int, :pointer], :pointer
+# * IupSaveImageAsText, [:pointer, :string, :string, :string], :int
+# * IupNextField, [:pointer], :pointer
+# * IupPreviousField, [:pointer], :pointer
+# * IupGetFocus, [], :pointer
+# * IupSetFocus, [:pointer], :pointer
+# * IupItem, [:string, :string], :pointer
+# * IupMenu, [:pointer, :varargs], :pointer
+# * IupSeparator, [], :pointer
+# * IupSubmenu, [:string, :pointer], :pointer
+# * IupSetHandle, [:string, :pointer], :void
+# * IupGetHandle, [:string], :pointer
+# * IupGetName, [:pointer], :strptr
+# * IupSetLanguage, [:string], :void
+# * IupGetLanguage, [], :strptr
+# * IupClipboard, [], :pointer
+# * IupTimer, [], :pointer
+# * IupHelp, [:string], :int
+# 
+module IupLib 
   extend FFI::Library
 
-  this_dir = File.dirname(__FILE__)
-  case RbConfig::CONFIG['host_os']
-  when /mswin|mingw/
-    ffi_lib 'lib/library/iup.dll'
-  when /linux|cygwin/
-    ffi_lib 'libiup'
-  else
-    raise Exception, 'iup libraries not found for this platform'
+  ffi_lib *Iup::IUP_LIBS
+
+  if /linux|cygwin/ === RbConfig::CONFIG['host_os']
+    # This function returns the GType ID for a PangoFontFamily.
+    # Calling it forces Pango to register its types with GObject.
+    attach_function :pango_font_family_get_type, [], :ulong
+    attach_function :pango_font_face_get_type,   [], :ulong
+    attach_function :pango_font_description_get_type, [], :ulong
+
+    # Note: ping the Pango Type System to register types
+    # between the shared libraries and GObject
+    pango_font_family_get_type()
+    pango_font_face_get_type()
+    pango_font_description_get_type()
   end
 
   # Attributes
@@ -190,17 +333,19 @@ module IupLib # :nodoc:
 
   # helper functions, to create memory structures from arrays
 
+  # Creates a memory structure from an array.
   # Input:: an array of chars
   # Output:: pointer to memory holding array of chars
-  def IupLib.pointer_from_chars array
+  def self.pointer_from_chars array
     ptr = FFI::MemoryPointer.new :char, array.size
     ptr.write_array_of_char array
     return ptr
   end
 
+  # Creates a memory structure from an array.
   # Input:: an array of ints
   # Output:: pointer to memory holding array of ints
-  def IupLib.pointer_from_ints array
+  def self.pointer_from_ints array
     ptr = FFI::MemoryPointer.new :int, array.size
     ptr.write_array_of_int array
     return ptr

data/lib/plain/scintilla-lib.rb

@@ -1,14 +1,16 @@
-module ScintillaLib # :nodoc:
+# Binding to the iup_scintilla shared library.
+# This module can be used to access features not available 
+# in Iup. 
+#
+# For reference, the following functions are bound:
+#
+# * IupScintilla, [], :pointer
+# * IupScintillaOpen, [], :void
+#
+module ScintillaLib
   extend FFI::Library
 
-  case RbConfig::CONFIG['host_os']
- # when /mswin|mingw/
- #   ffi_lib 'lib/library/iupimglib.lib'
-  when /linux|cygwin/
-    ffi_lib 'libiup_scintilla'
-  else
-    raise Exception, 'iup scintilla library not found for this platform'
-  end
+  ffi_lib *Iup::IUP_LIBS
 
   attach_function :IupScintilla, [], :pointer
   attach_function :IupScintillaOpen, [], :void