diff options
Diffstat (limited to 'src/datavisualization/doc/src/qtdatavisualization-qml-abstractdeclarative.qdoc')
| -rw-r--r-- | src/datavisualization/doc/src/qtdatavisualization-qml-abstractdeclarative.qdoc | 50 |
1 files changed, 37 insertions, 13 deletions
diff --git a/src/datavisualization/doc/src/qtdatavisualization-qml-abstractdeclarative.qdoc b/src/datavisualization/doc/src/qtdatavisualization-qml-abstractdeclarative.qdoc index df503eb4..116b63e0 100644 --- a/src/datavisualization/doc/src/qtdatavisualization-qml-abstractdeclarative.qdoc +++ b/src/datavisualization/doc/src/qtdatavisualization-qml-abstractdeclarative.qdoc @@ -66,20 +66,44 @@ */ /*! - \qmlproperty bool AbstractGraph3D::clearWindowBeforeRendering - - Indicates if the graph should also clear the whole window before rendering the graph, - including the areas outside the graph. - Since the graphs are drawn first under other QML items, the regular QML window clearing - before rendering is suppressed when there are any graphs in the window; the graphs - handle the clearing themselves instead. + \qmlproperty AbstractGraph3D.RenderingMode AbstractGraph3D::renderingMode + + Defaults to DirectToBackground. + + \table + \header + \li Render Mode + \li Description + \row + \li DirectToBackground + \li Indicates that the graph should also clear the whole window before + rendering the graph, including the areas outside the graph. + Since the graphs in this rendering mode are drawn first under other QML items, the + regular QML window clearing before rendering is suppressed when there are any graphs + in the window; the graphs handle the clearing themselves instead. If you have any other items besides graphs that do similar - custom drawing under other QML items, you need to set this property to false on all graphs - drawn to same window with the other custom items, or it is likely that the - other custom items do not render properly. - Defaults to true. - - \note This property should be set to the same value for all graphs in the same window. + custom drawing under other QML items, you need to set this property to DirectToBackground_NoClear + on all graphs drawn to same window with the other custom items, or it is likely that the + other custom items do not render properly. If the graphics hardware and current configuration + supports antialiasing that will be used to provide a higher quality rendering with good performance. + See \c {QtDataVisualization::qDefaultSurfaceFormat}. + \row + \li DirectToBackground_NoClear + \li Indicates the graph will not clear the whole window before rendering + the graph. The graphs in this renderind mode are drawn first under other QML items. + If the graphics hardware and current configuration supports antialiasing that will be + used to provide a higher quality rendering with good performance. + See \c {QtDataVisualization::qDefaultSurfaceFormat}. + \row + \li Indirect_NoAA + \li Indicates the graph will be first rendered to an offscreen surface that + is then drawn during normal QML item rendering to the correct Z order. No antialiasing + post processing is done on the graph, meaning the quality will be lower but performance + should be better. + \endtable + + \note If one graph in the window uses either DirectToBackground or DirectToBackground_NoClear, then all + other graphs in the window drawn in direct mode should use the same rendering mode in that window. Otherwise some graphs may not show. \note If window clearing before rendering is suppressed, any areas of the window not fully |