summaryrefslogtreecommitdiffstats
path: root/qtc_packaging/debian_harmattan/README
diff options
context:
space:
mode:
Diffstat (limited to 'qtc_packaging/debian_harmattan/README')
-rw-r--r--qtc_packaging/debian_harmattan/README95
1 files changed, 0 insertions, 95 deletions
diff --git a/qtc_packaging/debian_harmattan/README b/qtc_packaging/debian_harmattan/README
deleted file mode 100644
index b21b46df..00000000
--- a/qtc_packaging/debian_harmattan/README
+++ /dev/null
@@ -1,95 +0,0 @@
-This is the Qt Quick 3D project:
- * QtQuick3D QML bindings and
- * Qt3D C++ APIs
-
-
-Building QtQuick3D
-==================
-
-Check the building instructions in doc/src/qt3d-building.qdoc also available
-online at: http://doc.qt.nokia.com/qt-quick3d-snapshot/qt3d-building.html
-
-
-Whats in QtQuick3D
-==================
-
-Directory structure:
-
-src/threed/
- This is the main library of the Qt3D project, containing abstractions
- for cross-platform GL, shaders, lighting models, and so on.
-src/plugins/
- Scene format loading plugins.
-src/imports/
- QML import plugins.
-util/
- Various utilities that are useful when working with Qt3D.
-examples/
- Some examples of using QtQuick3D (QML bindings) and Qt3D (C++ API).
-demos/
- Some more complex demos of using QtQuiick3D (QML bindings) and Qt3D (C++ API).
-tests/auto/qml3d/
- Unit tests for the QtQuick3D bindings.
-tests/auto/threed/
- Unit tests for the Qt3D C++ API
-doc/
- Documentation.
-devices/symbian/
- Symbian deployment file
-
-
-Documentation
-=============
-
-The documentation can be generated with "make docs". It will be placed
-into "doc/html" in the build directory.
-
-
-Packages
-========
-
-This section is only for those developing QtQuick3D. Read on to discover how
-the building of packages works. This section is also important if you want to
-change how the structure of the QtQuick3D pro files work.
-
-QtQuick3D is intended to be built in one of two ways:
-
-1) Normal developer way:
- qmake && make
-2) Package creation way:
- qmake CONFIG+=package && INSTALL_ROOT=tmp make install
-
-In 1) the .pro files will cause the toolchain to place the libraries, plugins
-header files and other components of QtQuick3D directly into place, as part of
-the compile process. What does "in place" mean? Run "qmake -query" to see
-the paths where the files are placed - QML plugins go in $$[QT_INSTALL_IMPORTS]
-for example. In this mode, there is no need to run "make install" because the
-files are already in their target destination. Here the "target destination"
-means the Qt which is being built against.
-
-First note that QtQuick3D has to be installed into the target Qt. This is because
-QtQuick3D has QML plugins and resources, as well as shared libraries, all of which
-must be resolved by the QMLViewer of the target Qt at runtime. Here where "qmake"
-is referred to it means the qmake inside the target Qt. Since QtDeclarative
-recommends using QMLViewer when developing and debugging QML Apps, in the developer
-case - which is what Qt3D is for - it has to install directly into the target Qt.
-
-In this mode 1) after the main library is compiled subsequent targets can simply
-resolve includes and link time dependencies by use of qt3d.prf and qtquick3d.prf.
-These two files are installed into the target Qt's makespecs/features directory
-during the processing of the quick3d.pro file.
-
-In 2) the libraries, plugins and so on are sitting inside the build tree after
-the compile step. As a result in order to resolve includes and dependencies
-the build system has to navigate the build tree with paths like "-L../../../threed"
-to locate the Qt3D libraries.
-
-Actually there is one build artifact that is not just left where it lands in the
-build tree - the header files. These are actually copied into an "include"
-directory inside the build root directory. This is because at present the header
-files all live inside their own seperate subdirectories under "threed" and would
-be too cumbersome to path in explicitly.
-
-After building the tree the install step is invoked using the INSTALL_ROOT environment
-export to cause the installation rules to place all the files into a sandboxed
-install tree, ready for packaging.