Outdated version of the documentation. Find the latest one here.

Использование слоёв расширений

Если расширение использует собственные методы для отрисовки слоёв карты, наиболее простой способ реализации — создание нового типа слоя на основе QgsPluginLayer.

TODO:
Check correctness and elaborate on good use cases for QgsPluginLayer, ...

Наследование QgsPluginLayer

Ниже показан пример минимальной реализации QgsPluginLayer. Это фрагмент 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

При необходимости можно добавить методы для чтения и записи информации в файл проекта:

def readXml(self, node):

def writeXml(self, node, doc):

Для загрузки проекта, содержащего такой слой, требуется наличие класса:

class WatermarkPluginLayerType(QgsPluginLayerType):

  def __init__(self):
    QgsPluginLayerType.__init__(self, WatermarkPluginLayer.LAYER_TYPE)

  def createLayer(self):
    return WatermarkPluginLayer()

Кроме того, можно добавить код для отображения дополнительной информации в окне свойств слоя:

def showLayerProperties(self, layer):