aboutsummaryrefslogtreecommitdiffstats
path: root/src/quick
diff options
context:
space:
mode:
authorLaszlo Agocs <laszlo.agocs@qt.io>2020-11-06 12:39:44 +0100
committerLaszlo Agocs <laszlo.agocs@qt.io>2020-11-06 17:53:47 +0100
commit4122d88ae9d0b2e2147b6e91d211a25b2e108e1b (patch)
tree2a0b1b8138fc1d8d35596c19440d16ed8d7632ab /src/quick
parent08982d3c2a36ec628fac346607832b567891812a (diff)
Clear up Canvas docs wrt the unsupported FBO render mode
Change-Id: I32f34979a45fea6ee1dfc163fa85f340eb7ca1e3 Reviewed-by: Andy Nichols <andy.nichols@qt.io>
Diffstat (limited to 'src/quick')
-rw-r--r--src/quick/items/context2d/qquickcanvasitem.cpp19
1 files changed, 2 insertions, 17 deletions
diff --git a/src/quick/items/context2d/qquickcanvasitem.cpp b/src/quick/items/context2d/qquickcanvasitem.cpp
index f182f94357..a5888203cd 100644
--- a/src/quick/items/context2d/qquickcanvasitem.cpp
+++ b/src/quick/items/context2d/qquickcanvasitem.cpp
@@ -246,34 +246,20 @@ QQuickCanvasItemPrivate::~QQuickCanvasItemPrivate()
\section1 Threaded Rendering and Render Target
- The Canvas item supports two render targets: \c Canvas.Image and
- \c Canvas.FramebufferObject.
+ In Qt 6.0 the Canvas item supports one render target: \c Canvas.Image.
The \c Canvas.Image render target is a \a QImage object. This render target
supports background thread rendering, allowing complex or long running
painting to be executed without blocking the UI. This is the only render
target that is supported by all Qt Quick backends.
- The Canvas.FramebufferObject render target utilizes OpenGL hardware
- acceleration rather than rendering into system memory, which in many cases
- results in faster rendering. Canvas.FramebufferObject relies on the OpenGL
- extensions \c GL_EXT_framebuffer_multisample and \c GL_EXT_framebuffer_blit
- for antialiasing. It will also use more graphics memory when rendering
- strategy is anything other than Canvas.Cooperative. Framebuffer objects may
- not be available with Qt Quick backends other than OpenGL.
-
The default render target is Canvas.Image and the default renderStrategy is
Canvas.Immediate.
\section1 Pixel Operations
All HTML5 2D context pixel operations are supported. In order to ensure
improved pixel reading/writing performance the \a Canvas.Image render
- target should be chosen. The \a Canvas.FramebufferObject render target
- requires the pixel data to be exchanged between the system memory and the
- graphic card, which is significantly more expensive. Rendering may also be
- synchronized with the V-sync signal (to avoid
- \l{http://en.wikipedia.org/wiki/Screen_tearing}{screen tearing}) which will further
- impact pixel operations with \c Canvas.FrambufferObject render target.
+ target should be chosen.
\section1 Tips for Porting Existing HTML5 Canvas Applications
@@ -496,7 +482,6 @@ void QQuickCanvasItem::setCanvasWindow(const QRectF& rect)
\list
\li Canvas.Image - render to an in memory image buffer.
- \li Canvas.FramebufferObject - render to an OpenGL frame buffer
\endlist
This hint is supplied along with renderStrategy to the graphics context to