reorganized SVN tree into branches, tags and trunk

git-svn-id: http://svn.code.sf.net/p/pythonqt/code/trunk@32 ea8d5007-eb21-0410-b261-ccb3ea6e24a9
commontk · Aug 28, 2008 · 9c293e4 · 9c293e4
commit 9c293e4
Show file tree

Hide file tree

Showing 95 changed files with 15,351 additions and 0 deletions.
diff --git a/COPYING b/COPYING
diff --git a/PythonQt.pro b/PythonQt.pro
@@ -0,0 +1,4 @@
+TEMPLATE = subdirs
+
+CONFIG += ordered
+SUBDIRS = src extensions tests examples
diff --git a/README b/README
@@ -0,0 +1,18 @@
+PythonQt
+--------
+
+PythonQt is a dynamic Python (http://www.python.org) binding for Qt (http://www.trolltech.com).
+It offers an easy way to embedd the Python scripting language into
+your Qt applications. It makes heavy use of the QMetaObject system and thus requires Qt4.x.
+
+Licensing
+---------
+PythonQt is distributed under the LGPL license.
+
+Documentation
+-------------
+
+More documentation is available at:
+
+http://pythonqt.sourceforge.net/
+
diff --git a/doxygen/createDoc.bat b/doxygen/createDoc.bat
@@ -0,0 +1 @@
+doxygen doc.cfg
diff --git a/doxygen/doc.cfg b/doxygen/doc.cfg
diff --git a/doxygen/header.html b/doxygen/header.html
@@ -0,0 +1,7 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1">
+<title>$title</title>
+<link href="$relpath$doxygen.css" rel="stylesheet" type="text/css">
+<link href="$relpath$tabs.css" rel="stylesheet" type="text/css">
+</head><body>
+<div style="float:right;"> <a href="http://sourceforge.net"><img src="http://sflogo.sourceforge.net/sflogo.php?group_id=181737&amp;type=1" width="88" height="31" border="0" alt="SourceForge.net Logo" /></a></div>
diff --git a/examples/PyCPPWrapperExample/CustomObjects.cpp b/examples/PyCPPWrapperExample/CustomObjects.cpp
@@ -0,0 +1,43 @@
+/*
+ *
+ *  Copyright (C) 2006 MeVis Research GmbH All Rights Reserved.
+ *
+ *  This library is free software; you can redistribute it and/or
+ *  modify it under the terms of the GNU Lesser General Public
+ *  License as published by the Free Software Foundation; either
+ *  version 2.1 of the License, or (at your option) any later version.
+ *
+ *  This library is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+ *  Lesser General Public License for more details.
+ *
+ *  Further, this software is distributed without any warranty that it is
+ *  free of the rightful claim of any third person regarding infringement
+ *  or the like.  Any license provided herein, whether implied or
+ *  otherwise, applies only to this software file.  Patent licenses, if
+ *  any, provided herein do not apply to combinations of this program with
+ *  other software, or any other product whatsoever.
+ *
+ *  You should have received a copy of the GNU Lesser General Public
+ *  License along with this library; if not, write to the Free Software
+ *  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+ *
+ *  Contact information: MeVis Research GmbH, Universitaetsallee 29,
+ *  28359 Bremen, Germany or:
+ *
+ *  http://www.mevis.de
+ *
+ */
+
+//----------------------------------------------------------------------------------
+/*!
+// \file    CustomObjects.cpp
+// \author  Florian Link
+// \author  Last changed by $Author: florian $
+// \date    2007-4
+*/
+//----------------------------------------------------------------------------------
+
+#include "CustomObjects.h"
+
diff --git a/examples/PyCPPWrapperExample/CustomObjects.h b/examples/PyCPPWrapperExample/CustomObjects.h
@@ -0,0 +1,149 @@
+#ifndef _PYCUSTOMOBJECTS_H
+#define _PYCUSTOMOBJECTS_H
+
+/*
+ *
+ *  Copyright (C) 2006 MeVis Research GmbH All Rights Reserved.
+ *
+ *  This library is free software; you can redistribute it and/or
+ *  modify it under the terms of the GNU Lesser General Public
+ *  License as published by the Free Software Foundation; either
+ *  version 2.1 of the License, or (at your option) any later version.
+ *
+ *  This library is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+ *  Lesser General Public License for more details.
+ *
+ *  Further, this software is distributed without any warranty that it is
+ *  free of the rightful claim of any third person regarding infringement
+ *  or the like.  Any license provided herein, whether implied or
+ *  otherwise, applies only to this software file.  Patent licenses, if
+ *  any, provided herein do not apply to combinations of this program with
+ *  other software, or any other product whatsoever.
+ *
+ *  You should have received a copy of the GNU Lesser General Public
+ *  License along with this library; if not, write to the Free Software
+ *  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+ *
+ *  Contact information: MeVis Research GmbH, Universitaetsallee 29,
+ *  28359 Bremen, Germany or:
+ *
+ *  http://www.mevis.de
+ *
+ */
+
+//----------------------------------------------------------------------------------
+/*!
+// \file    CustomObjects.h
+// \author  Florian Link
+// \author  Last changed by $Author: florian $
+// \date    2007-4
+*/
+//----------------------------------------------------------------------------------
+
+#include "PythonQt.h"
+#include "PythonQtCppWrapperFactory.h"
+#include <QObject>
+
+
+// declare our own custom object
+class CustomObject {
+public:
+  CustomObject() {}
+  CustomObject(const QString& first, const QString& last) { _firstName = first; _lastName = last; }
+
+  QString _firstName;
+  QString _lastName;
+
+};
+
+
+// add a decorator that allows to access the CustomObject from PythonQt
+class CustomObjectWrapper : public QObject {
+
+  Q_OBJECT
+
+public slots:
+  // add a constructor
+  CustomObject* new_CustomObject(const QString& first, const QString& last) { return new CustomObject(first, last); }
+
+  // add a destructor
+  void delete_CustomObject(CustomObject* o) { delete o; }
+
+  // add access methods
+  QString firstName(CustomObject* o) { return o->_firstName; }
+
+  QString lastName(CustomObject* o) { return o->_lastName; }
+
+  void setFirstName(CustomObject* o, const QString& name) { o->_firstName = name; }
+
+  void setLastName(CustomObject* o, const QString& name) { o->_lastName = name; }
+
+};
+
+
+//------------------------------------------------------------------------------------------------
+// alternative: we create a wrapper factory, which creates a wrapper object for each CPP instance:
+//------------------------------------------------------------------------------------------------
+
+// declare our own custom object
+class CustomObject2 {
+public:
+  CustomObject2() {}
+  CustomObject2(const QString& first, const QString& last) { _firstName = first; _lastName = last; }
+
+  QString _firstName;
+  QString _lastName;
+
+};
+
+
+// add a decorator that allows to access the CustomObject from PythonQt
+class CustomObject2Wrapper : public QObject {
+
+  Q_OBJECT
+
+public:
+  CustomObject2Wrapper(CustomObject2* obj) { _ptr = obj; }
+
+public slots:
+  // add access methods
+  QString firstName() { return _ptr->_firstName; }
+
+  QString lastName() { return _ptr->_lastName; }
+
+  void setFirstName(const QString& name) { _ptr->_firstName = name; }
+
+  void setLastName(const QString& name) { _ptr->_lastName = name; }
+
+private:
+  CustomObject2* _ptr;
+};
+
+// additional constructor/destructor for CustomObject2 (optional)
+class CustomObject2Constructor : public QObject {
+
+  Q_OBJECT
+
+public slots:
+  // add a constructor
+  CustomObject2* new_CustomObject2(const QString& first, const QString& last) { return new CustomObject2(first, last); }
+
+  // add a destructor
+  void delete_CustomObject2(CustomObject2* o) { delete o; }
+};
+
+// a factory that can create wrappers for CustomObject2
+class CustomFactory : public PythonQtCppWrapperFactory
+{
+public:
+  virtual QObject* create(const QByteArray& name, void *ptr) {
+    if (name == "CustomObject2") {
+      return new CustomObject2Wrapper((CustomObject2*)ptr);
+    }
+    return NULL;
+  }
+};
+
+#endif
diff --git a/examples/PyCPPWrapperExample/PyCPPWrapperExample.bat b/examples/PyCPPWrapperExample/PyCPPWrapperExample.bat
@@ -0,0 +1,2 @@
+"%MEVIS_LIB%\make\win32\createDsp.bat" PyCPPWrapperExample
+
diff --git a/examples/PyCPPWrapperExample/PyCPPWrapperExample.pro b/examples/PyCPPWrapperExample/PyCPPWrapperExample.pro
@@ -0,0 +1,22 @@
+# --------- PyCPPWrapperExample profile -------------------
+# Last changed by $Author: florian $
+# $Id: PythonQt.pro 35381 2006-03-16 13:05:52Z florian $
+# $Source$
+# --------------------------------------------------
+
+TARGET   = PyCPPWrapperExample
+TEMPLATE = app
+
+DESTDIR           = ../../lib
+
+include ( ../../build/common.prf )  
+include ( ../../build/PythonQt.prf )  
+
+HEADERS += \
+  CustomObjects.h
+
+SOURCES += \
+  main.cpp \
+  CustomObjects.cpp
+
+RESOURCES += PyCPPWrapperExample.qrc
diff --git a/examples/PyCPPWrapperExample/PyCPPWrapperExample.qrc b/examples/PyCPPWrapperExample/PyCPPWrapperExample.qrc
@@ -0,0 +1,5 @@
+ <!DOCTYPE RCC><RCC version="1.0">
+ <qresource>
+     <file>example.py</file>
+ </qresource>
+ </RCC>
diff --git a/examples/PyCPPWrapperExample/example.py b/examples/PyCPPWrapperExample/example.py
@@ -0,0 +1,38 @@
+from PythonQt import *
+
+print "alternative 1 : CustomObject wrapped by decorators"
+
+# create a new object
+custom = CustomObject("John","Doe")
+
+# print the object (to see how it is wrapped)
+print custom
+
+# print the methods available
+print dir(custom)
+
+# set a name
+custom.setFirstName("Mike")
+custom.setLastName("Michels")
+
+# get the name
+print custom.firstName() + " " + custom.lastName();
+
+print
+print "alternative 2 : CustomObject2 wrapped by factory"
+
+# create a new object
+custom2 = CustomObject2("John","Doe")
+
+# print the object (to see how it is wrapped)
+print custom2
+
+# print the methods available
+print dir(custom2)
+
+# set a name
+custom2.setFirstName("Mike")
+custom2.setLastName("Michels")
+
+# get the name
+print custom2.firstName() + " " + custom2.lastName();
diff --git a/examples/PyCPPWrapperExample/main.cpp b/examples/PyCPPWrapperExample/main.cpp
@@ -0,0 +1,86 @@
+/*
+ *
+ *  Copyright (C) 2006 MeVis Research GmbH All Rights Reserved.
+ *
+ *  This library is free software; you can redistribute it and/or
+ *  modify it under the terms of the GNU Lesser General Public
+ *  License as published by the Free Software Foundation; either
+ *  version 2.1 of the License, or (at your option) any later version.
+ *
+ *  This library is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+ *  Lesser General Public License for more details.
+ *
+ *  Further, this software is distributed without any warranty that it is
+ *  free of the rightful claim of any third person regarding infringement
+ *  or the like.  Any license provided herein, whether implied or
+ *  otherwise, applies only to this software file.  Patent licenses, if
+ *  any, provided herein do not apply to combinations of this program with
+ *  other software, or any other product whatsoever.
+ *
+ *  You should have received a copy of the GNU Lesser General Public
+ *  License along with this library; if not, write to the Free Software
+ *  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+ *
+ *  Contact information: MeVis Research GmbH, Universitaetsallee 29,
+ *  28359 Bremen, Germany or:
+ *
+ *  http://www.mevis.de
+ *
+ */
+
+//----------------------------------------------------------------------------------
+/*!
+// \file    PyGuiExample.cpp
+// \author  Florian Link
+// \author  Last changed by $Author: florian $
+// \date    2007-04
+*/
+//----------------------------------------------------------------------------------
+
+#include "PythonQt.h"
+#include "gui/PythonQtScriptingConsole.h"
+#include "CustomObjects.h"
+
+#include <QApplication>
+
+int main( int argc, char **argv )
+{
+  QApplication qapp(argc, argv);
+
+  PythonQt::init(PythonQt::IgnoreSiteModule | PythonQt::RedirectStdOut);
+
+  PythonQtObjectPtr  mainContext = PythonQt::self()->getMainModule();
+  PythonQtScriptingConsole console(NULL, mainContext);
+
+  // -----------------------------------------------------------------
+  // Alternative 1: make CustomObject known and use decorators for wrapping:
+  // -----------------------------------------------------------------
+
+  // register the new object as a known classname
+  PythonQt::self()->registerCPPClassNames(QStringList() << "CustomObject");
+  // add a decorator which can access CustomObject instances
+  PythonQt::self()->addDecorators(new CustomObjectWrapper());
+
+  // -----------------------------------------------------------------
+  // Alternative 2: make CustomObject2 known and use a wrapper factory for wrapping:
+  // -----------------------------------------------------------------
+
+  // add a factory that can handle pointers to CustomObject2
+  PythonQt::self()->addWrapperFactory(new CustomFactory());
+
+  // the following is optional and only needed if you want a constructor:
+  // register the new object as a known classname
+  PythonQt::self()->registerCPPClassNames(QStringList() << "CustomObject2");
+  // add a constructor for CustomObject2
+  PythonQt::self()->addClassDecorators(new CustomObject2Constructor());
+
+  mainContext.evalFile(":example.py");
+
+  console.appendCommandPrompt();
+  console.show();
+
+  return qapp.exec();
+}
+