Using Plugin Layers¶
Avertissement
Despite our constant efforts, information beyond this line may not be updated for QGIS 3. Refer to https://qgis.org/pyqgis/master for the python API documentation or, give a hand to update the chapters you know about. Thanks.
Si votre extension utilise ses propres méthodes pour faire le rendu de la couche cartographique, écrire votre propre type de couche basé sur QgsPluginLayer pourrait être la meilleure façon de l’implémenter.
- A FAIRE :
Check correctness and elaborate on good use cases for QgsPluginLayer, …
Subclassing QgsPluginLayer¶
Below is an example of a minimal QgsPluginLayer implementation. It is an excerpt of the Watermark example plugin
class WatermarkPluginLayer(QgsPluginLayer):
LAYER_TYPE="watermark"
def __init__(self):
QgsPluginLayer.__init__(self, WatermarkPluginLayer.LAYER_TYPE, "Watermark plugin layer")
self.setValid(True)
def draw(self, rendererContext):
image = QImage("myimage.png")
painter = rendererContext.painter()
painter.save()
painter.drawImage(10, 10, image)
painter.restore()
return True
Methods for reading and writing specific information to the project file can also be added
def readXml(self, node):
pass
def writeXml(self, node, doc):
pass
When loading a project containing such a layer, a factory class is needed
class WatermarkPluginLayerType(QgsPluginLayerType):
def __init__(self):
QgsPluginLayerType.__init__(self, WatermarkPluginLayer.LAYER_TYPE)
def createLayer(self):
return WatermarkPluginLayer()
You can also add code for displaying custom information in the layer properties
def showLayerProperties(self, layer):
pass