<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en_US" lang="en_US">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<!-- emb-running.qdoc -->
<title>Qt 4.8: Running Qt for Embedded Linux Applications</title>
<link rel="stylesheet" type="text/css" href="style/style.css" />
<script src="scripts/jquery.js" type="text/javascript"></script>
<script src="scripts/functions.js" type="text/javascript"></script>
<link rel="stylesheet" type="text/css" href="style/superfish.css" />
<link rel="stylesheet" type="text/css" href="style/narrow.css" />
<!--[if IE]>
<meta name="MSSmartTagsPreventParsing" content="true">
<meta http-equiv="imagetoolbar" content="no">
<![endif]-->
<!--[if lt IE 7]>
<link rel="stylesheet" type="text/css" href="style/style_ie6.css">
<![endif]-->
<!--[if IE 7]>
<link rel="stylesheet" type="text/css" href="style/style_ie7.css">
<![endif]-->
<!--[if IE 8]>
<link rel="stylesheet" type="text/css" href="style/style_ie8.css">
<![endif]-->
<script src="scripts/superfish.js" type="text/javascript"></script>
<script src="scripts/narrow.js" type="text/javascript"></script>
</head>
<body class="" onload="CheckEmptyAndLoadList();">
<div class="header" id="qtdocheader">
<div class="content">
<div id="nav-logo">
<a href="index.html">Home</a></div>
<a href="index.html" class="qtref"><span>Qt Reference Documentation</span></a>
<div id="narrowsearch"></div>
<div id="nav-topright">
<ul>
<li class="nav-topright-home"><a href="http://qt.digia.com/">Qt HOME</a></li>
<li class="nav-topright-dev"><a href="http://qt-project.org/">DEV</a></li>
<li class="nav-topright-doc nav-topright-doc-active"><a href="http://qt-project.org/doc/">
DOC</a></li>
<li class="nav-topright-blog"><a href="http://blog.qt.digia.com/">BLOG</a></li>
</ul>
</div>
<div id="shortCut">
<ul>
<li class="shortCut-topleft-inactive"><span><a href="index.html">Qt 4.8</a></span></li>
<li class="shortCut-topleft-active"><a href="http://qt-project.org/doc/">ALL VERSIONS </a></li>
</ul>
</div>
<ul class="sf-menu" id="narrowmenu">
<li><a href="#">API Lookup</a>
<ul>
<li><a href="classes.html">Class index</a></li>
<li><a href="functions.html">Function index</a></li>
<li><a href="modules.html">Modules</a></li>
<li><a href="namespaces.html">Namespaces</a></li>
<li><a href="qtglobal.html">Global Declarations</a></li>
<li><a href="qdeclarativeelements.html">QML elements</a></li>
</ul>
</li>
<li><a href="#">Qt Topics</a>
<ul>
<li><a href="qt-basic-concepts.html">Programming with Qt</a></li>
<li><a href="qtquick.html">Device UIs & Qt Quick</a></li>
<li><a href="qt-gui-concepts.html">UI Design with Qt</a></li>
<li><a href="supported-platforms.html">Supported Platforms</a></li>
<li><a href="technology-apis.html">Qt and Key Technologies</a></li>
<li><a href="best-practices.html">How-To's and Best Practices</a></li>
</ul>
</li>
<li><a href="#">Examples</a>
<ul>
<li><a href="all-examples.html">Examples</a></li>
<li><a href="tutorials.html">Tutorials</a></li>
<li><a href="demos.html">Demos</a></li>
<li><a href="qdeclarativeexamples.html">QML Examples</a></li>
</ul>
</li>
</ul>
</div>
</div>
<div class="wrapper">
<div class="hd">
<span></span>
</div>
<div class="bd group">
<div class="sidebar">
<div class="searchlabel">
Search index:</div>
<div class="search" id="sidebarsearch">
<form id="qtdocsearch" action="" onsubmit="return false;">
<fieldset>
<input type="text" name="searchstring" id="pageType" value="" />
<div id="resultdialog">
<a href="#" id="resultclose">Close</a>
<p id="resultlinks" class="all"><a href="#" id="showallresults">All</a> | <a href="#" id="showapiresults">API</a> | <a href="#" id="showarticleresults">Articles</a> | <a href="#" id="showexampleresults">Examples</a></p>
<p id="searchcount" class="all"><span id="resultcount"></span><span id="apicount"></span><span id="articlecount"></span><span id="examplecount"></span> results:</p>
<ul id="resultlist" class="all">
</ul>
</div>
</fieldset>
</form>
</div>
<div class="box first bottombar" id="lookup">
<h2 title="API Lookup"><span></span>
API Lookup</h2>
<div id="list001" class="list">
<ul id="ul001" >
<li class="defaultLink"><a href="classes.html">Class index</a></li>
<li class="defaultLink"><a href="functions.html">Function index</a></li>
<li class="defaultLink"><a href="modules.html">Modules</a></li>
<li class="defaultLink"><a href="namespaces.html">Namespaces</a></li>
<li class="defaultLink"><a href="qtglobal.html">Global Declarations</a></li>
<li class="defaultLink"><a href="qdeclarativeelements.html">QML elements</a></li>
</ul>
</div>
</div>
<div class="box bottombar" id="topics">
<h2 title="Qt Topics"><span></span>
Qt Topics</h2>
<div id="list002" class="list">
<ul id="ul002" >
<li class="defaultLink"><a href="qt-basic-concepts.html">Programming with Qt</a></li>
<li class="defaultLink"><a href="qtquick.html">Device UIs & Qt Quick</a></li>
<li class="defaultLink"><a href="qt-gui-concepts.html">UI Design with Qt</a></li>
<li class="defaultLink"><a href="supported-platforms.html">Supported Platforms</a></li>
<li class="defaultLink"><a href="technology-apis.html">Qt and Key Technologies</a></li>
<li class="defaultLink"><a href="best-practices.html">How-To's and Best Practices</a></li>
</ul>
</div>
</div>
<div class="box" id="examples">
<h2 title="Examples"><span></span>
Examples</h2>
<div id="list003" class="list">
<ul id="ul003">
<li class="defaultLink"><a href="all-examples.html">Examples</a></li>
<li class="defaultLink"><a href="tutorials.html">Tutorials</a></li>
<li class="defaultLink"><a href="demos.html">Demos</a></li>
<li class="defaultLink"><a href="qdeclarativeexamples.html">QML Examples</a></li>
</ul>
</div>
</div>
</div>
<div class="wrap">
<div class="toolbar">
<div class="breadcrumb toolblock">
<ul>
<li class="first"><a href="index.html">Home</a></li>
<!-- Breadcrumbs go here -->
<li>Running Qt for Embedded Linux Applications</li>
</ul>
</div>
<div class="toolbuttons toolblock">
<ul>
<li id="smallA" class="t_button">A</li>
<li id="medA" class="t_button active">A</li>
<li id="bigA" class="t_button">A</li>
<li id="print" class="t_button"><a href="javascript:this.print();">
<span>Print</span></a></li>
</ul>
</div>
</div>
<div class="content mainContent">
<div class="toc">
<h3><a name="toc">Contents</a></h3>
<ul>
<li class="level1"><a href="#using-a-single-display">Using a Single Display</a></li>
<li class="level1"><a href="#using-multiple-displays">Using Multiple Displays</a></li>
<li class="level1"><a href="#command-line-options">Command Line Options</a></li>
</ul>
</div>
<h1 class="title">Running Qt for Embedded Linux Applications</h1>
<span class="subtitle"></span>
<!-- $$$qt-embedded-running.html-description -->
<div class="descr"> <a name="details"></a>
<p>A <a href="qt-embedded-linux.html">Qt for Embedded Linux</a> application requires a server application to be running, or to be the server application itself. Any <a href="qt-embedded-linux.html">Qt for Embedded Linux</a> application can be the server application by constructing the <a href="qapplication.html">QApplication</a> object with the <a href="qapplication.html#Type-enum">QApplication::GuiServer</a> type, or by running the application with the <tt>-qws</tt> command line option.</p>
<p>Applications can run using both single and multiple displays, and various command line options are available.</p>
<p>Note that this document assumes that you either are using the <a href="qvfb.html">The Virtual Framebuffer</a> or that you are running <a href="qt-embedded-linux.html">Qt for Embedded Linux</a> using the <a href="qt-embedded-vnc.html">VNC</a> protocol, <i>or</i> that you have the Linux framebuffer configured correctly and that no server process is running. (To test that the Linux framebuffer is set up correctly, use the program provided by the <a href="qt-embedded-testingframebuffer.html">Testing the Linux Framebuffer</a> document.)</p>
<a name="using-a-single-display"></a>
<h2>Using a Single Display</h2>
<p>To run the application using a single display, change to a Linux console and select an application to run, e.g. <a href="demos-textedit.html">demos/textedit</a>. Run the application with the <tt>-qws</tt> option:</p>
<pre class="cpp"> cd path/to/QtEmbedded/demos/textedit
./textedit -qws</pre>
<table class="generic" width="100%">
<tr valign="top" class="odd"><td >Provided that the environment variables are adjusted properly during the <a href="qt-embedded-install.html">installation process</a>, you should see the <a href="demos-textedit.html">Text Edit</a> demo appear.<p>It might be that the hardware drivers must be specified explicitly to make everything work properly. For more information, please consult the following documentation:</p>
<ul>
<li><a href="qt-embedded-pointer.html">Pointer Handling</a></li>
<li><a href="qt-embedded-charinput.html">Character Input</a></li>
<li><a href="qt-embedded-displaymanagement.html">Display Management</a></li>
</ul>
</td><td ><img src="images/qt-embedded-runningapplication.png" alt="" /></td></tr>
</table>
<p>Additional applications can be run as clients, i.e., by running these applications <i>without</i> the <tt>-qws</tt> option they will connect to the existing server as clients. You can exit the server application at any time using <b>Ctrl+Alt+Backspace</b>.</p>
<a name="using-multiple-displays"></a>
<h2>Using Multiple Displays</h2>
<p>Qt for Embedded Linux also allows multiple displays to be used simultaneously. There are two ways of achieving this: Either run multiple Qt for Embedded Linux server processes, or use the ready-made <tt>Multi</tt> screen driver.</p>
<p>When running multiple server processes, the screen driver (and display number) must be specified for each process using the <tt>-display</tt> command line option or by setting the <a href="qt-embedded-envvars.html#qws-display">QWS_DISPLAY</a> environment variable. For example:</p>
<pre class="cpp"> ./myfirstserverapplication -qws -display "transformed:rot90:1"
./mysecondserverapplication -qws -display "QVFb:2"</pre>
<p>See the <a href="qt-embedded-displaymanagement.html">display management</a> documentation for more details on how to specify a screen driver. Note that you must also specify the display (i.e., server process) when starting client applications:</p>
<pre class="cpp"> ./myclientapplication -display "QVFb:2"</pre>
<p>There is no way of moving a client from one display to another when running multiple server processes. Using the <tt>Multi</tt> screen driver, on the other hand, applications can easiliy be moved between the various screens.</p>
<p>The <tt>Multi</tt> screen driver can be specified just like any other screen driver by using the <tt>-display</tt> command line option or by setting the <a href="qt-embedded-envvars.html#qws-display">QWS_DISPLAY</a> environment variable. For example:</p>
<pre class="cpp"> ./myserverapplication -qws -display "Multi: QVFb:0
QVFb:1:offset=0,0 VNC:offset=640,0 :2"</pre>
<p>See the <a href="qt-embedded-displaymanagement.html">display management</a> documentation for details regarding arguments.</p>
<a name="command-line-options"></a>
<h2>Command Line Options</h2>
<table class="generic" width="100%">
<thead><tr class="qt-style"><th >Option</th><th >Description</th></tr></thead>
<tr valign="top" class="odd"><td ><b>-fn</b> <font></td><td >Defines the application font. For example:<pre class="cpp"> ./myapplication -fn helvetica</pre>
<p>The font should be specified using an X logical font description.</p>
</td></tr>
<tr valign="top" class="even"><td ><b>-bg</b> <color></td><td >Sets the default application background color. For example:<pre class="cpp"> ./myapplication -bg blue</pre>
<p>The color-name must be one of the names recognized by the <a href="qcolor.html">QColor</a> constructor.</p>
</td></tr>
<tr valign="top" class="odd"><td ><b>-btn</b> <color></td><td >Sets the default button color. For example:<pre class="cpp"> ./myapplication -btn green</pre>
<p>The color-name must be one of the names recognized by the <a href="qcolor.html">QColor</a> constructor.</p>
</td></tr>
<tr valign="top" class="even"><td ><b>-fg</b> <color></td><td >Sets the default application foreground color. For example:<pre class="cpp"> ./myapplication -fg 'dark blue'</pre>
<p>The color-name must be one of the names recognized by the <a href="qcolor.html">QColor</a> constructor.</p>
</td></tr>
<tr valign="top" class="odd"><td ><b>-name</b> <objectname></td><td >Sets the application name, i.e. the application object's object name. For example:<pre class="cpp"> ./myapplication -name texteditapplication</pre>
</td></tr>
<tr valign="top" class="even"><td ><b>-title</b> <title></td><td >Sets the application's title. For example:<pre class="cpp"> ./myapplication -title 'Text Edit'</pre>
</td></tr>
<tr valign="top" class="odd"><td ><b>-geometry</b> <width>x<height>+<Xoffset>+<Yoffset></td><td >Sets the client geometry of the first window that is shown. For example:<pre class="cpp"> ./myapplication -geometry 300x200+50+50</pre>
</td></tr>
<tr valign="top" class="even"><td ><b>-keyboard</b></td><td >Enables the keyboard.<p>See also: <a href="qt-embedded-charinput.html">Qt for Embedded Linux Character Input</a>.</p>
</td></tr>
<tr valign="top" class="odd"><td ><b>-nokeyboard</b></td><td >Disables the keyboard.</td></tr>
<tr valign="top" class="even"><td ><b>-mouse</b></td><td >Enables the mouse cursor.<p>See also: <a href="qt-embedded-pointer.html">Qt for Embedded Linux Pointer Handling</a>.</p>
</td></tr>
<tr valign="top" class="odd"><td ><b>-nomouse</b></td><td >Disables the mouse cursor.</td></tr>
<tr valign="top" class="even"><td ><b>-qws</b></td><td >Runs the application as a server application, i.e. constructs a <a href="qapplication.html">QApplication</a> object of the <a href="qapplication.html#Type-enum">QApplication::GuiServer</a> type.</td></tr>
<tr valign="top" class="odd"><td ><b>-display</b></td><td >Specifies the screen driver.<p>See also: <a href="qt-embedded-displaymanagement.html">Qt for Embedded Linux Display Management</a>.</p>
</td></tr>
<tr valign="top" class="even"><td ><b>-decoration</b> <style></td><td >Sets the application decoration. For example:<pre class="cpp"> ./myapplication -decoration windows</pre>
<p>The supported styles are <tt>windows</tt>, <tt>default</tt> and <tt>styled</tt>.</p>
<p>See also <a href="qdecoration.html">QDecoration</a>.</p>
</td></tr>
</table>
</div>
<!-- @@@qt-embedded-running.html -->
</div>
</div>
</div>
<div class="ft">
<span></span>
</div>
</div>
<div class="footer">
<p>
<acronym title="Copyright">©</acronym> 2013 Digia Plc and/or its
subsidiaries. Documentation contributions included herein are the copyrights of
their respective owners.</p>
<br />
<p>
The documentation provided herein is licensed under the terms of the
<a href="http://www.gnu.org/licenses/fdl.html">GNU Free Documentation
License version 1.3</a> as published by the Free Software Foundation.</p>
<p>
Documentation sources may be obtained from <a href="http://www.qt-project.org">
www.qt-project.org</a>.</p>
<br />
<p>
Digia, Qt and their respective logos are trademarks of Digia Plc
in Finland and/or other countries worldwide. All other trademarks are property
of their respective owners. <a title="Privacy Policy"
href="http://en.gitorious.org/privacy_policy/">Privacy Policy</a></p>
</div>
<script src="scripts/functions.js" type="text/javascript"></script>
</body>
</html>
