Colocando mensagens no Script Output

1 - Salve este script. Deszipe, salve o script na pasta Script Restricted. Abra-o pelo Text Editor. Verá apenas os comandos, todos em linguagem esquisita. É a Python, linguagem que usamos para mostrar ao PSP o que queremos que ele faça. Leia os comandos, procurando decifrá-los, não é difícil. Vá baixando a página. A primeira mensagem é a mudança da cor do efeito Blinds. Veja também a mensagem para o plugin. O script não grava os settings dos plugins, apenas a configuração default, isto é a original. Veja que coloquei aí a configuração, em linguagem quase "normal". Ela aparecerá no Script Output, orientando como deverá configurar o plugin, na hora de rodar o script

Claro, vc já abriu outros scripts e sabe que cada comando tem um código. As mensagens não são comandos, são simplesmente mensagens, por isso, dever vir em palavras que você possa entender. Esse tipo de mensagem que você vê neste script é a que aparece no Script Output, impressa.

Há aquelas que abrem um popup e que se iniciam por um comando, mas a mensagem apenas faz parte do comando, ela mesma não é comando.

Esse tipo de mensagem, que aparece dentro do Script Output, é ótima para você transmitir as instruções para plugins ou comandos e é muito fácil de ser colocada:

1) Dê quatro espaços, usando a barra de espaços de seu teclado.
2) Digite a palavra print.
3) Vá para a outra linha. Dê novamente os 4 espaços, digite print.
4) Dê um espaço. Abra aspas, escreva a mensagem, feche aspas.
5) Outra linha, quatro espaços, digite print, novamente

Ficará assim:
    print
    print " Mova a imagem."
    print

Também poderá colocar aspas no primeiro e no último print. Muitas vezes encontrará as mensagens assim:

    print " "
    print " Mova a imagem."
    print " "

Esse é o formato para mensagens. É muito importante que pule 4 espaços, antes de digitar, pois a linguagem Python tem essa necessidade absoluta.

As mensagens sempre devem estar colocadas antes antes do comando a que se refere.

Procure não utilizar sinais como =, /, ; , º, #, aspas e outros sinais que podem dar erros no script por serem utilizados por ele em outras situações.

2 - Grave um script com plugins, utilize o comando para instruir o usuário o que deve fazer. Coloque uma mensagem tipo print no final de seu script agradecendo quem está utilizando seu script, mais ou menos isso:

    print
    print " Obrigada por testar meu script. Seu Nome."
    print

Se houver usado plugins, coloque a mensagem para os settings:

    print
    print " Settings para o plugin (nome do plugin)"
    print " angulo 255"
    print " mode 135"
    print

Não se esqueçam de pular 4 espaços, antes de digitar.

3) Deixe em seu script algumas mensagens do tipo que estão no terceiro tutorial. Elas não aparecerão no script output, apenas serão lidas se alguém abrir o script.

Envie seu script para o grupo. Não esqueça de testá-lo após colocar as mensagens. Quando for rodar um script com mensagens, não se esqueça de, antes, limpar o Script Output. Para isso, abra o script Output, clique com o bltão direito do mouse e escolha "clear". Nunca feche o Script Output ao rodar scripts.

Pegue este arquivo zipado. É um modelo em .txt do print para mensagens. Vocês poderão copiá-lo, voltar ao script, dar 4 espaços e colá-lo. Guarde-o numa pastinha à qual darão o nome de Snippets. Será o primeiro de uma série.

Obs: Qualquer coisa que acrescente ao script que não sejam comandos do próprio PSP, fechará o Script Editor, até o uso de determinados plugins, por isso, antes de colocar mensagens ou o que for, na edição, aproveite as facilidades do Script Editor para colocar ferramentas ou plugins no Interativo, fazer edições, correções, deletar undos, etc.

Acaso isso ocorra com seu script, terá que editá-lo à mão. Para tirar os Undo's, basta selecionar o comando Undo e o comando que você não quer que apareça e deletar os dois. Delete sempre de dois em dois para não se perder, mesmo que sejam muitos e seguidos.
Para passar para o Interactive, é só mudar o ExecutionMode de Default para o Interactive em cada comando que vc quer que abra a janelinha. assim:

# Gaussian Blur
App.Do( Environment, 'GaussianBlur', {
'Radius': 20,
'GeneralSettings': {
'ExecutionMode': App.Constants.ExecutionMode.Default,
'AutoActionMode': App.Constants.AutoActionMode.Match,
'Version': ((9,0,1),1)
}
})

Deletem a palavra Default e escrevam ali Interactive.

ATENÇÃO: O script não aceita palavras parecidas, apenas a palavra correta, com a inicial maiúscula e a vírgula, depois, assim:

# Gaussian Blur
App.Do( Environment, 'GaussianBlur', {
'Radius': 20,
'GeneralSettings': {
'ExecutionMode': App.Constants.ExecutionMode.Interactive,
'AutoActionMode': App.Constants.AutoActionMode.Match,
'Version': ((9,0,1),1)
}
})

O ExecutionMode é sempre a terceira linha, contando de baixo para cima, desprezando-se nessa contagem as chaves e parênteses que fecham os comandos.

Muito fácil, não é?

Script Output Clear

Há ainda outra observação importante:

Quando se vai rodar o script, muitas vezes a mensagem não aparece inteira porque o Script Output vai ficando cheio com mensagens do próprio script que usa uma linha para cada comando que ele executa. Então, usamos um Snippet curtinho que faz com que o Script Output seja apagado, antes de cada mensagem:

    App.Do( Environment, 'ScriptWndClear' )

Eu chamo esse snippet de Limpador de SOP (Script Output). Vc deve escrevê-lo antes das mensagens, assim:

App.Do( Environment, 'ScriptWndClear' )

print
print "Não esqueça de salvar este Snippet"
print

Copie este snippet, cole num Bloco de Notas, depois de dar quatro espaços e salve-o como Clear ou Limpador de SOP, nas pastinha de Snippets que você já deve ter aberto.

Esses e outros snippets eu consegui na lista americana Script - Creations e estão sendo transmitidos a vocês, com autorização de Diane G. Ela gostou muito de saber que eu abriria um grupo brasileiro e espera ansiosamente que alguns de vocês se inscrevam na lista dela, depois de terem aprendido um pouquinho mais.

Há algumas outras opções para mensagens, mas deixaremos isto para depois.

Bom trabalho!