qtbindings 4.6.3.4 → 4.8.3.0

data/KNOWN_ISSUES.txt

@@ -1,5 +1,19 @@
-1. broadcastsender example fails - undefined method writeDatagram
-2. fortuneserver example fails - undefined method seek
-3. ftp example fails - undefined method icon=
-4. fontsampler example fails - undefined method checkState for nil
-5. passivepopup example fails - seg fault
+1. To run the OpenGL examples install opengl (doesn't work on Ubuntu)
+   gem install opengl --pre
+2. The qRgb macro doesn't appear to work correctly
+3. The following examples fail on Windows:
+   opengl/textures -> Segfault
+   itemview/dirview -> Hangs
+   network/broadcastsender -> writeDatagram(const char* data, ...) fails
+   network/broadcastreceiver -> readDatagram(char* data, ...) fails
+4. The following examples fail on Ubuntu:
+   opengl/* -> opengl doesn't install
+   network/broadcastsender -> writeDatagram(const char* data, ...) fails
+   network/broadcastreceiver -> readDatagram(char* data, ...) fails
+5. The following examples fail on Mac OS X:
+   desktop/screenshot -> QPixmap::scaled: Pixmap is a null pixmap
+   opengl/textures -> glwidget.rb:137
+   network/broadcastsender -> writeDatagram(const char* data, ...) fails
+   network/broadcastreceiver -> readDatagram(char* data, ...) fails
+
+NOTE: The QDBus examples don't work on Windows because QtDBus is Unix only.

data/README.txt

@@ -1,93 +1,119 @@
-qtbindings
-----------
-This project provides bindings that allow the QT Gui toolkit to be used from the
-Ruby Programming language. Overall it is a repackaging of a subset of the KDE 
-bindings ruby and smoke systems into a format that lends itself well to 
-packaging into a Ruby gem.
-
-Goals
------
-1. To make it easy to install a Qt binding for Ruby on all platforms using 
-   RubyGems
-2. To maintain an up-to-date binary gem for Windows that is bundled with 
-   the latest version of Qt from http://qt.nokia.com
-3. To reduce the scope and maintenance of the bindings to only bind to the 
-   libraries provided by the Qt SDK.
-4. To increase compatibility with non-linux platforms
-
-Tested Environments
---------------------
-Mac OSX 10.6.4 (Snow Leopard)
-XCode 3.2.3
-Macports 1.9.1
-qt4-mac 4.6.3
-Cmake 2.8.2
-
-Windows XP SP3
-QT SDK 4.6.3
-Cmake 2.8.2
-Ruby 1.8.7p299 installed from rubyinstaller.org
-
-Ubuntu Linux 10.4
-QT SDK 4.6.3
-Cmake 2.8.2
-
-Compiling
----------
-Compiling qtbindings requires the following prerequisites:
-1. cmake 2.6.3+ installed and in your path
-2. QT 4.6.x installed and in your path
-3. Ruby installed and in your path
-4. gcc 4.x
-
-Additionally: all of the operating system prequisites for compiling, 
-window system development, opengl, etc must be installed.
-
-Operating Systems Notes:
-
-Debian Linux
-------------
-1. The following should get you the packages you need:
-sudo aptitude install build-essential bison openssl libreadline5 
-  libreadline-dev curl git-core zlib1g zlib1g-dev libssl-dev vim 
-  libsqlite3-0 libsqlite3-dev sqlite3 libreadline5-dev libreadline6-dev 
-  libxml2-dev git-core subversion autoconf xorg-dev libgl1-mesa-dev 
-  libglu1-mesa-dev
-
-Mac OSX Snow Leopard
------------------------
-1. XCode
-2. qt4-mac installed from macports - NOTE: For some reason smokegen does 
-   not work with the SDK or Cocoa libraries directly from qt.nokia.com - 
-   Uninstall these if necessary using: 
-   sudo python /Developer/Tools/uninstall_qt.py
-
-Windows - Note: Only necessary for debugging (binary gem available)
---------
-1. mingw from the Qt SDK in your path: ie C:\Qt\2010.04\mingw\bin
-
-Install
-------
-On linux/MacOSX you must make sure you have all the necessary prerequisites 
-installed or the compile will fail. 
-
-gem install qtbindings
-
-This should always work flawlessly on Windows because everything is nicely 
-packaged into a binary gem. However, the gem is very large ~49MB, so please
-be patient while gem downloads the file. 
-
-To get help:
-Sign up to the kdebindings mailing list at:
-https://mail.kde.org/mailman/listinfo/kde-bindings
-You can also file tickets here at github for issues specific to the 
-qtbindings gem.
-
-License:
-This library is released under the LGPL Version 2.1.
-See COPYING.LIB.txt
-
-Disclaimer:
-Almost all of this code was written by the great guys who work on the KDE 
-bindings project, particurly Arno Rehn and Richard Dale. I hope to increase 
-the adoption and use of the code that they have written. 
+qtbindings
+----------
+This project provides bindings that allow the QT Gui toolkit to be used from the
+Ruby Programming language. Overall it is a repackaging of a subset of the KDE 
+bindings ruby and smoke systems into a format that lends itself well to 
+packaging into a Ruby gem.
+
+Goals
+-----
+1. To make it easy to install a Qt binding for Ruby on all platforms using 
+   RubyGems
+2. To maintain an up-to-date binary gem for Windows that is bundled with 
+   the latest version of Qt from http://qt.nokia.com
+3. To reduce the scope and maintenance of the bindings to only bind to the 
+   libraries provided by the Qt SDK.
+4. To increase compatibility with non-linux platforms
+
+Tested Environments
+--------------------
+Mac OSX 10.6.8 (Snow Leopard)
+XCode 3.2.6
+Brew - QT 4.8.2
+Cmake 2.8.6
+
+Windows XP SP3
+QT Libraries 4.8.3
+Mingw 4.4
+Cmake 2.6.4
+Ruby 1.8.7p370 and 1.9.3p0 installed from rubyinstaller.org
+
+Note: Ruby 1.9.3 patch levels 125 and 194 on Windows have a bug in the I/O
+system which prevent the usage of the pos method. That is why I'm using 1.9.3p0.
+  See http://bugs.ruby-lang.org/issues/6179 and http://bugs.ruby-lang.org/issues/6401 
+
+Ubuntu Linux 11.10
+QT SDK 4.8.1
+Cmake 2.8.5
+
+Compiling
+---------
+Compiling qtbindings requires the following prerequisites:
+1. cmake 2.8.x installed and in your path
+2. QT 4.8.x installed and in your path
+3. Ruby installed and in your path
+4. gcc 4.x
+
+Additionally: all of the operating system prequisites for compiling, 
+window system development, opengl, etc must be installed.
+
+Rakefile
+--------
+Perform the following steps to build the gem on Unix or Mac:
+1. rake VERSION=4.8.x.y gem
+     Where the x is the subversion of QT and y is the patch level of qtbindings
+
+Perform the following steps to build the gem on Windows:
+1. Ensure you are running Ruby 1.8.7
+     ruby -v #=> ruby 1.8.7
+2. rake distclean
+3. rake build
+4. Switch to Ruby 1.9.3
+     ruby -v #=> ruby 1.9.3
+5. rake build
+6. rake VERSION=4.8.x.y gemnative
+     Where the x is the subversion of QT and y is the patch level of qtbindings
+
+Note: The gem is built twice to create the FAT binary which will work 
+on both Ruby 1.8 and 1.9. The Windows utility called pik is useful for
+switching between Ruby versions.
+
+After building the gem, verify the examples work by running:
+1. rake examples
+
+Operating Systems Notes:
+
+Debian Linux
+------------
+1. The following should get you the packages you need:
+sudo aptitude install build-essential bison openssl libreadline5 
+  libreadline-dev curl git-core zlib1g zlib1g-dev libssl-dev vim 
+  libsqlite3-0 libsqlite3-dev sqlite3 libreadline5-dev libreadline6-dev 
+  libxml2-dev git-core subversion autoconf xorg-dev libgl1-mesa-dev 
+  libglu1-mesa-dev
+
+Mac OSX Snow Leopard
+-----------------------
+1. XCode
+2. Brew (http://mxcl.github.com/homebrew/)
+   Install qt with 'brew install qt'
+
+Windows - Note: Only necessary for debugging (binary gem available)
+--------
+1. mingw from the Qt SDK in your path: ie C:\Qt\2010.04\mingw\bin
+
+Install
+------
+On linux/MacOSX you must make sure you have all the necessary prerequisites 
+installed or the compile will fail. 
+
+gem install qtbindings
+
+This should always work flawlessly on Windows because everything is nicely 
+packaged into a binary gem. However, the gem is very large ~90MB, so please
+be patient while gem downloads the file. 
+
+To get help:
+Sign up to the kdebindings mailing list at:
+https://mail.kde.org/mailman/listinfo/kde-bindings
+You can also file tickets here at github for issues specific to the 
+qtbindings gem.
+
+License:
+This library is released under the LGPL Version 2.1.
+See COPYING.LIB.txt
+
+Disclaimer:
+Almost all of this code was written by the great guys who work on the KDE 
+bindings project, particurly Arno Rehn and Richard Dale. I hope to increase 
+the adoption and use of the code that they have written. 

data/Rakefile

@@ -1,4 +1,3 @@
-require 'rubygems'
 require 'rake'
 
 windows = false
@@ -17,20 +16,35 @@ end
 
 def set_version
   if ENV['VERSION']
-    File.open('lib/qtbindings_version.rb', 'w') do |file| 
+    File.open('lib/qtbindings_version.rb', 'w') do |file|
       file.write("QTBINDINGS_VERSION = '#{ENV['VERSION']}'\n")
       file.write("QTBINDINGS_RELEASE_DATE = '#{Time.now}'\n")
     end
-  end  
+  end
 end
 
 def clear_version
   if ENV['VERSION']
-    File.open('lib/qtbindings_version.rb', 'w') do |file| 
+    File.open('lib/qtbindings_version.rb', 'w') do |file|
       file.write("QTBINDINGS_VERSION = '0.0.0.0'\n")
       file.write("QTBINDINGS_RELEASE_DATE = ''\n")
     end
-  end    
+  end
+end
+
+task :build_examples do
+  # Go into the examples directory and look for all the makefiles and build them
+  Dir['examples/**/makefile'].each do |file|
+    if windows
+      system("cd #{File.dirname(file).gsub('/', '\\')} && #{MAKE}")
+    else
+      system("cd #{File.dirname(file)} && #{MAKE}")
+    end
+  end
+end
+
+task :examples => [:build_examples] do
+  system('cd examples && ruby run_all.rb')
 end
 
 task :default => [:all]
@@ -39,30 +53,27 @@ task :extconf do
   system('ruby extconf.rb')
 end
 
-task :all => [:extconf] do  
+# All calls 'make clean' and 'make build'
+task :all => [:extconf] do
   system("#{MAKE} all")
 end
 
-task :clean => [:extconf] do  
+task :clean => [:extconf] do
   system("#{MAKE} clean")
 end
 
-task :distclean => [:extconf] do  
+task :distclean => [:extconf] do
   system("#{MAKE} distclean")
 end
 
-task :build => [:extconf] do  
+task :make_build => [:extconf] do
   system("#{MAKE} build")
 end
 
-task :install => [:extconf] do  
+task :install => [:extconf] do
   system("#{MAKE} install")
 end
 
-task :installqt => [:extconf] do  
-  system("#{MAKE} installqt")
-end
-
 task :gem => [:distclean] do
   warn_version()
   set_version()
@@ -70,27 +81,17 @@ task :gem => [:distclean] do
   clear_version()
 end
 
-task :gemnative => [:clean] do
+task :gemnative do
   warn_version()
   set_version()
+  system("#{MAKE} installqt")
   system("gem build qtbindingsnative.gemspec")
   clear_version()
 end
 
-task :gemwindows => [:installqt, :gemnative]
-
-task :ryanbuildwindows do
-  if RUBY_VERSION.split('.')[1].to_i == 9
-    system("move C:\\Ruby C:\\Ruby191 && move C:\\Ruby187 C:\\Ruby")
-  end
-  Rake::Task[:extconf].execute
-  Rake::Task[:all].execute
-  Rake::Task[:install].execute
-  system("move C:\\Ruby C:\\Ruby187 && move C:\\Ruby191 C:\\Ruby")
+task :build do
   Rake::Task[:extconf].execute
   Rake::Task[:all].execute
   Rake::Task[:install].execute
-  system("move C:\\Ruby C:\\Ruby191 && move C:\\Ruby187 C:\\Ruby")
 end
 
-task :ryangemwindows => [:ryanbuildwindows, :gemwindows]

data/examples/desktop/systray/window.rb

@@ -22,24 +22,24 @@
 
 ** Translated to QtRuby by Richard Dale
 =end
-    
+
 class Window < Qt::Widget
-    
+
     slots    'setIcon(int)',
             'iconActivated(QSystemTrayIcon::ActivationReason)',
             :showMessage,
             :messageClicked
-    
+
     def initialize(parent = nil)
         super(parent)
         createIconGroupBox()
         createMessageGroupBox()
-    
+
         @iconLabel.minimumWidth = @durationLabel.sizeHint.width
-    
+
         createActions()
         createTrayIcon()
-    
+
         connect(@showMessageButton, SIGNAL(:clicked), self, SLOT(:showMessage))
         connect(@showIconCheckBox, SIGNAL('toggled(bool)'),
                 @trayIcon, SLOT('setVisible(bool)'))
@@ -48,26 +48,26 @@ class Window < Qt::Widget
         connect(@trayIcon, SIGNAL(:messageClicked), self, SLOT(:messageClicked))
         connect(@trayIcon, SIGNAL('activated(QSystemTrayIcon::ActivationReason)'),
                 self, SLOT('iconActivated(QSystemTrayIcon::ActivationReason)'))
-    
+
         self.layout = Qt::VBoxLayout.new do |m|
             m.addWidget(@iconGroupBox)
             m.addWidget(@messageGroupBox)
         end
-    
+
         @iconComboBox.currentIndex = 1
         @trayIcon.show
-    
+
         setWindowTitle(tr("Systray"))
         resize(400, 300)
     end
-    
+
     def setVisible(visible)
         @minimizeAction.enabled = visible
         @maximizeAction.enabled = !visible
         @restoreAction.enabled = !visible
         super(visible)
     end
-    
+
     def closeEvent(event)
         if @trayIcon.visible?
             Qt::MessageBox.information(self, tr("Systray"),
@@ -80,54 +80,50 @@ class Window < Qt::Widget
             event.ignore()
         end
     end
-    
+
     def setIcon(index)
         icon = @iconComboBox.itemIcon(index)
         @trayIcon.icon = icon
         setWindowIcon(icon)
-    
+
         @trayIcon.toolTip = @iconComboBox.itemText(index)
     end
-    
+
     def iconActivated(reason)
         case reason
-        when Qt::SystemTrayIcon::Trigger:
-        when Qt::SystemTrayIcon::DoubleClick:
+        when Qt::SystemTrayIcon::Trigger
+        when Qt::SystemTrayIcon::DoubleClick
             @iconComboBox.currentIndex = (iconComboBox.currentIndex + 1) % @iconComboBox.length
-            break
-        when Qt::SystemTrayIcon::MiddleClick:
+        when Qt::SystemTrayIcon::MiddleClick
             showMessage()
-            break
-        else
-            
         end
     end
-    
+
     def showMessage()
         icon = @typeComboBox.itemData(@typeComboBox.currentIndex).to_i
         @trayIcon.showMessage(@titleEdit.text, @bodyEdit.toPlainText, icon,
                               @durationSpinBox.value() * 1000)
     end
-    
+
     def messageClicked()
         Qt::MessageBox.information(nil, tr("Systray"),
                                  tr("Sorry, I already gave what help I could.\n" \
                                     "Maybe you should try asking a human?"))
     end
-    
+
     def createIconGroupBox()
         @iconGroupBox = Qt::GroupBox.new(tr("Tray Icon"))
-    
+
         @iconLabel = Qt::Label.new("Icon:")
-    
+
         @iconComboBox = Qt::ComboBox.new
         @iconComboBox.addItem(Qt::Icon.new(":/images/bad.svg"), tr("Bad"))
         @iconComboBox.addItem(Qt::Icon.new(":/images/heart.svg"), tr("Heart"))
         @iconComboBox.addItem(Qt::Icon.new(":/images/trash.svg"), tr("Trash"))
-    
+
         @showIconCheckBox = Qt::CheckBox.new(tr("Show icon"))
         @showIconCheckBox.checked = true
-    
+
         @iconGroupBox.layout = Qt::HBoxLayout.new do |l|
             l.addWidget(@iconLabel)
             l.addWidget(@iconComboBox)
@@ -135,27 +131,27 @@ class Window < Qt::Widget
             l.addWidget(@showIconCheckBox)
         end
     end
-    
+
     def createMessageGroupBox()
         @messageGroupBox = Qt::GroupBox.new(tr("Balloon Message"))
-    
+
         @typeLabel = Qt::Label.new(tr("Type:"))
-    
+
         @typeComboBox = Qt::ComboBox.new
         @typeComboBox.addItem(tr("None"), Qt::Variant.new(Qt::SystemTrayIcon::NoIcon.to_i))
-        @typeComboBox.addItem(style().standardIcon(Qt::Style::SP_MessageBoxInformation), 
+        @typeComboBox.addItem(style().standardIcon(Qt::Style::SP_MessageBoxInformation),
                 tr("Information"),
                 Qt::Variant.new(Qt::SystemTrayIcon::Information.to_i))
-        @typeComboBox.addItem(style().standardIcon(Qt::Style::SP_MessageBoxWarning), 
+        @typeComboBox.addItem(style().standardIcon(Qt::Style::SP_MessageBoxWarning),
                               tr("Warning"),
                               Qt::Variant.new(Qt::SystemTrayIcon::Warning.to_i))
-        @typeComboBox.addItem(style().standardIcon(Qt::Style::SP_MessageBoxCritical), 
+        @typeComboBox.addItem(style().standardIcon(Qt::Style::SP_MessageBoxCritical),
                               tr("Critical"),
                               Qt::Variant.new(Qt::SystemTrayIcon::Critical.to_i))
         @typeComboBox.currentIndex = 1
-    
+
         @durationLabel = Qt::Label.new(tr("Duration:"))
-    
+
         @durationSpinBox = Qt::SpinBox.new do |s|
             s.range = 5..60
             s.suffix = " s"
@@ -165,20 +161,20 @@ class Window < Qt::Widget
         @durationWarningLabel = Qt::Label.new(tr("(some systems might ignore self " \
                                              "hint)"))
         @durationWarningLabel.indent = 10
-    
+
         @titleLabel = Qt::Label.new(tr("Title:"))
-    
+
         @titleEdit = Qt::LineEdit.new(tr("Cannot connect to network"))
-    
+
         @bodyLabel = Qt::Label.new(tr("Body:"))
-    
+
         @bodyEdit = Qt::TextEdit.new
         @bodyEdit.setPlainText(tr("Don't believe me. Honestly, I don't have a " \
                                   "clue.\nClick self balloon for details."))
-    
+
         @showMessageButton = Qt::PushButton.new(tr("Show Message"))
         @showMessageButton.default = true
-    
+
         @messageGroupBox.layout = Qt::GridLayout.new do |m|
             m.addWidget(@typeLabel, 0, 0)
             m.addWidget(@typeComboBox, 0, 1, 1, 2)
@@ -194,21 +190,21 @@ class Window < Qt::Widget
             m.setRowStretch(4, 1)
         end
     end
-    
+
     def createActions()
         @minimizeAction = Qt::Action.new(tr("Mi&nimize"), self)
         connect(@minimizeAction, SIGNAL(:triggered), self, SLOT(:hide))
-    
+
         @maximizeAction = Qt::Action.new(tr("Ma&ximize"), self)
         connect(@maximizeAction, SIGNAL(:triggered), self, SLOT(:showMaximized))
-    
+
         @restoreAction = Qt::Action.new(tr("&Restore"), self)
         connect(@restoreAction, SIGNAL(:triggered), self, SLOT(:show))
-    
+
         @quitAction = Qt::Action.new(tr("&Quit"), self)
         connect(@quitAction, SIGNAL(:triggered), $qApp, SLOT(:quit))
     end
-    
+
     def createTrayIcon()
         @trayIconMenu = Qt::Menu.new(self) do |t|
             t.addAction(@minimizeAction)