Home · All 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 refer to: $QPEDIR/src/custom.pri and Build System User Guide.

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.
TerminalProvided as a development tool. It may be reasonable to provide this as a separate installable package for advanced users who are familiar with Linux. However, the majority of users may find this tool confusing rather than useful. Therefore it is recommended that this program not be included.
File ManagerProvided as a development tool. Qtopia is functional without it by utilizing the Qtopia document model. Adding the File Browser makes it possible for users to add and remove files from the device in a way that does not correspond to the Qtopia document model. We therefore do not recommend this program be included on a device to ensure a consistent document model in addition to protecting critical user and system files and settings.

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 © 2006 Trolltech Trademarks
Qtopia 4.1.7