go-qml · jackman0 · May 1, 2014 · May 2, 2014 · Aug 13, 2014 · Aug 13, 2014
diff --git a/LICENSE b/LICENSE
@@ -0,0 +1,185 @@
+This software is licensed under the LGPLv3, included below.
+
+As a special exception to the GNU Lesser General Public License version 3
+("LGPL3"), the copyright holders of this Library give you permission to
+convey to a third party a Combined Work that links statically or dynamically
+to this Library without providing any Minimal Corresponding Source or
+Minimal Application Code as set out in 4d or providing the installation
+information set out in section 4e, provided that you comply with the other
+provisions of LGPL3 and provided that you meet, for the Application the
+terms and conditions of the license(s) which apply to the Application.
+
+Except as stated in this special exception, the provisions of LGPL3 will
+continue to comply in full to this Library. If you modify this Library, you
+may apply this exception to your version of this Library, but you are not
+obliged to do so. If you do not wish to do so, delete this exception
+statement from your version. This exception does not (and cannot) modify any
+license terms which apply to the Application, with which you must still
+comply.
+
+
+                   GNU LESSER GENERAL PUBLIC LICENSE
+                       Version 3, 29 June 2007
+
+ Copyright (C) 2007 Free Software Foundation, Inc. <http://fsf.org/>
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+
+  This version of the GNU Lesser General Public License incorporates
+the terms and conditions of version 3 of the GNU General Public
+License, supplemented by the additional permissions listed below.
+
+  0. Additional Definitions.
+
+  As used herein, "this License" refers to version 3 of the GNU Lesser
+General Public License, and the "GNU GPL" refers to version 3 of the GNU
+General Public License.
+
+  "The Library" refers to a covered work governed by this License,
+other than an Application or a Combined Work as defined below.
+
+  An "Application" is any work that makes use of an interface provided
+by the Library, but which is not otherwise based on the Library.
+Defining a subclass of a class defined by the Library is deemed a mode
+of using an interface provided by the Library.
+
+  A "Combined Work" is a work produced by combining or linking an
+Application with the Library.  The particular version of the Library
+with which the Combined Work was made is also called the "Linked
+Version".
+
+  The "Minimal Corresponding Source" for a Combined Work means the
+Corresponding Source for the Combined Work, excluding any source code
+for portions of the Combined Work that, considered in isolation, are
+based on the Application, and not on the Linked Version.
+
+  The "Corresponding Application Code" for a Combined Work means the
+object code and/or source code for the Application, including any data
+and utility programs needed for reproducing the Combined Work from the
+Application, but excluding the System Libraries of the Combined Work.
+
+  1. Exception to Section 3 of the GNU GPL.
+
+  You may convey a covered work under sections 3 and 4 of this License
+without being bound by section 3 of the GNU GPL.
+
+  2. Conveying Modified Versions.
+
+  If you modify a copy of the Library, and, in your modifications, a
+facility refers to a function or data to be supplied by an Application
+that uses the facility (other than as an argument passed when the
+facility is invoked), then you may convey a copy of the modified
+version:
+
+   a) under this License, provided that you make a good faith effort to
+   ensure that, in the event an Application does not supply the
+   function or data, the facility still operates, and performs
+   whatever part of its purpose remains meaningful, or
+
+   b) under the GNU GPL, with none of the additional permissions of
+   this License applicable to that copy.
+
+  3. Object Code Incorporating Material from Library Header Files.
+
+  The object code form of an Application may incorporate material from
+a header file that is part of the Library.  You may convey such object
+code under terms of your choice, provided that, if the incorporated
+material is not limited to numerical parameters, data structure
+layouts and accessors, or small macros, inline functions and templates
+(ten or fewer lines in length), you do both of the following:
+
+   a) Give prominent notice with each copy of the object code that the
+   Library is used in it and that the Library and its use are
+   covered by this License.
+
+   b) Accompany the object code with a copy of the GNU GPL and this license
+   document.
+
+  4. Combined Works.
+
+  You may convey a Combined Work under terms of your choice that,
+taken together, effectively do not restrict modification of the
+portions of the Library contained in the Combined Work and reverse
+engineering for debugging such modifications, if you also do each of
+the following:
+
+   a) Give prominent notice with each copy of the Combined Work that
+   the Library is used in it and that the Library and its use are
+   covered by this License.
+
+   b) Accompany the Combined Work with a copy of the GNU GPL and this license
+   document.
+
+   c) For a Combined Work that displays copyright notices during
+   execution, include the copyright notice for the Library among
+   these notices, as well as a reference directing the user to the
+   copies of the GNU GPL and this license document.
+
+   d) Do one of the following:
+
+       0) Convey the Minimal Corresponding Source under the terms of this
+       License, and the Corresponding Application Code in a form
+       suitable for, and under terms that permit, the user to
+       recombine or relink the Application with a modified version of
+       the Linked Version to produce a modified Combined Work, in the
+       manner specified by section 6 of the GNU GPL for conveying
+       Corresponding Source.
+
+       1) Use a suitable shared library mechanism for linking with the
+       Library.  A suitable mechanism is one that (a) uses at run time
+       a copy of the Library already present on the user's computer
+       system, and (b) will operate properly with a modified version
+       of the Library that is interface-compatible with the Linked
+       Version.
+
+   e) Provide Installation Information, but only if you would otherwise
+   be required to provide such information under section 6 of the
+   GNU GPL, and only to the extent that such information is
+   necessary to install and execute a modified version of the
+   Combined Work produced by recombining or relinking the
+   Application with a modified version of the Linked Version. (If
+   you use option 4d0, the Installation Information must accompany
+   the Minimal Corresponding Source and Corresponding Application
+   Code. If you use option 4d1, you must provide the Installation
+   Information in the manner specified by section 6 of the GNU GPL
+   for conveying Corresponding Source.)
+
+  5. Combined Libraries.
+
+  You may place library facilities that are a work based on the
+Library side by side in a single library together with other library
+facilities that are not Applications and are not covered by this
+License, and convey such a combined library under terms of your
+choice, if you do both of the following:
+
+   a) Accompany the combined library with a copy of the same work based
+   on the Library, uncombined with any other library facilities,
+   conveyed under the terms of this License.
+
+   b) Give prominent notice with the combined library that part of it
+   is a work based on the Library, and explaining where to find the
+   accompanying uncombined form of the same work.
+
+  6. Revised Versions of the GNU Lesser General Public License.
+
+  The Free Software Foundation may publish revised and/or new versions
+of the GNU Lesser General Public License from time to time. Such new
+versions will be similar in spirit to the present version, but may
+differ in detail to address new problems or concerns.
+
+  Each version is given a distinguishing version number. If the
+Library as you received it specifies that a certain numbered version
+of the GNU Lesser General Public License "or any later version"
+applies to it, you have the option of following the terms and
+conditions either of that published version or of any later version
+published by the Free Software Foundation. If the Library as you
+received it does not specify a version number of the GNU Lesser
+General Public License, you may choose any version of the GNU Lesser
+General Public License ever published by the Free Software Foundation.
+
+  If the Library as you received it specifies that a proxy can decide
+whether future versions of the GNU Lesser General Public License shall
+apply, that proxy's public statement of acceptance of any version is
+permanent authorization for you to choose that version for the
+Library.
diff --git a/README.md b/README.md
@@ -0,0 +1,164 @@
+# QML support for the Go language
+
+## amlwwalker/qml
+
+* I have made the `go1.6-port` branch the master branch here as it seems more relevant in this day and age...
+* It is not my work, but I have been using it for a while so please shout if I can help!
+
+
+
+Original Documentation
+-------------
+
+The introductory documentation as well as the detailed API documentation is
+available at [gopkg.in/qml.v1](http://godoc.org/gopkg.in/qml.v1).
+
+
+Blog posts
+----------
+
+Some relevant blog posts:
+
+  * [Announcing qml v1 for Go](http://blog.labix.org/2014/08/13/announcing-qml-v1-for-go)
+  * [Packing resources into Go qml binaries](http://blog.labix.org/2014/09/26/packing-resources-into-go-qml-binaries)
+  * [Go qml contest results](http://blog.labix.org/2014/04/25/qml-contest-results)
+  * [Arbitrary Qt extensions with Go qml](http://blog.labix.org/2014/03/21/arbitrary-qt-extensions-with-go-qml)
+  * [The new Go qml OpenGL API](http://blog.labix.org/2014/08/29/the-new-go-qml-opengl-api)
+  * [QML components with Go and OpenGL](http://blog.labix.org/2013/12/23/qml-components-with-go-and-opengl)
+
+
+Videos
+------
+
+These introductory videos demonstrate the use of Go QML:
+
+  * [Initial demo and overview](http://youtu.be/FVQlMrPa7lI)
+  * [Initial demo running on an Ubuntu Touch phone](http://youtu.be/HB-3o8Cysec)
+  * [Spinning Gopher with Go + QML + OpenGL](http://youtu.be/qkH7_dtOyPk)
+  * [SameGame QML tutorial in Go](http://youtu.be/z8noX48hiMI)
+
+
+Community
+---------
+
+Please join the [mailing list](https://groups.google.com/forum/#!forum/go-qml) for
+following relevant development news and discussing project details.
+
+
+Installation
+------------
+
+To try the alpha release you'll need:
+
+  * Go >= 1.2, for the C++ support of _go build_
+  * Qt 5.0.X or 5.1.X with the development files
+  * The Qt headers qmetaobject_p.h and qmetaobjectbuilder_p.h, for the dynamic meta object support
+
+See below for more details about getting these requirements installed in different environments and operating systems.
+
+After the requirements are satisfied, _go get_ should work as usual:
+
+    go get gopkg.in/qml.v1
+
+
+Requirements on Ubuntu
+----------------------
+
+If you are using Ubuntu, the [Ubuntu SDK](http://developer.ubuntu.com/get-started/) will take care of the Qt dependencies:
+
+    $ sudo add-apt-repository ppa:ubuntu-sdk-team/ppa
+    $ sudo apt-get update
+    $ sudo apt-get install qtdeclarative5-dev qtbase5-private-dev qtdeclarative5-private-dev libqt5opengl5-dev qtdeclarative5-qtquick2-plugin
+
+and Go >= 1.2 may be installed using [godeb](http://blog.labix.org/2013/06/15/in-flight-deb-packages-of-go):
+
+    $ # Pick the right one for your system: 386 or amd64
+    $ ARCH=amd64
+    $ wget -q https://godeb.s3.amazonaws.com/godeb-$ARCH.tar.gz
+    $ tar xzvf godeb-$ARCH.tar.gz
+    godeb
+    $ sudo mv godeb /usr/local/bin
+    $ godeb install
+    $ go get gopkg.in/qml.v1
+
+
+Requirements on Ubuntu Touch
+----------------------------
+
+After following the [installation instructions](https://wiki.ubuntu.com/Touch/Install) for Ubuntu Touch,
+run the following commands to get a working build environment inside the device:
+
+    $ adb shell
+    # cd /tmp
+    # wget https://github.com/go-qml/qml/raw/v1/cmd/ubuntu-touch/setup.sh
+    # /bin/bash setup.sh
+    # su - phablet
+    $
+
+At the end of setup.sh, the phablet user will have GOPATH=$HOME in the environment,
+the qml package will be built, and the particle example will be built and run. For
+stopping it from the command line, run as the phablet user:
+
+    $ ubuntu-app-stop gopkg.in.qml.particle-example
+
+for running it again:
+
+    $ ubuntu-app-launch gopkg.in.qml.particle-example
+
+These commands depend on the following file, installed by setup.sh:
+
+    ~/.local/share/applications/gopkg.in.qml.particle-example.desktop
+
+
+Requirements on Mac OS X
+------------------------
+
+On Mac OS X you'll need QT5. It's easiest to install with Homebrew, a
+third-party package management system for OS X.
+
+Installation instructions for Homebrew are here:
+
+    http://brew.sh/
+
+Then, install the qt5 and pkg-config packages:
+
+    $ brew install qt5 pkg-config
+
+Then, force brew to "link" qt5 (this makes it available under /usr/local):
+
+    $ brew link --force qt5
+
+And finally, fetch and install go-qml:
+
+    $ go get gopkg.in/qml.v1
+
+
+Requirements on Windows
+-----------------------
+
+On Windows you'll need the following:
+
+  * [MinGW gcc](http://sourceforge.net/projects/mingw/files/latest/download) 4.8.1 (install mingw-get and install the gcc from within the setup GUI)
+  * [Qt 5.1.1](http://download.qt-project.org/official_releases/qt/5.1/5.1.1/qt-windows-opensource-5.1.1-mingw48_opengl-x86-offline.exe) for MinGW 4.8
+  * [Go >= 1.2](http://golang.org/doc/install)
+
+Then, assuming Qt was installed under `C:\Qt5.1.1\`, set up the following environment variables in the respective configuration:
+
+    CPATH += C:\Qt5.1.1\5.1.1\mingw48_32\include
+    LIBRARY_PATH += C:\Qt5.1.1\5.1.1\mingw48_32\lib
+    PATH += C:\Qt5.1.1\5.1.1\mingw48_32\bin
+
+After reopening the shell for the environment changes to take effect, this should work:
+
+    go get gopkg.in/qml.v1
+
+
+Requirements everywhere else
+----------------------------
+
+If your operating system does not offer these dependencies readily,
+you may still have success installing [Go >= 1.2](http://golang.org/doc/install)
+and [Qt 5.0.2](http://download.qt-project.org/archive/qt/5.0/5.0.2/)
+directly from the upstreams.  Note that you'll likely have to adapt
+environment variables to reflect the custom installation path for
+these libraries. See the instructions above for examples.
diff --git a/all.cpp b/all.cpp
@@ -0,0 +1,12 @@
+
+#include "cpp/capi.cpp"
+#include "cpp/govalue.cpp"
+#include "cpp/govaluetype.cpp"
+#include "cpp/idletimer.cpp"
+#include "cpp/connector.cpp"
+
+#include "cpp/moc_all.cpp"
+
+#ifdef _WIN32
+#include "cpp/mmemwin.cpp"
+#endif