Home · All Classes · Main Classes · Grouped Classes · Modules · Functions

[Contents]

Running Applications

A Qtopia Core application requires a master application to be running, or to be the master application itself. The master application is responsible for managing top-level window regions, pointer handling and character input. Any Qtopia Core application can be the master application by constructing the QApplication object with the QApplication::GuiServer type, or by running the application with the -qws command line option.

An application can be run using both single and multiple displays, and various command line option are also available.

Note that this document assumes that you either are using the Qtopia Core Virtual Framebuffer or are running Qtopia Core using the VNC protocol, or that you have the Linux framebuffer configured correctly and that no master process is running. (To test that the Linux framebuffer is set up correctly, use the program provided by the Testing the Linux Framebuffer document.)

• Using a Single Display
• Using Multiple Displays
• Command Line Options

Using a Single Display

To run the application using a single display, change to a Linux console and select an application to run, e.g. demos/textedit. Run the application with the -qws option:

    cd path/to/Qtopia/Core/demos/textedit
    ./textedit -qws

Provided that the environment variables are adjusted properly during the installation process, you should see the Text Edit demo appear. If the input methods don't work properly, the input driver and device must be specified explicitly. For more information, please consult the following documentation: Pointer Handling Character Input

Additional applications should be run as clients, i.e. without the -qws option. You can exit the master application at any time using Ctrl+Alt+Backspace.

Using Multiple Displays

Qtopia Core also allows multiple displays to be used simultaneously by running multiple Qtopia Core master processes. This is achieved using the -display command line parameter or the QWS_DISPLAY environment variable.

The -display parameter's syntax is:

    <gfx driver><:driver specific options><:display number>

The valid drivers are LinuxFb, QVfb, VNC and Transformed. For example, use the following code to run the example and demo launcher Qt Demo, on a transformed display:

    cd path/to/Qtopia/Core/examples/tools/qtdemo
    qtdemo -qws -display transformed:rot90:1

Alternatively, you can set the QWS_DISPLAY environment variable before running the application. For example, if the current shell is bash, ksh, zsh or sh:

    export QWS_DISPLAY=<gfx driver><:driver specific options><:display number>

Command Line Options

    ./myapplication -fn helvetica

    ./myapplication -bg blue

    ./myapplication -btn green

    ./myapplication -fg 'dark blue'

    ./myapplication -name texteditapplication

    ./myapplication -title 'Text Edit'

    ./myapplication -geometry 300x200x50x50

    ./myapplication -decoration windows

[Contents]