QSvgGenerator

The QSvgGenerator class provides a paint device that is used to create SVG drawings. More

Inheritance diagram of PySide2.QtSvg.QSvgGenerator

Synopsis

Functions

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 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

QSvgRenderer QSvgWidget Qt SVG C++ Classes

class PySide2.QtSvg.QSvgGenerator

Constructs a new generator.

PySide2.QtSvg.QSvgGenerator.description()
Return type

str

This property holds the description of the generated SVG drawing.

See also

title

PySide2.QtSvg.QSvgGenerator.fileName()
Return type

str

This property holds the target filename for the generated SVG drawing.

See also

outputDevice

PySide2.QtSvg.QSvgGenerator.outputDevice()
Return type

PySide2.QtCore.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.

See also

fileName

PySide2.QtSvg.QSvgGenerator.resolution()
Return type

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.

See also

size viewBox

PySide2.QtSvg.QSvgGenerator.setDescription(description)
Parameters

description – str

This property holds the description of the generated SVG drawing.

See also

title

PySide2.QtSvg.QSvgGenerator.setFileName(fileName)
Parameters

fileName – str

This property holds the target filename for the generated SVG drawing.

See also

outputDevice

PySide2.QtSvg.QSvgGenerator.setOutputDevice(outputDevice)
Parameters

outputDevicePySide2.QtCore.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.

See also

fileName

PySide2.QtSvg.QSvgGenerator.setResolution(dpi)
Parameters

dpi – 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.

See also

size viewBox

PySide2.QtSvg.QSvgGenerator.setSize(size)
Parameters

sizePySide2.QtCore.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.

Note

It is not possible to change this property while a QPainter is active on the generator.

See also

viewBox resolution

PySide2.QtSvg.QSvgGenerator.setTitle(title)
Parameters

title – str

This property holds the title of the generated SVG drawing.

See also

description

PySide2.QtSvg.QSvgGenerator.setViewBox(viewBox)
Parameters

viewBoxPySide2.QtCore.QRect

PySide2.QtSvg.QSvgGenerator.setViewBox(viewBox)
Parameters

viewBoxPySide2.QtCore.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.

Note

It is not possible to change this property while a QPainter is active on the generator.

PySide2.QtSvg.QSvgGenerator.size()
Return type

PySide2.QtCore.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.

Note

It is not possible to change this property while a QPainter is active on the generator.

See also

viewBox resolution

PySide2.QtSvg.QSvgGenerator.title()
Return type

str

This property holds the title of the generated SVG drawing.

See also

description

PySide2.QtSvg.QSvgGenerator.viewBox()
Return type

PySide2.QtCore.QRect

Returns viewBoxF() .toRect().

PySide2.QtSvg.QSvgGenerator.viewBoxF()
Return type

PySide2.QtCore.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.

Note

It is not possible to change this property while a QPainter is active on the generator.