QSvgGenerator Class▲
-
Header: QSvgGenerator
-
CMake:
find_package(Qt6 REQUIRED COMPONENTS Svg)
target_link_libraries(mytarget PRIVATE Qt6::Svg)
-
qmake: QT += svg
-
Inherits: QPaintDevice
-
Group: QSvgGenerator is part of painting
Detailed Description▲
This paint device represents a Scalable Vector Graphics (SVG) drawing. Like QPrinter, it is designed as a write-only device that generates output in a specific format.
To write an SVG file, you first need to configure the output by setting the fileName or outputDevice properties. It is usually necessary to specify the size of the drawing by setting the size property, and in some cases where the drawing will be included in another, the viewBox property also needs to be set.
QSvgGenerator generator;
generator.setFileName(path);
generator.setSize(QSize(200, 200));
generator.setViewBox(QRect(0, 0, 200, 200));
generator.setTitle(tr("SVG Generator Example Drawing"));
generator.setDescription(tr("An SVG drawing created by the SVG Generator "
"Example provided with Qt."));Other meta-data can be specified by setting the title, description and resolution properties.
As with other QPaintDevice subclasses, a QPainter object is used to paint onto an instance of this class:
QPainter painter;
painter.begin(&generator);
...
painter.end();Painting is performed in the same way as for any other paint device. However, it is necessary to use the QPainter::begin() and end() to explicitly begin and end painting on the device.
The SVG Generator Example shows how the same painting commands can be used for painting a widget and writing an SVG file.
See Also▲
See also QSvgRenderer, QSvgWidget, Qt SVG C++ Classes
Property Documentation▲
description : QString▲
This property holds the description of the generated SVG drawing
Access functions:
-
description() const
-
void setDescription(const &description)
See Also▲
See also title
fileName : QString▲
This property holds the target filename for the generated SVG drawing
Access functions:
-
fileName() const
-
void setFileName(const &fileName)
See Also▲
See also outputDevice
outputDevice : QIODevice*▲
This property holds the output device for the generated SVG drawing
If both output device and file name are specified, the output device will have precedence.
Access functions:
-
*outputDevice() const
-
void setOutputDevice( *outputDevice)
See Also▲
See also fileName
resolution : int▲
This property holds the resolution of the generated output
The resolution is specified in dots per inch, and is used to calculate the physical size of an SVG drawing.
Access functions:
-
int resolution() const
-
void setResolution(int dpi)
See Also▲
size : QSize▲
This property holds the size of the generated SVG drawing
By default this property is set to QSize(-1, -1), which indicates that the generator should not output the width and height attributes of the <svg> element.
It is not possible to change this property while a QPainter is active on the generator.
Access functions:
-
size() const
-
void setSize(const &size)
See Also▲
See also viewBox, resolution
title : QString▲
This property holds the title of the generated SVG drawing
Access functions:
-
title() const
-
void setTitle(const &title)
See Also▲
See also description
viewBox : QRectF▲
This property holds the viewBox of the generated SVG drawing
By default this property is set to QRect(0, 0, -1, -1), which indicates that the generator should not output the viewBox attribute of the <svg> element.
It is not possible to change this property while a QPainter is active on the generator.
Access functions:
-
viewBoxF() const
-
void setViewBox(const &viewBox)
-
void setViewBox(const &viewBox)
See Also▲
See also viewBox(), size, resolution
Member Function Documentation▲
QSvgGenerator::QSvgGenerator()▲
Constructs a new generator.
[virtual] QSvgGenerator::~QSvgGenerator()▲
Destroys the generator.
[override virtual protected] int QSvgGenerator::metric(QPaintDevice::PaintDeviceMetric metric) const▲
[override virtual protected] QPaintEngine *QSvgGenerator::paintEngine() const▲
Reimplements: QPaintDevice::paintEngine() const.
Returns the paint engine used to render graphics to be converted to SVG format information.