Getting Started With Lighthouse

the information presented here is obsoleted according to http://labs.qt.nokia.com/2011/05/31/lighthouse-has-grown-up-now/

[toc align_right="yes" depth="3"]

Getting started with Lighthouse

Prerequisites

You need a Unix-like system, a reasonably modern C++ compiler, and an up-to-date version of git (1.6 or newer recommended).
(If you do not have git, there is a way to download tarballs from qt.gitorious.org, but I'm not going to show you how: You really want to use git, especially if you are ever going to update to newer versions.)

Clone the Lighthouse repository

First choose some convenient place to put the code. For the purpose of this document I will use <code&gt;_{/dev/&lt;/code&gt;.}

<br /> mkdir -p</sub>/dev<br /> cd <sub>/dev<br />

Now clone the Lighthouse repository into <code&gt;/dev/lighthouse&lt;/code&gt;:

<br /> git clone git://gitorious.org/+qt-developers/qt/lighthouse.git<br />

Configure and build

We will use shadow builds for this. Shadow building means building outside the source directory tree. It is of course possible to build Lighthouse inside the source tree, but use shadow builds anyway. You will thank me later: With shadow builds you can have several different build configurations side by side.

The only limitation is that the shadow build directory has to be outside the source tree; otherwise Qt's build system will be fatally confused. Apart from that you could put the build directory anywhere, but here I'll put it next to the source directory.

Create a build directory, and <code&gt;cd&lt;/code&gt; into it.

<br /> cd ~/dev<br /> mkdir build-lighthouse<br /> cd build-lighthouse<br />

Running the configure script from inside the build directory sets up the shadow build:

<br /> ../qt-lighthouse/configure -qpa -developer-build<br />

(The <code&gt;-embedded-lite&lt;/code&gt; option is what makes this a Lighthouse build instead of making just another Qt/X11 binary; <code&gt;-developer-build&lt;/code&gt; makes a library that does not need to be installed somewhere else, as well as setting some other developer-friendly options.)

Now compile Lighthouse. To save time, we'll just compile <code&gt;src&lt;/code&gt;, and skip the tools and examples for now:

<br /> make -C src<br />

Run some examples

We didn't compile any examples in the previous step, so we have to compile them as we need them. We'll choose the industrial standard example for Qt testing:

<br /> cd examples/widgets/wiggly/<br /> make<br />

If we don't specify a backend, Lighthouse will just complain at us, so we use the <code&gt;-platform&lt;/code&gt; command line argument, and choose minimal.

<br /> ./wiggly <s>platform minimal<br />

Note: you have to press Ctrl-C to stop the program, otherwise your file system will fill up with images.
Now you can use your favorite image viewer to look at the images (<code&gt;outputxxxx.png&lt;/code&gt;). You probably want to clean up afterwards:

<br /> rm output*.png<br />

If you are running an X11 server, and have the necessary header files installed, you can also try out the <code&gt;testlite&lt;/code&gt; backend. It's not compiled by default, so you'll have to do that first:

<br /> cd ../../../src/plugins/platforms/testlite/<br /> make<br />

Go back to the example,

<br /> cd</s><br />

and run it with the new backend:

<br />./wiggly -platform testlite<br />

Now you can start on the advanced stuff

See Writing_Your_Own_Lighthouse_Backend for how to port Lighthouse to other systems.