Pular para o conteúdo principal

Como os scripts são executados

  • Uma thread por disparo. Cada script disparado é executado em uma thread própria, com as suas próprias variáveis e caches de enumeração. Dois gestos disparados em sequência rápida são executados ao mesmo tempo. Um bloqueio nomeado impede que eles intercalem um trabalho compartilhado. Um monitor serial é a exceção: as linhas dele são executadas uma de cada vez, na ordem em que chegaram. A configuração Máximo de ações em execução limita quantos são executados ao mesmo tempo; atingi-la faz o mesmo que a tecla de atalho para parar todas as ações (Configurações de script).
  • Um script pode ficar bloqueado. UtilityWait, caixas de mensagem, um ShellRunProgram que aguarda o programa terminar e as leituras seriais bloqueiam a thread do próprio script, e nada mais. A entrada do mouse e do teclado continua fluindo.
  • Interrupção. EngineStopAllActions() e Parar tudo no console encerram todo script em execução na sua próxima instrução, então um loop infinito sempre pode ser interrompido. As funções internas que aguardam percebem um pedido de interrupção enquanto aguardam: UtilityWait, as esperas de bloqueio e seriais, WindowWaitFor, WindowWaitClose, ClipboardCopySelection, KeyboardTypeText (que para antes do próximo caractere), MacroPlayTemporary, SnippetExecuteScript, AutoHotkeyExecuteScript (que encerra o processo do AutoHotkey), um ShellRunProgram que aguarda o programa terminar (que deixa o programa em execução), ShellShowToast, MultimediaPlayMp3File e UIShowConsole. As demais funções internas, incluindo as caixas de mensagem, terminam a chamada atual antes. A tecla de atalho para parar todas as ações faz o mesmo e também exclui todo temporizador, monitoramento de pasta e monitor serial, e desliga gestos, teclas de atalho e expansão de texto até Recarregar configuração (A tecla de atalho para parar tudo).
  • O que persiste entre execuções:
    • StorageSetValue/StorageGetValue: valores nomeados de qualquer tipo, compartilhados por todos os scripts e mantidos na memória enquanto o mecanismo estiver em execução. StorageGetValue de um nome que nunca foi definido retorna Integer 0. O armazenamento guarda até 1.024 valores, com nomes de até 256 caracteres e Text de até 32.768 caracteres; ultrapassar um limite interrompe a ação com um erro.
    • StorageSetPersistentValue/StorageGetPersistentValue: o mesmo, com os mesmos limites, mas salvo em storage.toml ao lado do arquivo de configuração, para que os valores sobrevivam a uma reinicialização. Um Window não pode ser salvo (um exemplo).
    • Propriedades de janela (WindowSetPropertyInteger/…Text): valores associados a uma janela que desaparecem quando ela é fechada ou quando o Input.Observer sai. Um valor de texto tem no máximo 1.024 caracteres, e até 512 valores de texto podem ser armazenados ao mesmo tempo.
    • Temporizadores nomeados, monitoramentos de pastas e monitores seriais, que o mecanismo mantém em execução depois que o script que os criou termina, até serem excluídos ou a tecla de atalho para parar todas as ações ser pressionada. Recarregar ou salvar a configuração não os encerra; um script de Configuração carregada que cria outro com o mesmo nome o substitui.
  • Scripts passados como Text. TimerCreate, FolderWatchCreate e SerialMonitorCreate recebem um script como argumento Text. Ele é compilado e disparado separadamente a cada vez que é acionado, então tem variáveis novas e não enxerga as variáveis do script que o criou. As aspas dentro dele precisam do escape \"; ou mantenha o script em um snippet e passe SnippetGetScript("name").
  • Contexto. As funções internas Context* descrevem o que disparou a execução atual: o gesto, os seus pontos e o retângulo delimitador, a janela e o controle sob ele, o botão, o evento do monitoramento ou a linha serial. O script de um temporizador não tem contexto de gatilho. O script de um monitoramento de pasta recebe os valores de ContextGetWatch*, e o de um monitor serial recebe os valores de ContextGetSerial*. O script de um evento de roda recebe ContextGetWheelDelta e ContextGetWheelHorizontal, e o de um evento de botão do mouse ou de roda recebe a posição do ponteiro por ContextGetEventX e ContextGetEventY.
  • Snippets são scripts nomeados na configuração. SnippetExecuteScript executa um até o fim antes que o chamador continue, e retorna true somente quando o snippet foi executado até o fim. Ele compartilha o contexto de gatilho do chamador, mas tem as suas próprias variáveis.
  • O Modo de segurança bloqueia todos os scripts, exceto os executados pelo console de diagnóstico.