Home · All Classes · Grouped Classes · Annotated · Functions

Customizing Components

Introduction

Qtopia is a modular system, allowing each component to be replaced. This page describes key issues with replacing existing components and with integrating some common components that do not exist in Qtopia.

Removing Components

Choosing not to build a component, for example, Todo, can easily be done by editing $QPEDIR/src/custom.pri and re-configuring Qtopia.

For example add the following to custom.pri:

    APP_PROJECTS-=applications/todo

For further information see Deciding what to build.

Developer-Only Components

The following are applications/features supplied with Qtopia that are not intended to be shipped with production devices:

Application/FeatureDescription
Rotation SettingProvided to test and demonstrate Qtopia's ability to display in different orientations. It may be helpful during development if the device uses the transformation display driver.
Shutdown SettingProvided as a development tool and is not necessary on a production device. It can be removed by deleting apps/Settings/quit.desktop. On most devices it is expected that there is a physical power button, therefore the user is not expected to manually run or shutdown Qtopia.
Screensize AppletAllows changing the maximum window size for testing different screen sizes during development. This is a development tool only and is not intended for end-users.

Unsupported Components

The following applications are unsupported 3rd party applications/ports intended purely to demonstrate the flexibility of Qtopia:

Camera / Camcorder

Qtopia ships with a basic Camera application. Substitute applications should supply the following services:

The Qtopia Camera application uses the Video4Linux API, facilitating interoperability. Substitute applications should consider also using this API.

The Qtopia Camera application uses the QDirectPainter class in simple cases. Substitute applications should always use this class in cases appropriate for the target device.

Playback in a Camcorder function should follow the Guidelines for Video Applications.

Music

Qtopia ships with the Music application for playing MP3 and other audio files. Substitute applications should supply the following services:

Audio uses the QSS sound server's pipe functionality which allows multiple applications to produce audio simultaneously. An alternative is to use in-kernel audio mixing.

Video

Qtopia ships with the Video application for playing MPEG and other video files. Substitute applications should supply the following services:

The Qtopia Video application uses the QDirectPainter class to optimize painting. Substitute applications should use this class, to ensure interoperability with other applications.

Audio in the Video function should follow the Guidelines for Music applications.

Pictures

Qtopia ships with the Pictures application. Substitute applications should supply the following services:

Voice Notes

Qtopia ships with the Voice Notes application. Substitute applications should supply the following services:

Video Calls

Qtopia does not ship with Video Call functionality.

Depending on the underlying technology, integrating video call functionality involves integration changes in Contacts (src/applications/addressbook/) and the Phone Launcher (src/server/phone/).


Copyright © 2007 Trolltech Trademarks
Qtopia 4.2.5