MANUAL DE UTILIZAÇÃO DO PLUGIN GERADOR DE - DPI
Contents
1. 2 vp Gerador de plug ins do Ter Informa o do plug in Nome HelloWorld Descri o rimeiro plug in do TerraView Nome da classe HWPlugin Localiza o g srralib terraViewPlugins Informa o do vendedor Nome Fulano de tal Homepage http algumahome com br Email fulanodetalSteste com br Cancelar Com os par metros preenchidos clique no bot o Ok Uma mensagem de sucesso dever ser exibida Pronto O esqueleto do plug in j foi gerado A princ pio o projeto para Linux mas poss vel e muito simples convert lo para Windows As instru es para convers o em projeto Windows s o escritas junto com o projeto do plug in como coment rios Essas instru es ser o explicadas nas pr ximas sess es deste tutorial Uma vez executado o plug in de cria o ser criada a seguinte estrutura de diret rios Ver Ir Marcadores Abas Ajuda 2 e p E a Acima Aaral Recarregar In cio Computador Pesquisa o mntihgfs Dffuncatejtview dll plugins terralib terraViewPlugins m Nome b ete Ii v EM v EM v EM v e ES base Ea celulas Ea Disolve ES EDA Ea ExtemalTheme ES FileTheme ga fillcell ES Flow Es geodma HelloWorld v E include helloworidPlugin h helloworldPluginCode h helloworldPlugin cpp helloworldPluginCode cpp E HelloWorid pro E Hidro E mercado Ea Mosaic E openModellerTV E3 oracleSpatialAdapter Ea plugin2. 26 27 E Nbrief Finalizer method CONE 29 void end 30 31 protected slots 33 void execPlugin o 35 O fendif HELLOWORLD PLUGIN H A linha 33 mostra a defini o do novo slot Qt Agora precisamos implementar a classe de plug in de forma a inserir a op o no menu do TerraView e conect lo ao novo slot criado Para isso insira no arquivo de implementa o do plug in que neste exemplo helloworldPlugin cpp as linhas necess rias para que o arquivo se pare a com o seguinte 1 include lt helloworldPlugin h gt 2 V Qt include files include lt qmessagebox h gt HWPlugin HWPlugin PluginParameters params 6 Qobject TViewAbstractPlugin params 8 Ol 9 loadTranslationFiles helloworld 12 HWPlugin HWPlugin W end IAUN e 0 void HWPlugin init Bl 19 TerraViewBase tview getMainWindow 21 if tview 25 23 QPopupMenu mnu getPluginsMenu 24 25 if mnu 0 26 E 7 mnu gt insertItem tr Hello World plug in this SLOT execPlugin 28 DoR 30 E 31 32 void HWPlugin end 33 El 34 L 36 void HWPlugin execPlugin 371 3 TerraViewBase tview getMainWindow 40 if tview 41 QMessageBox information tview tr Hello world plug in 42 tr Hello world plug in works fine 43 O m todo init ser implementado de forma
3. a inserir uma op o no menu Plugins do TerraView com o texto Hello World plug in Esse c digo pode ser verificado nas linhas 19 a 29 da imagem anterior Esse c digo insere uma entrada no menu de plug ins do TerraView que quando clicada chama o slot criado execPlugin A fun o execPlugin apenas apresenta uma mensagem na tela e pode ser verificada nas linhas 38 a 42 da figura anterior Feito isso s compilar o plug in e executar o TerraView para ver o novo plug in funcionando Note que existe no projeto arquivo pro uma defini o para 8 gerar o arquivo de tradu o do at Esse arquivo usado para internacionaliza o do software pelo qt Esse arquivo ser usado pelo plug in se ele estiver dispon vel Para disponibiliz lo copie o arquivo gerado pelo QLinguist ver manual do Qt para informa es sobre internacionaliza o para dentro do diret rio de plug ins do TerraView onde o plug in so no caso do Linux dilno caso do windows est localizado Criando o projeto Windows As regras para gera o dos projetos Windows s o escritas como coment rios no arquivo de projeto A imagem a seguir mostra o coment rio If you want to create a visual studio project use the commmand qmake t vclib spec win32 msvc net For debug version add the expression TE PROJECT TYPE DEBUG to previous command include base base pro 5 TARGET HelloWorld TEMPLATE lib LANGUAGE Ct 9 TRANSLATIONS hellowor
4. plug in a ser gerado A figura a seguir apresenta a interface 4 Gerador de plug ins do Ter Informa o do plug in Nome Descri o Isto um teste Nome da classe TPLGPlugin Localiza o Informa o do vendedor Nome frederico bede Homepage funcateDorg br Email frederico bede Ofuncate org 46 Cancelar Os n meros apresentados direita dentro de um c rculo vermelho ser o usados para identifica o e explica o dos par metros que devem ser fornecidos pelo desenvolvedor Os quatro primeiros par metros s o relacionados ao plug in e os outros ao desenvolvedor Os par metros s o os seguintes 6 Nome nome do plug in Esse nome ser dado pasta que cont m o plug in ao projeto e ser prefixo dos nomes dos arquivos de inicializa o do plug in Descri o cont m uma breve descri o do plug in Nome da classe nome da classe de plug in Esse nome ser prefixo dos nomes dos arquivos de defini o e implementa o da classe de plug in Localiza o diret rio onde ser gerado o plug in Note que esse diret rio deve ser corresponder ao diret rio terraViewPlugins contido na pasta terralib onde o desenvolvedor baixou o c digo fonte da TerraLib TerraView Clique no bot o e selecione o diret rio Nome nome do desenvolvedor Homepage homepage do desenvolvedor Email email do desenvolvedor Todos os par metros devem ser fornecidos Lembrando que a loca
5. ser o usados na compila o do projeto C e Cabe alho do arquivo de inicializa o do plug in cont m defini es de duas fun es que ser o usadas pelo plug in inicializa o na carga do plug in e finaliza o na destrui o do plug in Al m disso cont m os par metros do plug in como seu nome desenvolvedor vers o homepage e etc e C digo do arquivo de inicializa o do plug in implementa o das fun es de inicializa o e finaliza o do plug in A implementa o dessas fun es padr o para todos os plug ins a inicializa o instancia um objeto de plug in e a finaliza o o destr i e Cabe alho do arquivo da classe de plug in cont m a defini o da classe de plug in Esta classe herda de uma outra contida no TerraView chamada TeAbstractPlugin e da classe QObject para que se possa registrar slots Qt e us los no plug in A classe de plug in cont m dois m todos que devem ser implementados init e end Essas fun es ser o chamadas durante a inicializa o e destrui o do plug in respectivamente e Arquivo de c digo da classe plug in cont m a implementa o da classe do plug in Os m todos init e end dever o ser codificados para inicializar e finalizar o plug in respectivamente O plug in de cria o de plug ins do TerraView O plug in de cria o de plug ins composto de uma interface simples que disponibiliza ao desenvolvedor uma interface para entrada de dados do
6. Generator ES spatialStat Ea Union E3 wmsclient Makefile Essa a estrutura do diret rio terraViewPlugins com o novo plug in criado Note que foram criados a pasta HelloWorld o projeto HelloWorld pro as subpastas include com dois arquivos de cabe alho e t src com dois arquivos de implementa o Os cinco arquivos mencionados no inicio do tutorial est o divididos nas subpastas Isso j suficiente para compilar os arquivos do plug in O pr ximo passo ser inserir um item no menu de plug ins do TerraView Inserindo funcionalidades no plug in Para esse exemplo construiremos um plug in simples que somente apresenta uma mensagem de boas vindas quando for executado Para isso abra o arquivo helloworldPlugin n que existe na subpasta include Defina um novo slot Qt na classe de plug in chamado execPlugin O arquivo se parecer com o seguinte 1 tifndef HELLOWORLD PLUGIN H 2 define _HELLOWORLD PLUGIN H 4 ginclude lt TViewAbstractPlugin h gt 5 6 Qt include files 7 tinclude lt qobject h gt 9 class HWPlugin public Qobject public TVviewAbstractPlugin do El qa Q OBJECT 12 3 public 14 O brief Constructor 5 param params Plugin parameters DONE 17 HwPlugin PluginParameters params 18 19 O Nbrief Destructor CURE 21 HWPlugin 23 E Nbrief Initializer method Za 25 void init
7. MANUAL DE UTILIZA O DO PLUGIN GERADOR DE PLUGINS DO TERRAVIEW Vers o TerraLib TerraView 3 6 0 Introdu o O plug in de cria o de plug ins do TerraView foi desenvolvido para auxiliar os programadores TerraView TerraLib na constru o de plug ins do TerraView A constru o de plug ins cont m alguns passos comuns a todos os plug ins desenvolvidos Essa parte burocr tica consiste na escrita do projeto do plug in e de alguns arquivos que precisam ser escritos para que o plug in funcione Esses passos foram automatizados pelo plug in de cria o de plug ins de forma que o desenvolvedor se preocupe apenas com a implementa o das funcionalidades Esse manual detalha a cria o de plug ins usando o plug in de cria o de plug ins Nas pr ximas sess es ser o apresentados os arquivos gerados por este plug in o manual de uso do plug in de plug ins e um exemplo de constru o de um plug in usando o plug in de cria o Os arquivos gerados Para o desenvolvimento de plug ins primeiramente s o necess rios no m nimo cinco arquivos o arquivo de projeto arquivos de cabe alho e c digo de inicializa o do plug in 2 arquivos de cabe alho e c digo da classe de plug in 2 A seguir ser o explicados cada arquivo listado e sua funcionalidade e Projeto do plug in cont m as defini es de um projeto de biblioteca de software do Qt pro Esse arquivo cont m defini es dos projetos como arquivos e flags que
8. ld pt ts 1 UI DIR src ui 11 MOC_DIR src moc 12 INCLUDEPATH include 3 HEADERS include helloworldPlugin h 14 include helloworldPluginCode h 15 SOURCES src helloworldPlugin cpp 1 src helloworldPluginCode cpp FORMS O destaque para um coment rio que vem no arquivo de projeto do plug in gerado S o instru es para cria o do projeto Windows Para realiz lo basta abrir uma janela prompt entrar no diret rio onde se localiza o arquivo de projeto do plug in para este exemplo o arquivo o HelloWorld pro e digitar o comando qmake t velib spec win32 msvc net Esse comando cria um projeto do visual Studio com configura es de release Se for necess ria a vers o debug basta acrescentar ao final do comando anterior a express o TE PROJECT TYPE DEBUG Depois disso s abrir o arquivo vcproj gerado usando o visual Studio compilar e rodar o plug in Essa rotina de gera o do projeto Windows pode ser disparada tanto do Windows quanto do Linux
9. liza o deve ser o diret rio terraViewPlugins contido na pasta terralib baixada pelo desenvolvedor Os par metros de informa o do vendedor podem ser preenchidos com valores n o v lidos ou seja uma homepage que n o existe ou email que n o existe etc Esses par metros s o apenas informativos e n o causam impacto algum sobre o desenvolvimento do plug in Criando um plug in Nesta sess o ser criado um plug in HelloWorld mostrando como usar o plug in de cria o do TerraView Primeiramente o desenvolvedor deve baixar a TerraLib do reposit rio do INPE dentro de uma pasta qualquer no sistema Instru es para acesso e obten o da TerraLib podem ser encontradas na p gina principal da Terralib em http www dpi inpe br terralib Depois de compilados terraView e plug in de cria o devemos executar o plug in de cria o Para execut lo v em Plugins no menu principal do TerraView e selecione a op o de Criar plug in do TerraView como mostrado na figura abaixo amp Arquivo Exibir Plano Vista Tema An lise Opera o Bull Ajuda Srv TOPO mM Yu a ds Criar plug in do TerraView EE Bancos de Dados O Vistas Temas A tela de cria o de plug ins ser exibida preencha os par metros de cria o conforme mostrados na figura a seguir Lembrando que o plug in deve ser criado sob a pasta terraViewPlugins dentro da pasta terralib conforme j falado
Download Pdf Manuals
Related Search