[PATCH 1/2] Add separate page with Qt 5 instructions for Wayland

Fri Jan 27 14:28:31 PST 2012

On Fri, Jan 27, 2012 at 5:03 PM, Tiago Vignatti
<vignatti at freedesktop.org> wrote:
> From: Tiago Vignatti <tiago.vignatti at intel.com>

Thanks, this and 2/2 pushed.

Kristian

> Signed-off-by: Tiago Vignatti <tiago.vignatti at intel.com>
> ---
>  qt5.html      |  134 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++
>  toolkits.html |   61 +-------------------------
>  2 files changed, 136 insertions(+), 59 deletions(-)
>  create mode 100644 qt5.html
>
> diff --git a/qt5.html b/qt5.html
> new file mode 100644
> index 0000000..dbd3eef
> --- /dev/null
> +++ b/qt5.html
> @@ -0,0 +1,134 @@
> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
> +<html>
> +
> +<head>
> +<meta http-equiv="Content-Type" content="text/html;charset=utf-8">
> +<link href="wayland.css" rel="stylesheet" type="text/css">
> +<script type="text/javascript" src="generated-toc.js"></script>
> +<title>Qt 5 on Wayland</title>
> +</head>
> +
> +<body>
> +<h1><a href="/"><img src="wayland.png" alt="Wayland logo"></a></h1>
> +<h1>Qt 5 on Wayland</h1>
> +<p>Wayland support in the Qt 5 toolkit is happening in the Lighthouse
> +<a href="https://qt.gitorious.org/qt/qtwayland">wayland plugin</a>.
> +
> +<div id="generated-toc" class="generate_from_h2"></div>
> +
> +<h2>Getting the source and compiling</h2>
> +To try it
> +out, first clone the qtbase:</p>
> +
> +<pre>
> +$ mkdir qt; cd qt
> +$ git clone git://gitorious.org/qt/qtbase.git
> +</pre>
> +
> +you might want to set some env variables for compilation as well:
> +
> +<pre>
> +$ export QTVER=qt5
> +$ export QTDIR=/opt/qt/$QTVER
> +$ export PATH=$QTDIR/bin/:$PATH
> +$ export LD_LIBRARY_PATH=$QTDIR/lib/:$LD_LIBRARY_PATH
> +$ export PKG_CONFIG_PATH=$QTDIR/lib/pkgconfig/:$PKG_CONFIG_PATH
> +$ export QT_PLUGIN_PATH=$QTDIR/lib/plugins/
> +</pre>
> +<pre>$ ./configure -confirm-license -opensource -no-multimedia -no-webkit
> +-no-phonon -no-v8 -debug -qpa -xcb -wayland -egl -opengl es2 -nomake examples
> +-prefix ${QTDIR}
> +$ make
> +$ sudo make install
> +</pre>
> +
> +at this point you got all needed Qt libraries, and needed tools to compile
> +qtwayland platform:
> +
> +<pre>
> +$ cd ../
> +$ git clone git://gitorious.org/qt/qtwayland.git
> +$ cd qtwayland/
> +$ qmake
> +$ make
> +$ make && make install
> +</pre>
> +
> +<h2>Trying it out</h2>
> +first, don't forget to set the XDG directory and re-run .bashrc:
> +
> +<pre>
> +$ export XDG_RUNTIME_DIR=$HOME/.xdg
> +$ mkdir $HOME/.xdg
> +</pre>
> +
> +<p>
> +you can jump back and forth between Wayland and X ("-platform xcb") to compare the look and feel
> +of the application under Wayland and X:</p>
> +
> +<pre>
> +$ cd ../qtbase/examples/opengl/hellowindow
> +$ qmake
> +$ make
> +$ wayland-compositor &
> +$ ./hellowindow -platform wayland
> +</pre>
> +
> +<h2>Porting your Qt application</h2>
> +
> +<p>
> +Qt 5 is structured with the Lighthouse (or Qt Platform) Abstraction, which is
> +the windowing system and device agnostic architecture. That means Qt can load
> +in run-time different backend plugins for different window systems as desired.
> +For instance, an application developed on Qt could be run using "-platform
> +xcb" and "-platform wayland" for XCB or Wayland respectively (or set
> +the <code>QT_QPA_PLATFORM</code>) and should have a
> +similar behavior on both systems, without the need to recompile.
> +</p>
> +
> +<p>
> +Qt abstraction exposes to applications developers two native resources of
> +Wayland: <code>wl_display</code> and <code>wl_surface</code>. With those types, one could access
> +Wayland internals to deal with special cases through the interface:
> +</p>
> +<pre>
> +    void *QPlatformNativeInterface::nativeResourceForWindow(const QByteArray &resource, QWindow *window)
> +</pre>
> +<p>
> +Getting the display global handler is quite straightforward, as shown in the
> +following example:
> +</p>
> +
> +<pre>
> +    QPlatformNativeInterface *native =
> +        QGuiApplication::platformNativeInterface();
> +    struct wl_display *wl_dpy = (struct wl_display *)
> +        native->nativeResourceForWindow("display", NULL);
> +</pre>
> +<p>
> +and for <code>wl_surface</code>:
> +</p>
> +
> +<pre>
> +    QPlatformNativeInterface *native =
> +        QGuiApplication::platformNativeInterface();
> +    struct wl_surface *surface = static_cast<struct wl_surface *>(
> +        native->nativeResourceForWindow("surface", this->windowHandle()));
> +</pre>
> +
> +
> +<h2>Known issues</h2>
> +<ul>
> +  <li>
> +Applications have to implement their own way of decorating windows.
> +Therefore, some Qt functions like setWindowTitle(), raise() or lower(),
> +holding window properties will have different effect on Wayland compositors.
> +  </li>
> +</ul>
> +
> +<h2>Getting help and reporting issues</h2>
> +
> +<p>Try the #qt-labs IRC channel on freenode.net
> +
> +</body>
> +</html>
> diff --git a/toolkits.html b/toolkits.html
> index 4f59edc..05e0319 100644
> --- a/toolkits.html
> +++ b/toolkits.html
> @@ -22,65 +22,8 @@ to set <code>EGL_PLATFORM=wayland</code>.</p>
>
>  <h2>Qt 5</h2>
>
> -<p>Wayland support in the Qt 5 toolkit is happening in the Lighthouse
> -<a href="https://qt.gitorious.org/qt/qtwayland">wayland plugin</a>. To try it out, first clone the qtbase:</p>
> -
> -<pre>
> -$ mkdir qt; cd qt
> -$ git clone git://gitorious.org/qt/qtbase.git
> -</pre>
> -
> -you might want to set some env variables for compilation as well:
> -
> -<pre>
> -$ export QTVER=qt5
> -$ export QTDIR=/opt/qt/$QTVER
> -$ export PATH=$QTDIR/bin/:$PATH
> -$ export LD_LIBRARY_PATH=$QTDIR/lib/:$LD_LIBRARY_PATH
> -$ export PKG_CONFIG_PATH=$QTDIR/lib/pkgconfig/:$PKG_CONFIG_PATH
> -$ export QT_PLUGIN_PATH=$QTDIR/lib/plugins/
> -</pre>
> -
> -<pre>$ ./configure -confirm-license -opensource -no-multimedia -no-webkit -no-phonon -no-v8 -debug -qpa -xcb -wayland -egl -opengl es2 -nomake examples -prefix ${QTDIR}
> -$ make
> -$ sudo make install
> -</pre>
> -
> -at this point you got all needed Qt libraries, and needed tools to compile
> -qtwayland platform:
> -
> -<pre>
> -$ cd ../
> -$ git clone git://gitorious.org/qt/qtwayland.git
> -$ cd qtwayland/
> -$ qmake
> -$ make
> -$ make && make install
> -</pre>
> -
> -don't forget to set the XDG directory and re-run .bashrc:
> -
> -<pre>
> -$ export XDG_RUNTIME_DIR=$HOME/.xdg
> -$ mkdir $HOME/.xdg
> -</pre>
> -
> -<p>when you run a Lighthouse application you either have to
> -pass <code>-platform wayland</code> or set
> -the <code>QT_QPA_PLATFORM</code> environment variable
> -to <code>wayland</code>.  Lighthouse supports a number of other
> -window systems.  There's an XCB backend, and by
> -passing <code>-platform xcb</code> you can jump back and forth between
> -Wayland and X to compare the look and feel of the application under
> -Wayland and X:</p>
> -
> -<pre>
> -$ cd ../qtbase/examples/opengl/hellowindow
> -$ qmake
> -$ make
> -$ wayland-compositor &
> -$ ./hellowindow -platform wayland
> -</pre>
> +<p>Wayland support in the Qt 5 toolkit is happening in the Lighthouse wayland
> +plugin. To try it out check <a href="qt5.html">QT 5 Wayland instructions</a>.</p>
>
>  <h2>GTK+</h2>
>
> --
> 1.7.5.4
>
> _______________________________________________
> wayland-devel mailing list
> wayland-devel at lists.freedesktop.org
> http://lists.freedesktop.org/mailman/listinfo/wayland-devel