diff options
| author | Eskil Abrahamsen Blomfeldt <eskil.abrahamsen-blomfeldt@nokia.com> | 2012-10-04 10:55:12 +0200 |
|---|---|---|
| committer | The Qt Project <gerrit-noreply@qt-project.org> | 2012-10-08 09:16:27 +0200 |
| commit | 3f6122a6926c190381a505d4b18fd44079927a4a (patch) | |
| tree | cc039f93eb11768c9d6512d09bfae1b55985b37a /src/gui/painting/qpaintdevice.qdoc | |
| parent | d4ad9dbbf96884c0899e8f8116a8a056facd52d5 (diff) | |
doc: Update Q*PaintDevice docs
Minor syntax typo in QPagedPaintDevice.
Some Qt 5 updates in QPaintDevice (QGuiApplication)
and a couple of other changes:
1. Usually, we say an object is "painted" or "drawn" when it is
drawn on top of another object (like drawEllipse()) not when it
is the destination of the draw commands. To be more consistent I
updated the language here.
2. What's commonly called a 32-bit display has 24 bits of color
information and eight bits of opacity information. This gives a
color count which can be accurately represented by int. To avoid
confusion, the exception in the docs for colorCount() has been
generalized a little.
Change-Id: Iabaaed1f3e4a80e7e14dfd8855da8c3cd8b3012f
Reviewed-by: Samuel Rødal <samuel.rodal@digia.com>
Diffstat (limited to 'src/gui/painting/qpaintdevice.qdoc')
| -rw-r--r-- | src/gui/painting/qpaintdevice.qdoc | 12 |
1 files changed, 6 insertions, 6 deletions
diff --git a/src/gui/painting/qpaintdevice.qdoc b/src/gui/painting/qpaintdevice.qdoc index 78b9d461ca..e07e30a7ae 100644 --- a/src/gui/painting/qpaintdevice.qdoc +++ b/src/gui/painting/qpaintdevice.qdoc @@ -28,12 +28,12 @@ /*! \class QPaintDevice \brief The QPaintDevice class is the base class of objects that - can be painted. + can be painted on with QPainter. \ingroup painting A paint device is an abstraction of a two-dimensional space that - can be drawn using a QPainter. Its default coordinate system has + can be drawn on using a QPainter. Its default coordinate system has its origin located at the top-left position. X increases to the right and Y increases downwards. The unit is one pixel. @@ -48,7 +48,7 @@ paint engine to be able to draw on the device, i.e derive from QPaintEngine and reimplement its virtual functions. - \warning Qt requires that a QApplication object exists before + \warning Qt requires that a QGuiApplication object exists before any paint devices can be created. Paint devices access window system resources, and these resources are not initialized before an application object is created. @@ -208,9 +208,9 @@ \fn int QPaintDevice::colorCount() const Returns the number of different colors available for the paint - device. Since this value is an int, it will not be sufficient to - represent the number of colors on 32 bit displays, in this case - INT_MAX is returned instead. + device. If the number of colors available is too great to be + represented by the int data type, then INT_MAX will be returned + instead. */ /*! |