diff options
Diffstat (limited to 'src/quick/doc/src/cppextensionpoints.qdoc')
| -rw-r--r-- | src/quick/doc/src/cppextensionpoints.qdoc | 35 |
1 files changed, 30 insertions, 5 deletions
diff --git a/src/quick/doc/src/cppextensionpoints.qdoc b/src/quick/doc/src/cppextensionpoints.qdoc index 953d804b60..efda628340 100644 --- a/src/quick/doc/src/cppextensionpoints.qdoc +++ b/src/quick/doc/src/cppextensionpoints.qdoc @@ -30,23 +30,48 @@ \title C++ Extension Points Provided By Qt Quick \brief Description of the C++ extension points provided by the Qt Quick module -// XXX TODO: should this be a topic page? Are each of the sections below big enough to require their own page? +All QML applications can be extended from C++ in order to use additional +functionality implemented in C++ code or to provide a C++ based QML plugin. +This topic of extending QML from C++ is covered in the \l {Integrating QML and C++} +documentation. -Qt Quick provides several extension and integration points for C++ developers. -In particular, it allows C++ developers to create and register custom +Additionally, the Qt Quick module provides several extension and integration points for C++ +developers, specific to this module. In particular, it allows C++ developers to create and register custom QQuickItem-derived types which can be rendered by Qt Quick. It also provides several scene graph-related classes which allow developers to define their own rendering primitives. + \section1 User-Defined QQuickItem-Derived Types While the Qt Quick module already provides a rich library of visual item types for use in a QML application, some developers may wish to define their own -item-derived types in C++ and expose them to the QML type system. +item-derived types in C++ and expose them to the QML type system. The easiest +way to do this is to subclass QQuickItem, which is the base type +for all visual types in the Qt Quick module. See the QQuickItem documentation +for more details. + \section1 Scene Graph-Related Classes As an OpenGL-based scene graph, the scene graph in Qt Quick uses nodes which -may be geometries or textures. +may be geometries or textures. The \l {Qt Quick Module - C++ Classes}{Qt Quick C++ API} +provides various classes to enable custom nodes to be created in C++ to be +used with the scene graph framework. + +See the \l {Qt Quick Scene Graph} documentation for details. + + +\section1 Pixmap and Threaded Image Support + +While the QML engine allows QML application to load images from filesystem or +network resources, some applications may require the additional option of +loading images from C++ based processes. This can be implemented through the +QQuickImageProvider class, which provides support for pixmap loading and +threaded image requests for QML applications. Any QML application that +requests an image through the special "image:" URL scheme will be directed +to an appropriate image provider to load the image. + +For more information, see the QQuickImageProvider documentation. */ |