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

Escrevendo um complemento de processamento

Depending on the kind of plugin that you are going to develop, it might be better option to add its functionality as a Processing algorithm (or a set of them). That would provide a better integration within QGIS, additional functionality (since it can be run in the components of Processing, such as the modeler or the batch processing interface), and a quicker development time (since Processing will take of a large part of the work).

Este documento descreve como criar um novo complemento que adicionar sua funcionalidade como um algoritmo de processamento.

Há dois mecanismos principais para fazer isso:

  • Criando um complemento que adiciona um provedor de algoritmo: Estas opções são mais complexas, mas provém maior flexibilidade

  • Criando um plugin que contém um conjunto de scripts de processamento: na solução mais simples, você só precisa de um conjunto de arquivos de scripts de processamento.

Criando um complemente que adiciona um provedor de algoritmo

Para criar um provedor de algoritmo, siga estes passos:

  • Instale o complemento Plugin Builder

  • Crie um novo complemento usando o Plugin Builder. Quando o Plugin Builder perguntar qual modelo usar, selecione “Processing provider”.

  • The created plugin contains a provider with a single algorithm. Both the provider file and the algorithm file are fully commented and contain information about how to modify the provider and add additional algorithms. Refer to them for more information.

Criando um plugin que contém um conjunto de scripts de processamento

Para criar um conjunto de scripts de processamento, siga estes passos:

  • Crie seus script como descrito no manual PyGIS. Todos os scripts que você deseja adicionar devem ser disponíveis na caixa de Processamento.

  • In the Scripts/Tools group in the Processing toolbox, double-click on the Create script collection plugin item. You will see a window where you should select the scripts to add to the plugin (from the set of available ones in the toolbox), and some additional information needed for the plugin metadata.

  • Clique em OK e o complemento será criado.

  • You can add additional scripts to the plugin by adding scripts python files to the scripts folder in the resulting plugin folder.