Class: QgsSvgCache¶
-
class
qgis.core.
QgsSvgCache
(parent: QObject = None)¶ Bases:
qgis._core.QgsAbstractContentCacheBase
Constructor for QgsSvgCache.
A cache for images / pictures derived from svg files. This class supports parameter replacement in svg files according to the svg params specification (http://www.w3.org/TR/2009/WD-SVGParamPrimer-20090616/). Supported are the parameters ‘fill-color’, ‘pen-color’, ‘outline-width’, ‘stroke-width’. E.g. <circle fill=”param(fill-color red)” stroke=”param(pen-color black)” stroke-width=”param(outline-width 1)”
QgsSvgCache is not usually directly created, but rather accessed through
QgsApplication.svgCache()
Enums
Methods
Tests if an svg file contains parameters for fill, stroke color, stroke width.
Tests if an svg file contains parameters for fill, stroke color, stroke width.
Gets image data
Gets SVG as QImage.
Gets SVG as QPicture&.
Gets SVG content
Calculates the viewbox size of a (possibly cached) SVG file.
Signals
Emitted when the cache has finished retrieving an SVG file from a remote
url
.Emit a signal to be caught by qgisapp and display a msg on status bar.
Attributes
-
checkReply
(self, reply: QNetworkReply, path: str) → bool¶
-
childEvent
()¶
-
connectNotify
()¶
-
containsParams
(self, path: str, defaultFillColor: Union[QColor, Qt.GlobalColor], defaultStrokeColor: Union[QColor, Qt.GlobalColor]) → Tuple[bool, bool, bool, float]¶ Tests if an svg file contains parameters for fill, stroke color, stroke width. If yes, possible default values are returned. If there are several default values in the svg file, only the first one is considered*
-
containsParamsV3
(self, path: str, defaultFillColor: Union[QColor, Qt.GlobalColor], defaultStrokeColor: Union[QColor, Qt.GlobalColor]) → Tuple[bool, bool, bool, bool, float, bool, bool, bool, bool, float, bool, bool, float]¶ Tests if an svg file contains parameters for fill, stroke color, stroke width. If yes, possible default values are returned. If there are several default values in the svg file, only the first one is considered.
- Parameters
path – path to SVG file
hasFillParam – will be true if fill param present in SVG
hasDefaultFillParam – will be true if fill param has a default value specified
defaultFillColor – will be set to default fill color specified in SVG, if present
hasFillOpacityParam – will be true if fill opacity param present in SVG
hasDefaultFillOpacity – will be true if fill opacity param has a default value specified
defaultFillOpacity – will be set to default fill opacity specified in SVG, if present
hasStrokeParam – will be true if stroke param present in SVG
hasDefaultStrokeColor – will be true if stroke param has a default value specified
defaultStrokeColor – will be set to default stroke color specified in SVG, if present
hasStrokeWidthParam – will be true if stroke width param present in SVG
hasDefaultStrokeWidth – will be true if stroke width param has a default value specified
defaultStrokeWidth – will be set to default stroke width specified in SVG, if present
hasStrokeOpacityParam – will be true if stroke opacity param present in SVG
hasDefaultStrokeOpacity – will be true if stroke opacity param has a default value specified
defaultStrokeOpacity – will be set to default stroke opacity specified in SVG, if present
Note
available in Python bindings as containsParamsV3
New in version 2.14.
-
customEvent
()¶
-
disconnectNotify
()¶
-
getImageData
(self, path: str) → QByteArray¶ Gets image data
-
isSignalConnected
()¶
-
onRemoteContentFetched
()¶
-
receivers
()¶
-
remoteSvgFetched
¶ Emitted when the cache has finished retrieving an SVG file from a remote
url
.New in version 3.2: [signal]
-
sender
()¶
-
senderSignalIndex
()¶
-
statusChanged
¶ Emit a signal to be caught by qgisapp and display a msg on status bar.
Deprecated since version Deprecated: since QGIS 3.6 – no longer emitted. [signal]
-
svgAsImage
(self, path: str, size: float, fill: Union[QColor, Qt.GlobalColor], stroke: Union[QColor, Qt.GlobalColor], strokeWidth: float, widthScaleFactor: float, fixedAspectRatio: float = 0) → Tuple[QImage, bool]¶ Gets SVG as QImage.
- Parameters
path – Absolute path to SVG file.
size – size of cached image
fill – color of fill
stroke – color of stroke
strokeWidth – width of stroke
widthScaleFactor – width scale factor
fitsInCache –
fixedAspectRatio – fixed aspect ratio (optional)
-
svgAsPicture
(self, path: str, size: float, fill: Union[QColor, Qt.GlobalColor], stroke: Union[QColor, Qt.GlobalColor], strokeWidth: float, widthScaleFactor: float, forceVectorOutput: bool = False, fixedAspectRatio: float = 0) → QPicture¶ Gets SVG as QPicture&.
- Parameters
path – Absolute path to SVG file.
size – size of cached image
fill – color of fill
stroke – color of stroke
strokeWidth – width of stroke
widthScaleFactor – width scale factor
forceVectorOutput –
fixedAspectRatio – fixed aspect ratio (optional)
-
svgContent
(self, path: str, size: float, fill: Union[QColor, Qt.GlobalColor], stroke: Union[QColor, Qt.GlobalColor], strokeWidth: float, widthScaleFactor: float, fixedAspectRatio: float = 0) → QByteArray¶ Gets SVG content
-
svgViewboxSize
(self, path: str, size: float, fill: Union[QColor, Qt.GlobalColor], stroke: Union[QColor, Qt.GlobalColor], strokeWidth: float, widthScaleFactor: float, fixedAspectRatio: float = 0) → QSizeF¶ Calculates the viewbox size of a (possibly cached) SVG file.
- Parameters
path – Absolute path to SVG file.
size – size of cached image
fill – color of fill
stroke – color of stroke
strokeWidth – width of stroke
widthScaleFactor – width scale factor
fixedAspectRatio – fixed aspect ratio (optional)
- Returns
viewbox size set in SVG file
New in version 2.14.
-
timerEvent
()¶
-