Drawing and Filling¶
QPainter provides highly optimized functions to do most of the drawing GUI programs require. It can draw everything from simple graphical primitives (represented by the
QPolygon classes) to complex shapes like vector paths. In Qt vector paths are represented by the
QPainterPath provides a container for painting operations, enabling graphical shapes to be constructed and reused.
A painter path is an object composed of lines and curves. For example, a rectangle is composed by lines and an ellipse is composed by curves.
The main advantage of painter paths over normal drawing operations is that complex shapes only need to be created once; then they can be drawn many times using only calls to the
QPainterPathobject can be used for filling, outlining, and clipping. To generate fillable outlines for a given painter path, use the
Lines and outlines are drawn using the
QPen class. A pen is defined by its style (i.e. its line-type), width, brush, how the endpoints are drawn (cap-style) and how joins between two connected lines are drawn (join-style). The pen’s brush is a
QBrush object used to fill strokes generated with the pen, i.e. the
QBrush class defines the fill pattern.
QPainter can also draw aligned text and pixmaps.
When drawing text, the font is specified using the
QFont class. Qt will use the font with the specified attributes, or if no matching font exists, Qt will use the closest matching installed font. The attributes of the font that is actually used can be retrieved using the
QFontInfo class. In addition, the
QFontMetrics class provides the font measurements, and the
QFontDatabase class provides information about the fonts available in the underlying window system.
QPainter draws in a “natural” coordinate system, but it is able to perform view and world transformations using the
QTransform class. For more information, see Coordinate System , which also describes the rendering process, i.e. the relation between the logical representation and the rendered pixels, and the benefits of anti-aliased painting.
When drawing, the pixel rendering is controlled by the
Antialiasingrender hint. The
RenderHintenum is used to specify flags to
QPainterthat may or may not be respected by any given engine.
Antialiasingvalue indicates that the engine should antialias edges of primitives if possible, i.e. smoothing the edges by using different color intensities.
Shapes are filled using the
QBrush class. A brush is defined by its color and its style (i.e. its fill pattern).
Any color in Qt is represented by the
QColor class which supports the RGB, HSV and CMYK color models.
QColor also support alpha-blended outlining and filling (specifying the transparency effect), and the class is platform and device independent (the colors are mapped to hardware using the
QColormap class). For more information, see the
QColor class documentation.
The available fill patterns are described by the
BrushStyle enum. These include basic patterns spanning from uniform color to very sparse pattern, various line combinations, gradient fills and textures. Qt provides the
QGradient class to define custom gradient fills, while texture patterns are specified using the
QGradientclass is used in combination with
QBrushto specify gradient fills.
Qt currently supports three types of gradient fills: Linear gradients interpolate colors between start and end points, radial gradients interpolate colors between a focal point and end points on a circle surrounding it, and conical gradients interpolate colors around a center point.
© 2022 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.