16.3. Usare Plugin Layer
Se il tuo plugin usa i propri metodi per visualizzare un layer mappa, scrivere il proprio tipo di layer basato su QgsPluginLayer
potrebbe essere il modo migliore per implementarlo.
16.3.1. Sottoclasse QgsPluginLayer
Di seguito è riportato un esempio di implementazione minima di QgsPluginLayer. È basato sul codice originale del plugin d’esempio Watermark.
Il visualizzatore personalizzato è il componente dell’implementazione che definisce la rappresentazione grafica sulla mappa.
1class WatermarkLayerRenderer(QgsMapLayerRenderer):
2
3 def __init__(self, layerId, rendererContext):
4 super().__init__(layerId, rendererContext)
5
6 def render(self):
7 image = QImage("/usr/share/icons/hicolor/128x128/apps/qgis.png")
8 painter = self.renderContext().painter()
9 painter.save()
10 painter.drawImage(10, 10, image)
11 painter.restore()
12 return True
13
14class WatermarkPluginLayer(QgsPluginLayer):
15
16 LAYER_TYPE="watermark"
17
18 def __init__(self):
19 super().__init__(WatermarkPluginLayer.LAYER_TYPE, "Watermark plugin layer")
20 self.setValid(True)
21
22 def createMapRenderer(self, rendererContext):
23 return WatermarkLayerRenderer(self.id(), rendererContext)
24
25 def setTransformContext(self, ct):
26 pass
27
28 # Methods for reading and writing specific information to the project file can
29 # also be added:
30
31 def readXml(self, node, context):
32 pass
33
34 def writeXml(self, node, doc, context):
35 pass
Il layer plugin può essere aggiunto al progetto e al mappa come qualsiasi altro layer della mappa:
plugin_layer = WatermarkPluginLayer()
QgsProject.instance().addMapLayer(plugin_layer)
Quando si carica un progetto contenente un layer di questo tipo, è necessaria una classe factory:
1class WatermarkPluginLayerType(QgsPluginLayerType):
2
3 def __init__(self):
4 super().__init__(WatermarkPluginLayer.LAYER_TYPE)
5
6 def createLayer(self):
7 return WatermarkPluginLayer()
8
9 # You can also add GUI code for displaying custom information
10 # in the layer properties
11 def showLayerProperties(self, layer):
12 pass
13
14
15# Keep a reference to the instance in Python so it won't
16# be garbage collected
17plt = WatermarkPluginLayerType()
18
19assert QgsApplication.pluginLayerRegistry().addPluginLayerType(plt)