RubyGems - qt_connect - Versions diffs - 1.5.1 - Mend

qt_connect 1.5.1

Files changed (27) hide show

data/COPYING.LIB.txt +510 -0
data/README.md +257 -0
data/Rakefile +72 -0
data/examples/classexplorer/classexplorer.rb +828 -0
data/examples/classexplorer/menus.rb +1 -0
data/examples/classexplorer/menus/helpmenu.rb +73 -0
data/examples/classexplorer/packagetree.rb +91 -0
data/examples/classexplorer/qt_extensions.rb +2 -0
data/examples/classexplorer/qt_extensions/htmldelegate.rb +40 -0
data/examples/classexplorer/qt_extensions/line_edit.rb +65 -0
data/examples/deform/Deform.html +23 -0
data/examples/deform/Thumbs.db +0 -0
data/examples/deform/arthurframe.rb +273 -0
data/examples/deform/deform-demo.png +0 -0
data/examples/deform/deform.rb +502 -0
data/examples/deform/qt-logo.png +0 -0
data/examples/qtmapzoom/qtmapzoom.rb +340 -0
data/java/SignalActions.java +13 -0
data/lib/Qt.rb +10 -0
data/lib/qt_connect.rb +12 -0
data/lib/qt_connect/qt_compat.rb +700 -0
data/lib/qt_connect/qt_jbindings.rb +657 -0
data/lib/qt_connect/qt_sugar.rb +277 -0
data/lib/qt_connect/version.rb +3 -0
data/lib/qt_jambi.rb +8 -0
data/lib/signalactions.jar +0 -0
metadata +92 -0

data/examples/classexplorer/menus.rb ADDED

	@@ -0,0 +1 @@
1	+ require 'menus/helpmenu'

data/examples/classexplorer/menus/helpmenu.rb ADDED

@@ -0,0 +1,73 @@
+# encoding: utf-8
+module Menus
+  class HelpMenu
+    def initialize(window,menubar)
+      @window=window
+      Qt::Menu.new(menubar) { |helpMenu|
+        menubar.addAction(helpMenu.menuAction)
+        helpMenu.title="Help"
+        # Help> Contents
+        Qt::Action.new(window) { |action|
+          action.text="Contents"
+          action.icon=window.style.standardIcon(Qt::Style::SP_DesktopIcon)
+          action.triggered.connect { Qt::MessageBox.about(window,'Qt_connect',contents)}
+          helpMenu.addAction(action)
+        }
+        helpMenu.addSeparator
+        #Help> About Qt
+        Qt::Action.new(window) { |action|
+          action.text="About Qt"
+          action.triggered.connect { Qt::MessageBox.aboutQt(window) } #$qApp.aboutQt}
+          helpMenu.addAction(action)
+        }
+        helpMenu.addSeparator
+        #Help> About Qt Jambi
+        Qt::Action.new(window) { |action|
+          action.text="About Qt Jambi"
+          action.triggered.connect { $qApp.aboutQtJambi } #$qApp.aboutQt}
+          helpMenu.addAction(action)
+        }
+      }
+    end
+    def contents
+%Q[
+<html><h1>Qt_Connect Class Explorer</h1>
+<font size="+1">
+<p>This browser extends the Javadoc documentation for the <b>com.trolltech.qt</b> Java packages that form
+the basis for the JRuby Qt Jambi API.</p>
+<p>The left hand top frame displays all packages found on the Java CLASSPATH which implement the Qt framework.
+You can select one or more of these packages for inspection. By default all packages are selected.<br/>
+The lower panel displays all Classes and Interfaces which belong to the selected packages mapped to
+the same Ruby <b>Qt</b> namespace.</p>
+<p>The mapping rules from full-package name for each class in Java to Ruby namespace
+are simple: when a class name starts with either 'Qt' or 'Q' that part of the name is dropped, otherwise it is unchanged.</p>
+Examples:</p>
+<table cellpadding="3" cellspacing="0">
+<tr><td>com.trolltech.qt.QSysInfo</td><td>Qt::SysInfo</td></tr>
+<tr><td>com.trolltech.qt.Utilities</td><td>Qt::Utilities</td></tr>
+<tr><td>com.trolltech.qt.gui.QToolButton</td><td>Qt::ToolButton</td></tr>
+<tr><td>com.trolltech.qt.svg.QSvgWidget</td><td>Qt::SvgWidget</td></tr>
+<tr><td>com.trolltech.qt.QtEnumerator</td><td>Qt::Enumerator</td></tr>
+</table>
+<p>The number of classes displayed can be narrowed down by entering a filter value in the bottom field</p>
+<p>The next panel displays a summary for the selected Class or Interface from the JRuby perspective: Java fields and methods
+are mapped to Ruby Constants, Class Methods and Instance Methods. Fields inheriting the SignalEmitter class are
+separately listed as <b>Signals</b> with prototypes of the methods or blocks they can connect to.</p>
+<p>Constants which inherit the Qt::Enumerator module are separately listed as <b>Enums</b> with their enumerated values and shorthand
+notations.</p>
+<p>In the right-hand top of the panel a box can be ticked to include or exclude members of inherited Qt classes. If you tick the
+<em>'link to Qt Jambi Reference Documentation'</em> box, a separate (dockable) window opens displaying the matching Javadoc documentation.
+If you use this feature, make sure the Javadoc root url matches the version of Qt Jambi you have installed.</p>
+<p>
+</p></font></html>
+      ]
+    end
+  end
+end

data/examples/classexplorer/packagetree.rb ADDED

@@ -0,0 +1,91 @@
+#encoding: utf-8
+require 'qt_connect'
+#Scans all classes accessible from JRuby runtime classloader
+#Cees Zeelenberg (c.zeelenberg@computer.org)
+#partially adapted from: snippets.dzone.com/posts/show/4831  (Java)
+#N.B. filters out selected classes specific to QtJambi !!!
+#PackageTree#keys     => [packagename + subpackage names]
+#PackageTree#values  => [all packages in tree]
+#PackageTree['packagename'] => package
+#Package#classes => [classnames in package]
+#Cees Zeelenberg
+#Get all classes within a package
+class PackageTree < Hash
+  class Package
+    attr_accessor :classes,:innerclasses,:path,:parent,:children
+    def initialize(packagetree,package_name)
+      @package_name=package_name
+      @packagetree=packagetree
+      @classes=[]
+      @children=[]
+      pp=package_name.split('.').slice(0...-1).join('.')
+      @parent=(pp.size>0) ? (packagetree[pp] || Package.new(packagetree,pp)) : nil
+      @parent.children << self if @parent
+    end
+  end
+  def initialize(root_package_name)
+    @root_package_name=root_package_name
+    @packages=super()
+    @packages[root_package_name]= Package.new(self,root_package_name)
+    @jars={}
+    path=@root_package_name.gsub('.','/')
+    class_loader=JRuby.runtime.jruby_class_loader
+    resources=class_loader.getResources(path)
+    dirs=[]
+    while resources.hasMoreElements
+      resource=resources.nextElement
+      dirs << resource.getFile
+    end
+    classpaths=[]
+    dirs.each{ |dir| classpaths += findClasses(dir,@root_package_name)}
+    classpaths.uniq.each{ |klasspath|
+      next if klasspath.end_with?('$ConcreteWrapper')
+      next if klasspath.end_with?('$QtJambi_LibrariInitializer')
+      next if klasspath.end_with?('$1') #anonymous inner class?
+      elems=klasspath.split('.')
+      klass=elems.pop
+      package_name=elems.join('.')
+      @packages[package_name]=package=@packages[package_name] || Package.new(self,package_name)
+      package.classes << klass
+    }
+  end
+  def jars
+    return @jars.keys.join(',')
+  end
+  def findClasses(path,package_name)
+    classes=[]
+    if path.start_with?("file:") && path.include?("!")
+      split=path.split("!")
+      jar=java.net.URL.new(split[0])
+      @jars[split[0][6..-1]]=true
+      zip=java.util.zip.ZipInputStream.new(jar.openStream)
+      while entry=zip.getNextEntry
+        if entry.getName.end_with?(".class")
+          class_name=entry.getName.gsub(/[.]class/,'').gsub('/','.')
+          classes << class_name if class_name.start_with?(package_name)
+        end
+      end
+    end
+    dir=java.io.File.new(path)
+    return classes if !dir.exists
+    dir.listFiles.each{ |file|
+      if file.isDirectory
+        raise 'hell' if file.include?('.')
+        classes += findClasses(file.getAbsolutePath, package_name + '.' + file.getName)
+      elsif file.getName.end_with?(".class")
+        classes += Java::Class.forName(package_name + '.' + file.getName[0..-7])
+      end
+    }
+    return classes
+  end
+end

data/examples/classexplorer/qt_extensions.rb ADDED

	@@ -0,0 +1,2 @@
1	+ require 'qt_extensions/line_edit.rb'
2	+ require 'qt_extensions/htmldelegate.rb'

data/examples/classexplorer/qt_extensions/htmldelegate.rb ADDED

@@ -0,0 +1,40 @@
+#
+#Itemdelegate allowing the use of html-formatted items
+#use stylesheets for special formatting of tagged text (see defaultdoc)
+#provide external Qt::TextDocument (HtmlDelegat#doc=) for more flexibility
+module QtExtensions
+  class HtmlDelegate < Qt::ItemDelegate
+    attr_accessor :doc
+    def paint(painter, option, index)
+      drawBackground(painter,option,index)
+      @doc||= defaultdoc
+      item=index.model.data(index).toString
+      if (option.state.value & Qt::Style::State_Selected.value) !=0
+        item=%Q[<span class="selected">#{item}</span>]
+      end
+      @doc.setHtml(item)
+      painter.save
+      painter.translate(option.rect.topLeft)
+      r=Qt::RectF.new(0,0,option.rect.width,option.rect.height)
+      @doc.drawContents(painter,r)
+      painter.restore
+    end
+    def defaultdoc
+      return Qt::TextDocument.new { |d|
+        d.defaultStyleSheet=%Q[.hilite {background-color: yellow;color:black; }
+        .selected {color: white}
+        .special {color: goldenrod}
+        ]}
+    end
+    def sizeHint(option,index)
+      @doc||=defaultdoc
+      @doc.setHtml(index.model.data(index).toString)
+      return @doc.size.toSize
+    end
+  end
+end

data/examples/classexplorer/qt_extensions/line_edit.rb ADDED

@@ -0,0 +1,65 @@
+#
+#Qt::LineEdit
+#extended with Clearbutton Icon in right handcorner (SP_BrowserStop)
+#extended with Placeholdertext in Grey when empty and not in focus
+#functionality (partially?) added for Qt 4.7
+module QtExtensions
+  class LineEdit < Qt::LineEdit
+    def setClearButton
+      @clearButton=Qt::ToolButton.new(self){ |b|
+        b.icon=style.standardIcon(Qt::Style::SP_BrowserStop)
+        b.iconSize=Qt::Size.new(16,16)
+        b.cursor=Qt::Cursor.new(Qt::ArrowCursor)
+        b.styleSheet="border:none; padding: 0px;"
+        b.hide
+        b.clicked.connect{self.clear}
+      }
+      self.textChanged.connect{ |s| @clearButton.visible=(s.size>0)}
+      frameWidth=self.style.pixelMetric(Qt::Style::PM_DefaultFrameWidth)
+      padding=@clearButton.sizeHint.width+frameWidth+1
+      self.styleSheet="padding-right: #{padding}px;"
+      msz=self.minimumSizeHint
+      self.minimumSize=Qt::Size.new(
+        [msz.width,@clearButton.sizeHint.height+frameWidth*2+2].max,
+        [msz.height,@clearButton.sizeHint.height+frameWidth*2+2].max)
+      end
+    def resizeEvent(event)
+      super(event)
+      if @clearButton
+        sz=@clearButton.sizeHint
+        frameWidth=self.style.pixelMetric(Qt::Style::PM_DefaultFrameWidth)
+        @clearButton.move(rect.right-frameWidth-sz.width,
+                          (rect.bottom+1-sz.height)/2)
+      end
+      if @placeholder
+        sz=@placeholder.sizeHint
+        @placeholder.move(2,2)
+      end
+    end
+    def placeholderText=(s)
+      @placeholder.text='' if @placeholder
+      @placeholder=Qt::Label.new(self) { |p|
+        p.styleSheet="color:grey;font:italic;"
+        p.move(2,2)
+        p.minimumWidth=self.width-4
+        p.text=s
+        p.visible=true
+      }
+    end
+    def focusInEvent(e)
+      @placeholder.visible=false if @placeholder
+      super(e)
+    end
+    def focusOutEvent(e)
+      @placeholder.visible=(text.size==0) if @placeholder
+      super(e)
+    end
+    def text=(x)
+      @placeholder.visible=((x.size==0) && !hasFocus) if @placeholder
+      super(x)
+    end
+  end
+end

data/examples/deform/Deform.html ADDED

@@ -0,0 +1,23 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!DOCTYPE html
+    PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "DTD/xhtml1-strict.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<!-- ../src/demos/deform.qdoc -->
+<head>
+  <title>Vector Deformation</title>
+    <style type="text/css">h3.fn,span.fn { margin-left: 1cm; text-indent: -1cm; }
+a:link { color: #004faf; text-decoration: none }
+a:visited { color: #672967; text-decoration: none }
+td.postheader { font-family: sans-serif }
+tr.address { font-family: sans-serif }
+body { color: black; }</style>
+</head>
+<body>
+<h1 class="title">Vector Deformation<br /><span class="subtitle"></span>
+</h1>
+<p>This demo shows how to use advanced vector techniques to draw text using a <tt>QPainterPath</tt>.</p>
+<p align="center"><img src="deform-demo.png" /></p><p>We define a vector deformation field in the shape of a lens and apply this to all points in a path. This means that what is rendered on screen is not pixel manipulation, but modified vector representations of the glyphs themselves. This is visible from the high quality of the antialiased edges for the deformed glyphs.</p>
+<p>To get a fairly complex path we allow the user to type in text and convert the text to paths. This is done using the QPainterPath::addText() method.</p>
+<p>The lens is drawn using a single call to QPainter::drawEllipse(), using a QRadialGradient to fill it with a specialized color table, giving the effect of the sun's reflection and a drop shadow. The lens is cached as a pixmap for better performance.</p>
+</body>
+</html>

data/examples/deform/Thumbs.db ADDED

Binary file

data/examples/deform/arthurframe.rb ADDED

@@ -0,0 +1,273 @@
+=begin
+**
+** Copyright (C) 1992-2009 Nokia. All rights reserved.
+**
+** This file is part of Qt Jambi.
+**
+** ** $BEGIN_LICENSE$
+** Commercial Usage
+** Licensees holding valid Qt Commercial licenses may use this file in
+** accordance with the Qt Commercial License Agreement provided with the
+** Software or, alternatively, in accordance with the terms contained in
+** a written agreement between you and Nokia.
+**
+** GNU Lesser General Public License Usage
+** Alternatively, this file may be used under the terms of the GNU Lesser
+** General Public License version 2.1 as published by the Free Software
+** Foundation and appearing in the file LICENSE.LGPL included in the
+** packaging of this file.  Please review the following information to
+** ensure the GNU Lesser General Public License version 2.1 requirements
+** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
+**
+** In addition, as a special exception, Nokia gives you certain
+** additional rights. These rights are described in the Nokia Qt LGPL
+** Exception version 1.0, included in the file LGPL_EXCEPTION.txt in this
+** package.
+**
+** GNU General Public License Usage
+** Alternatively, this file may be used under the terms of the GNU
+** General Public License version 3.0 as published by the Free Software
+** Foundation and appearing in the file LICENSE.GPL included in the
+** packaging of this file.  Please review the following information to
+** ensure the GNU General Public License version 3.0 requirements will be
+** met: http://www.gnu.org/copyleft/gpl.html.
+**
+** If you are unsure which license is appropriate for your use, please
+** contact the sales department at qt-sales@nokia.com.
+** $END_LICENSE$
+**
+** This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE
+** WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
+**
+** Ruby implementation by by Cees Zeelenberg
+=end
+class ArthurFrame < Qt::Widget
+  attr_accessor :descriptionEnabledChanged
+  def initialize(parent)
+    @prefer_image = true
+    @show_doc = false
+    @document = nil
+    @sourceFilename = ""
+    @static_image = nil
+    super(parent)
+    @descriptionEnabledChanged = Qt::Signal.new
+    @tile = Qt::Pixmap.new(100, 100)
+    @tile.fill(Qt::Color.white)
+    color = Qt::Color.new(240, 240, 240)
+    pt = Qt::Painter.new
+    pt.begin(@tile)
+    pt.fillRect(0, 0, 50, 50, Qt::Brush.new(color))
+    pt.fillRect(50, 50, 50, 50, Qt::Brush.new(color))
+    pt.end
+  end
+    def paint(painter)
+    super(painter)
+    end
+  def loadDescription(filename)
+    textFile = Qt::File.new(filename)
+    if !textFile.open(Qt::File::ReadOnly)
+        text = "Unable to load resource file: " + filename
+    else
+        ba = textFile.readAll
+        codec = Qt::TextCodec.codecForHtml(ba)
+        text = codec.toUnicode(ba)
+    end
+    setDescription(text)
+  end
+  def setDescription(description)
+    @document = Qt::TextDocument.new(self)
+    @document.setHtml(description)
+  end
+  def paintDescription(painter)
+    return unless @document
+    pageWidth = [width - 100, 100].max
+    pageHeight = [height - 100, 100].max
+    @document.setPageSize(Qt::SizeF.new(pageWidth, pageHeight)) if pageWidth != @document.pageSize.width
+    textRect = Qt::Rect.new(width / 2 - pageWidth / 2,
+                                   height / 2 - pageHeight / 2,
+                                   pageWidth, pageHeight)
+    pad = 10
+    clearRect = textRect.adjusted(-pad, -pad, pad, pad)
+    painter.setPen(Qt::NoPen)
+    painter.setBrush(Qt::Brush.new(Qt::Color.new(0, 0, 0, 63)))
+    shade = 10
+    painter.drawRect(clearRect.x + clearRect.width + 1,
+                     clearRect.y + shade,
+                     shade, clearRect.height + 1)
+    painter.drawRect(clearRect.x + shade, clearRect.y + clearRect.height + 1,
+            clearRect.width - shade + 1, shade)
+    painter.setRenderHint(Qt::Painter::Antialiasing, false)
+    painter.setBrush(Qt::Brush.new(Qt::Color.new(255, 255, 255, 220)))
+    painter.setPen(Qt::Color.black)
+    painter.drawRect(clearRect)
+    painter.setClipRegion(Qt::Region.new(textRect), Qt::IntersectClip)
+    painter.translate(textRect.topLeft)
+    ctx =Qt::AbstractTextDocumentLayout::PaintContext.new
+    g = Qt::LinearGradient.new(0, 0, 0, textRect.height) {
+      setColorAt(0, Qt::Color.black)
+      setColorAt(0.9, Qt::Color.black)
+      setColorAt(1, Qt::Color.transparent)
+    }
+    pal = Qt::Palette.new
+    pal.setBrush(Qt::Palette::Text, Qt::Brush.new(g))
+    ctx.setPalette(pal)
+    ctx.setClip(Qt::RectF.new(0, 0, textRect.width, textRect.height))
+    @document.documentLayout.draw(painter, ctx)
+  end
+  def loadSourceFile(sourceFile)
+    @sourceFilename = sourceFile
+  end
+  def showSource(tf)
+      f = Qt::File.new(@sourceFilename)
+      if !f.open(Qt::File::ReadOnly)
+        contents = "Could not open file: " + @sourceFilename
+      else
+        ba = f.readAll
+        codec = Qt::TextCodec.codecForLocale
+        contents = codec.toUnicode(ba)
+      end
+      f.close
+      contents = contents.gsub("&", "&amp")
+      contents = contents.gsub("<", "&lt")
+      contents = contents.gsub(">", "&gt")
+      keywords=%w(for if switch int const void case double static new this package true false public protected
+        private final native import extends implements else class super for)
+      keywords.each{| keyword|
+          contents = contents.gsub(keyword){ |m| "<font color=olive>" + keyword + "</font>"}
+      }
+      contents = contents.gsub("(int ", "(<font color=olive><b>int </b></font>")
+      contents = contents.gsub("(\\d\\d?)", "<font color=navy>$1</font>")
+      commentRe = "(//.+)\\n"
+      # commentRe.setMinimal(true)
+      contents = contents.gsub(commentRe, "<font color=red>$1</font>\n")
+      stringLiteralRe = "(\".+\")"
+      # stringLiteralRe.setMinimal(true)
+      contents = contents.gsub(stringLiteralRe, "<font color=green>$1</font>")
+      html = contents
+      @html = "<html><pre>" + html + "</pre></html>"
+      @sourceViewer = Qt::TextBrowser.new { |v|
+        v.setWindowTitle("Source:  + #{@sourceFilename}")
+        v.setAttribute(Qt::WA_DeleteOnClose)
+        v.setHtml(@html)
+        v.resize(600, 600)
+        v.show
+      }
+    end
+  def preferImage
+      return @prefer_image
+  end
+  def setPreferImage(pi)
+    @prefer_image = pi
+  end
+  def setDescriptionEnabled(enabled)
+    if (@show_doc != enabled)
+      @show_doc = enabled
+      @descriptionEnabledChanged.emit(@show_doc)
+      update
+    end
+  end
+    #@Override
+    def paintEvent(e)
+      painter = Qt::Painter.new
+      if (preferImage)
+        if @static_image.nil?
+          @static_image = Qt::Image.new(size, Qt::Image::Format_RGB32)
+        elsif @static_image.size.width != size.width || @static_image.size.height != size.height
+          @static_image = Qt::Image.new(size, Qt::Image::Format_RGB32)
+        end
+        painter.begin(@static_image)
+        o = 10
+        bg = palette.brush(Qt::Palette::Window)
+        painter.fillRect(0, 0, o, o, bg)
+        painter.fillRect(width - o, 0, o, o, bg)
+        painter.fillRect(0, height - o, o, o, bg)
+        painter.fillRect(width - o, height - o, o, o, bg)
+      else
+        painter.begin(self)
+      end
+      painter.setClipRect(e.rect)
+      painter.setRenderHint(Qt::Painter::Antialiasing)
+      r = rect
+      left = r.x + 1
+      top = r.y + 1
+      right = r.right
+      bottom = r.bottom
+      radius2 = 8 * 2
+      clipPath = Qt::PainterPath.new{
+        moveTo(right - radius2, top)
+        arcTo(right - radius2, top, radius2, radius2, 90, -90)
+        arcTo(right - radius2, bottom - radius2, radius2, radius2, 0, -90)
+        arcTo(left, bottom - radius2, radius2, radius2, 270, -90)
+        arcTo(left, top, radius2, radius2, 180, -90)
+        closeSubpath
+      }
+      painter.save
+      painter.setClipPath(clipPath, Qt::IntersectClip)
+      painter.drawTiledPixmap(rect, @tile)
+      paint(painter)
+      painter.restore
+      painter.save
+      paintDescription(painter) if (@show_doc)
+      painter.restore
+      level = 180
+      painter.setPen(Qt::Pen.new(Qt::Brush.new(Qt::Color.new(level, level, level)), 2))
+      painter.setBrush(Qt::NoBrush)
+      painter.drawPath(clipPath)
+      if (preferImage)
+        painter.end
+       painter.begin(self)
+        painter.drawImage(e.rect, @static_image, e.rect)
+      end
+      painter.end
+    end
+end