summaryrefslogtreecommitdiffstats
path: root/doc/features.doc
diff options
context:
space:
mode:
Diffstat (limited to 'doc/features.doc')
-rw-r--r--doc/features.doc274
1 files changed, 274 insertions, 0 deletions
diff --git a/doc/features.doc b/doc/features.doc
new file mode 100644
index 000000000..f6bf05f4b
--- /dev/null
+++ b/doc/features.doc
@@ -0,0 +1,274 @@
+/****************************************************************************
+**
+** Qt feature definition file documentation
+**
+** Copyright (C) 1992-2008 Trolltech ASA. All rights reserved.
+**
+** This file is part of the Qt GUI Toolkit.
+**
+** This file may be used under the terms of the GNU General
+** Public License versions 2.0 or 3.0 as published by the Free
+** Software Foundation and appearing in the files LICENSE.GPL2
+** and LICENSE.GPL3 included in the packaging of this file.
+** Alternatively you may (at your option) use any later version
+** of the GNU General Public License if such license has been
+** publicly approved by Trolltech ASA (or its successors, if any)
+** and the KDE Free Qt Foundation.
+**
+** Please review the following information to ensure GNU General
+** Public Licensing retquirements will be met:
+** http://trolltech.com/products/qt/licenses/licensing/opensource/.
+** If you are unsure which license is appropriate for your use, please
+** review the following information:
+** http://trolltech.com/products/qt/licenses/licensing/licensingoverview
+** or contact the sales department at sales@trolltech.com.
+**
+** This file may be used under the terms of the Q Public License as
+** defined by Trolltech ASA and appearing in the file LICENSE.QPL
+** included in the packaging of this file. Licensees holding valid Qt
+** Commercial licenses may use this file in accordance with the Qt
+** Commercial License Agreement provided with the Software.
+**
+** This file is provided "AS IS" with NO WARRANTY OF ANY KIND,
+** INCLUDING THE WARRANTIES OF DESIGN, MERCHANTABILITY AND FITNESS FOR
+** A PARTICULAR PURPOSE. Trolltech reserves all rights not granted
+** herein.
+**
+**********************************************************************/
+
+/*!
+\page emb-features.html
+
+\title The Feature Definition File
+
+By modifying the configured \c qconfig.h file from src/tools, you
+can define a subset of the full Qt functionality that you wish to
+be available in your installation. The -qconfig option to
+configure is used to select the configuration.
+
+Note that such modification is only supported on Qt/Embedded
+platforms, where reducing the size of Qt is
+important and the application set is often fixed.
+
+The \c qconfig.h definition file simply defines macros to disable
+features. Some features are dependent on other features and these
+dependencies are expressed in \c qfeatures.h.
+
+The available options are:
+
+\table
+\header \i Macro \i Disables \i Set automatically by
+
+\header \i31 Images (\l QImageIO)
+\row \i QT_NO_IMAGEIO_BMP
+ \i Microsoft Bitmap image file format.
+ \i  
+\row \i QT_NO_IMAGEIO_PPM
+ \i Portable Pixmap image file format.
+ \i  
+\row \i QT_NO_IMAGEIO_XBM
+ \i X11 Bitmap image file format.
+ \i  
+\row \i QT_NO_IMAGEIO_XPM
+ \i X11 Pixmap image file format.
+ \i  
+\row \i QT_NO_IMAGEIO_PNG
+ \i Portable Network Graphics image file format.
+ \i  
+
+\header \i31 Animation
+\row \i QT_NO_ASYNC_IO
+ \i Asynchronous I/O (\l QAsyncIO)
+ \i  
+\row \i QT_NO_ASYNC_IMAGE_IO
+ \i Asynchronous Image I/O and GIF image support (\l QImageDecoder, ...)
+ \i  
+\row \i QT_NO_MOVIE
+ \i Animation support (\l QMovie)
+ \i QT_NO_ASYNC_IO, QT_NO_ASYNC_IMAGE_IO
+
+\header \i31 Fonts
+\row \i QT_NO_TRUETYPE
+ \i TrueType (TTF and TTC) font file format, only used by Qt/Embedded.
+ \i  
+\row \i QT_NO_BDF
+ \i Bitmap Distribution Format (BDF) font file format, only used by Qt/Embedded.
+ \i  
+\row \i QT_NO_FONTDATABASE
+ \i Font database.
+ \i  
+
+\header \i31 Internationalization
+\row \i QT_NO_I18N
+ \i Conversions between Unicode and 8-bit encodings.
+ \i  
+\row \i QT_NO_UNICODETABLES
+ \i Large tables defining such things as upper and lowercase conversions
+ for all Unicode characters.
+ \i  
+
+\header \i31 MIME
+\row \i QT_NO_MIME
+ \i Multipurpose Internet Mail Extensions, an Internet standard for encoding
+ and tagging typed data (eg. text, images, colors) (\l QMimeSource)
+ \i  
+\row \i QT_NO_RICHTEXT
+ \i HTML-like text (\l QStyleSheet, \l QLabel)
+ \i QT_NO_MIME
+\row \i QT_NO_DRAGANDDROP
+ \i Drag-and-drop data between applications (\l QDragObject)
+ \i QT_NO_MIME
+\row \i QT_NO_CLIPBOARD
+ \i Cut-and-paste data between applications (\l QClipboard)
+ \i QT_NO_MIME
+
+\header \i31 Sound
+\row \i QT_NO_SOUND
+ \i Playing audio files (\l QSound)
+ \i  
+
+\header \i31 Scripting
+\row \i QT_NO_PROPERTIES
+ \i Scripting Qt-based applications.
+ \i  
+
+\header \i31 Qt/Embedded-specific
+\row \i QT_NO_QWS_CURSOR
+ \i The cursor sprite on Qt/Embedded. Pen-operated devices would not
+ normally need this feature.
+ \i  
+\row \i QT_NO_QWS_DEPTH_8GRAYSCALE
+ \i11 8 bits per pixel: 256 levels of gray.
+ Incompatible with QWS_DEPTH_8.
+ \i  
+\row \i QT_NO_QWS_DEPTH_8
+ \i11 8 bits per pixel: 216-color cube with 40 auxiliary colors.
+ Incompatible with QWS_DEPTH_8GRAYSCALE.
+ \i  
+\row \i QT_NO_QWS_DEPTH_15
+ \i11 15 bits per pixel: 32 levels for each of red, green and blue.
+ \i  
+\row \i QT_NO_QWS_DEPTH_16
+ \i11 16 bits per pixel: 64 levels of green, 32 levels for red and for blue.
+ \i  
+\row \i QT_NO_QWS_DEPTH_32
+ \i11 32 bits per pixel: 256 levels for each of red, green and blue.
+ \i  
+\row \i QT_NO_QWS_MACH64
+ \i Mach64 accelerated driver (demonstration only).
+ \i  
+\row \i QT_NO_QWS_VFB
+ \i Virtual framebuffer running on X11 (see reference documentation).
+ \i  
+
+\header \i31 Networking
+\row \i QT_NO_NETWORKPROTOCOL
+ \i Abstract multi-protocol data retrieval,
+ with local file retrieval included (\l QNetworkProtocol)
+ \i  
+\row \i QT_NO_NETWORKPROTOCOL_FTP
+ \i FTP-protocol data retrieval.
+ \i QT_NO_NETWORKPROTOCOL
+\row \i QT_NO_NETWORKPROTOCOL_HTTP
+ \i HTTP-protocol data retrieval.
+ \i QT_NO_NETWORKPROTOCOL
+
+\header \i31 Painting/drawing
+\row \i QT_NO_COLORNAMES
+ \i Color names such as "red", used by some \l QColor constructors
+ and by some HTML documents (\l QColor, \l QStyleSheet)
+ \i  
+\row \i QT_NO_TRANSFORMATIONS
+ \i Used by a number of classes in Qt. With this, rotation and
+ scaling are possible. Without it you can only do coordinate
+ translation (\l QWMatrix)
+ \i  
+\row \i QT_NO_PSPRINTER
+ \i PostScript printer support.
+ \i  
+\row \i QT_NO_PRINTER
+ \i Printer support (\l QPrinter)
+ \i QT_NO_PSPRINTER (Unix only)
+\row \i QT_NO_PICTURE
+ \i Save Qt drawing commands to a files (\l QPicture)
+ \i  
+
+\header \i31 Widgets
+\row \i QT_NO_WIDGETS
+ \i Disabling this disables all widgets except \l QWidget.
+ \i  
+\row \i QT_NO_TEXTVIEW
+ \i HTML document viewing (\l QTextView)
+ \i QT_NO_WIDGETS, QT_NO_RICHTEXT
+\row \i QT_NO_TEXTBROWSER
+ \i HTML document browsing (\l QTextBrowser)
+ \i QT_NO_TEXTVIEW
+\row \i QT_NO_ICONVIEW
+ \i Labelled icons (\l QIconView)
+ \i QT_NO_WIDGETS, QT_NO_DRAGANDDROP
+\row \i QT_NO_LISTVIEW
+ \i Lists of information (\l QListView)
+ \i QT_NO_WIDGETS
+\row \i QT_NO_CANVAS
+ \i Object canvas (\l QCanvas)
+ \i QT_NO_WIDGETS
+\row \i QT_NO_DIAL
+ \i Value control (\l QDial)
+ \i QT_NO_WIDGETS
+\row \i QT_NO_WORKSPACE
+ \i MDI (Multiple Document Interface) (\l QWorkspace)
+ \i QT_NO_WIDGETS
+\row \i QT_NO_LCDNUMBER
+ \i LCD-like number display (\l QLCDNumber)
+ \i QT_NO_WIDGETS
+
+\header \i31 GUI Styles
+\row \i QT_NO_STYLE_WINDOWS
+ \i Microsoft Windows style (\l QWindowsStyle)
+ \i QT_NO_WIDGETS
+\row \i QT_NO_STYLE_MOTIF
+ \i OSF Motif style (\l QMotifStyle)
+ \i QT_NO_WIDGETS
+\row \i QT_NO_STYLE_CDE
+ \i Open Group CDE style (\l QCDEStyle)
+ \i QT_NO_STYLE_MOTIF
+\row \i QT_NO_STYLE_AQUA
+ \i MacOS X style (\l QAquaStyle)
+\row \i QT_NO_STYLE_PLATINUM
+ \i MacOS 9 style (\l QPlatinumStyle)
+ \i QT_NO_WIDGETS
+\row \i QT_NO_STYLE_SGI
+ \i SGI style (\l QSGIStyle)
+ \i QT_NO_STYLE_MOTIF
+
+\header \i31 Dialogs
+\row \i QT_NO_DIALOGS
+ \i Disabling this disables all common dialogs \l QWidget.
+ \i QT_NO_WIDGETS
+\row \i QT_NO_FILEDIALOG
+ \i The file selection dialog (\l QFileDialog)
+ \i QT_NO_DIALOGS, QT_NO_NETWORKPROTOCOL, QT_NO_LISTVIEW
+\row \i QT_NO_FONTDIALOG
+ \i The font selection dialog (\l QFontDialog)
+ \i QT_NO_DIALOGS, QT_NO_FONTDATABASE
+\row \i QT_NO_COLORDIALOG
+ \i The color selection dialog (\l QColorDialog)
+ \i QT_NO_DIALOGS
+\row \i QT_NO_INPUTDIALOG
+ \i Text input dialog (\l QInputDialog)
+ \i QT_NO_DIALOGS
+\row \i QT_NO_MESSAGEBOX
+ \i Message/prompting dialog (\l QMessageBox)
+ \i QT_NO_DIALOGS
+\row \i QT_NO_PROGRESSDIALOG
+ \i Long-computation progress dialog (\l QProgressDialog)
+ \i QT_NO_DIALOGS
+\row \i QT_NO_TABDIALOG
+ \i Tabbed-pages dialog (\l QTabDialog)
+ \i QT_NO_DIALOGS
+\row \i QT_NO_WIZARD
+ \i Multi-step dialog (\l QWizard)
+ \i QT_NO_DIALOGS
+\endtable
+
+*/