O plugin é um script prisma podendo ser ou não compilado.
Ele passa uma tabela com valores e uma função, possui um elemento rotulo que é o texto a ser mostrado no menu ferramentas do prismacod.
Vamos criar um plugin bem básico, veja o código:
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 |
retorne {// tabela plugin de retorno nome = 'plugin minimo' ; //nome do plugin para mensagem de erro rotulo = 'minimo' ; //texto que aparecera no menu->ferramentas func = funcao() ig.msg( nulo , 'Plugin minimo' , 'Plugin minimo executado' ); fim } //fim tabela plugin de retorno //nao esqueca que é necessario registrar o plugin no arquivo //plugin_registro.prisma para funcionar; |
Salve com o nome minimo.prisma, coloque-o no diretório padrão de plugins do prismacod:
Linux: /usr/local/share/prisacod/plugins/
(No Linux, precisa abrir o explorador de arquivos em modo sudo, ex: sudo nautilus ou sudo caja no Mint. para copiar com privilégios o seu plugin para a pasta do prismacod.
Use o terminal se preferir:
sudo cp caminho/do/meu_plugin.prisma /usr/local/share/prismacod/plugins/
coloque a senha e pressione enter. ) Pode criar uma pasta se quiser, exemplo testes/
Windows = Prisma/1.0/bin/prismacod_/plugins/
Após salvar no diretório de plugins, no mesmo local tem um arquivo chamado ‘plugin_registro.prisma’ , é necessário registrar o nome de seu plugin nele para que tenha efeito no prismacod, nesta parte do arquivo:
|
1 2 3 4 5 6 7 8 9 10 11 |
local _Nome_plugins = { 'exemplos/template_plugin.prisma' , //'mudar_tema/inic.prisma' 'exemplos/minimo.prisma' , //um pequeno teste para ver a base de criacao de plugins //'exemplos/abre_registro.prisma' , //abre o arquivo plugin_registro.prisma } //fim tabela de nome dos plugins |
Lembrando que é necessário estar no modo super usuário em Linux para alterar o arquivo.
(Você pode digitar o comando no terminal: sudo prismacod;)
Vou ver se eu faço um plugin para abrir o prismacod em sudo no linux e colocar a atualização. <aqui>
Caso haja erro no plugin não interromperá o prismacod, apenas surgirá uma mensagem.
O plugin é como um segundo programa, é ilimitado, pode criar quantas novas janelas quiser na função principal do plugin, só não pode usar o fimprograma() pois este comando já é usado no prismacod não podendo ser duplicado, também, se não conecte o método sair na janela do plugin, nem use o ig.janela_destrua( ) nele pois caso o faça, ao fechar o plugin o prismacod será encerrado junto.
Obs.: não se esqueça de separar os elementos da tabela de retorno com vírgulas ou ponto-e-vírgulas.
Note que é simples, basta escrever retorne e abrir uma chave, colocar os elementos e fechar a chave.
Os elementos podem ser:
nome – (string) um nome para o plugin a ser mostrado na mensagem de erro caso o tenha.
rotulo – (string) é o nome que aparecerá no menu ferramentas do prismacod
func – (funcao) a função que será executada ao clicar no nome do plugin no menu ferramentas.
A função pode ser criada antes do ‘retorne’ e apenas ser associada ao nome dentro da tabela, assim:
func = execute_plugin; //por exemplo.
Abaixo outro código de plugin para estudos:
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 |
//template_plugin teste de plugin by Adalberto Amorim Felipe //uma funcao local para reponder ao botao local FUNC_BOTAO = funcao(wid , jan) //para acessar o editor use com muito cuidado a variavel _Editor_ . local txt = ig.texto_area_obt_texto ( _Editor_ ) ou 'nao tem texto' ; ig.msg( jan , 'Botao' , txt ); fim //fim funcao //essa funcao será passada como func dentro da tabela de retorno local execute_plugin = funcao(dado_extra) imprima( dado_extra); local jan = ig.janela('teste de plugin',400 , 250 ); ig.janela_def_icone_arquivo( jan , _Pasta_plugins_ .. 'exemplos\\logo.jpg' ); local fixo = ig.fixo(); ig.ad( jan , fixo); local bt = ig.botao'clique me'; ig.fixo_ad( fixo , bt , 10 , 29 ); local img = ig.imagem_arquivo( _Pasta_plugins_ .. 'exemplos\\logo.jpg' ); ig.fixo_ad( fixo , img , 90 , 20); ig.conecte_funcao( bt , ig.clique , FUNC_BOTAO , jan ); //nao passamos dado extra para call back do botao ig.janela_def_posicao( jan , ig.janela_pos_centro); ig.componente_mostre_todos( jan ); fim //separe por virgula cada item do plugin: //tabela de retorno do plugin retorne { nome = 'exemplo template_plugin.prisma' , //nome do plugin que aparece caso haja mensagem de erro rotulo = 'teste de plugin' , //o texto que irá aparecer no menu estoque = ig.estoque_ok , //imagem do estoque que aparecera no menu, No Ubuntu nao é visível devido ao tema //nao esqueca das virgulas, tecla_atalho = ig_y , // a tecla de atalho que aparecera no menu Y tecla_modo = ig.mascara_control , //atalho para tecla control -> CTRL + Y func = execute_plugin , //passando a funcao principal do plugin dado_extra = 'O plugin executado com sucesso' } //fim plugin |
Observe que aqui foram introduzidos novos componentes à tabela de retorno do plugin:
estoque = imagem de estoque para o menu
tecla_atalho = pode ser de ig_a até ig_z
tecla_modo = caso queira um atalho do tipo CTRL + A
use: tecla_atalho = ig_a ;
tecla_modo = ig.mascara_control ;
temos também um dado extra para a função principal do plugin:
dado_extra = dado (pode ser qualquer tipo, até nulo );
Abaixo o código do plugin de mudar tema que eu fiz, por enquanto só para Windows:
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 |
//plugin para mudar o tema do gtk dir = inclua'igdir'; //funcao principal do plugin: local plugin_execute = funcao() local temadir = string.troque ( prismadir , 'bin' , 'share\\themes' ); imprima(temadir); local tema = dir.liste_arquivos( temadir ); //listando os diretorios cujo nome é o comando de mudar o tema //o arquivo que é reponsavel por mudar o tema é C:\Prisma\BR\etc\gtk-2.0\gtkrc //sem extensão mesmo só gtkrc //alterando o conteúdo dele podemos mudar o tema do gtk local conf_tema_dir = string.troque ( prismadir , "bin" , 'etc\\gtk-2.0\\' ) ; //ainda nao entendi por que depois da bin tem trẽs barras, mas vou consertar futuramente. local conf_tema_dir = conf_tema_dir .. 'gtkrc'; imprima( conf_tema_dir ); local arq = es.abra(conf_tema_dir , 'leitura' ); tema_definido = arq:leia('*t' ); //lê tudo arq:feche() ; //fechando o arquivo. //note que para ler e fechar precisamos usar os dois pontos, ok //o conteúdo será algo como: gtk-theme-name = "MS-Windows" //temos que processar para extrair somente o que esta entre aspas, //usaremos o string.sub percorrendo todos os caracteres local aspa_inicial = 0; local aspa_final = 0; para i = 1 , #tema_definido inicio //a funcao string.sub extrai uma sub string de outra maior //sua sintaxe é : string.sub ( string_maior , pos_x , pos_y ); //onde pos_x e pos_y é o número que indica o inicio e o fim da substring dentro //da maior: local c = string.sub ( tema_definido , i , i ); se c == '"' entao //quando chega na aspa ele testa outra condição: se aspa_inicial == 0 entao //se aspa_inicial ainda é zero entao é a primeira aspa. aspa_inicial = i senao //senao for zero, é porque já tem outro valor entao é a vez do aspa_final aspa_final = i fim fim fim //fim para //ja sabemos a posicao das duas aspas, basta usar outra vez string.sub //mas com a posical que está entre as aspas //para isso somo 1 na primeira aspa e diminuo 1 da ultima aspa //e aí tenho a posição entre elas, veja: local Texto_definido = string.sub( tema_definido , aspa_inicial + 1 , aspa_final - 1 ) ; //criando a janela: local janela = ig.janela( ig.janela_semborda ); local cor_jan = ig.cor_analise( ig.ouro ); ig.componente_modifique_corfundo( janela , ig.estado_normal , cor_jan ); ig.janela_def_titulo ( janela , 'Mudar Tema Gtk' ); ig.janela_def_opacidade( janela , 0.9 ); //90% de opacidade ig.janela_def_posicao( janela , ig.janela_pos_centro ); ig.caixa_def_borda_largura ( janela , 20 ); local caixav = ig.caixavertical (falso , 2 ); //criando uma caixa vertical para organizar verticalmente os componentes ig.ad( janela , caixav); //colocando a caixa vertical na janela ig.caixa_ad ( caixav , ig.rotulo '\nEscolha um tema do combo:\n' , falso , falso , 2 ); //criando o combo combo box local Texto_padrao = 'padrao'; local combo = ig.caixa_combo_(Texto_definido ); ig.caixa_combo_anexe_texto( combo , Texto_padrao ); para i = 1 , #tema inicio se tema[i] <> '.' e tema[i] <> '..' entao //deixando de fora o ponto e os dois pontos ig.caixa_combo_anexe_texto ( combo , tema[i] ); fim fim //fim para ig.caixa_ad( caixav , combo , falso , falso , 2 ); //colocando combo na caixa vertical ig.caixa_ad ( caixav , ig.rotulo '\n\nÉ necessário reiniciar os programas para ver o efeito\n' , falso , falso , 2 ); funcao mude_tema ( wid , jan ) local selecionado = ig.caixa_combo_obt_texto_ativo ( combo ) ; //obtendo o texto atual do combo se selecionado == 'padrao' entao selecionado = 'MS-Windows' fim //garantindo que o tema windows seja o padrao //bom, a linha deve ser assim : gtk-theme-name = "nometema" //entao vamos montar essa linha: local grava_selecionado = "gtk-theme-name = " .. "\"" .. selecionado .. "\"" //vamos gravar no arquivo agora: local arq = es.abra( conf_tema_dir , 'escrita' ) ; //abrindo arquivo em modo escita arq:escreva ( grava_selecionado ); arq:feche(); imprima( 'mudado: ' .. selecionado ); ig.componente_destrua( jan ); fim //fim funcao mude tema local bt_ok = ig.botao_estoque( ig.estoque_ok); ig.caixa_ad( caixav , bt_ok , falso , falso , 2 ); ig.conecte_funcao ( bt_ok , ig.clique , mude_tema , janela ); local bt_cancelar = ig.botao_estoque( ig.estoque_cancelar); ig.caixa_ad( caixav , bt_cancelar , falso , falso , 2 ); ig.conecte_permutado ( bt_cancelar , ig.clique , ig.componente_destrua , janela ); ig.componente_mostre_todos( janela ); fim //fim funcao plugin_execute //tabela de retorno do plugin retorne { nome = 'Mudar tema gtk' ; estoque = ig.estoque_selecionar_cor ; rotulo = "Mudar tema do gtk" ; func = plugin_execute ; } //fim tabela de retorno do plugin |