Scripts

Os scripts do PixPin usam JavaScript para aceder a capturas, pins e operações de janelas. Pode guardar passos repetidos numa ação e acioná-la por atalho, menu da bandeja ou linha de comandos. «Scripts» é uma secção explicativa do manual; no software, o editor encontra-se em Configuração → Atalhos/Ações.

Quando usar scriptsCopy Anchor Link

Para apenas mudar um atalho, ajustar uma entrada da bandeja ou evitar um programa, utilize as Definições de atalhos/ações. Os scripts são adequados para combinar operações ou especificar parâmetros.

Criar e executar o primeiro scriptCopy Anchor Link

pixpin.screenShot(ShotAction.Pin);

O teste executa realmente o script. Escolher outra predefinição substitui o conteúdo do editor e cancelar a janela não desfaz as operações já testadas. Os scripts das ações integradas não podem ser alterados; crie uma ação personalizada para obter uma variante.

Executar pela linha de comandosCopy Anchor Link

Coloque o texto do script depois de -r e o caminho do ficheiro depois de -f. Se o PixPin já estiver em execução, o pedido é entregue à instância existente; no primeiro arranque, aguarda a inicialização antes de executar.

Windows PowerShell: substitua o caminho pelo local real de instalação:

& 'D:/Apps/PixPin/PixPin.exe' -r 'pixpin.screenShot(ShotAction.Copy);'
& 'D:/Apps/PixPin/PixPin.exe' -f 'D:/Scripts/capture.js'

Terminal do macOS: o exemplo assume a instalação na pasta Aplicações:

"/Applications/PixPin.app/Contents/MacOS/PixPin" -r 'pixpin.screenShot(ShotAction.Copy);'
"/Applications/PixPin.app/Contents/MacOS/PixPin" -f '/Users/yourname/Scripts/capture.js'

Escreva apenas JavaScript no ficheiro, sem delimitadores de blocos de código; se contiver chinês, recomenda-se UTF-8 com BOM. Prefira -f para scripts longos para reduzir problemas de escape de aspas, barras invertidas e $. Mantenha as aspas exteriores nos caminhos com espaços.

O regresso da linha de comandos não significa que a captura, o reconhecimento ou a gravação tenha terminado; esta entrada também não devolve ao chamador o valor da última linha como resultado estruturado. No macOS, a automatização não abre automaticamente a orientação de permissões para capturas interativas; conceda primeiro as permissões de gravação do ecrã e acessibilidade dentro do software.

Sintaxe suportada e execuçãoCopy Anchor Link

O editor aceita JavaScript. Os nomes de interfaces e constantes distinguem maiúsculas de minúsculas: escreva pixpin.screenShot, não pixpin.screenshot.

O ambiente de scripts desta versão não suporta encadeamento opcional ?. nem async/await, e não permite import / export nos scripts comuns. Use if para verificar valores nulos e as interfaces do PixPin para operações por etapas.

Não existem window, document ou fetch do navegador, nem require, process ou fs do Node.js; setTimeout também não é disponibilizado. Não cole exemplos que dependam de páginas web, Node.js ou pacotes de terceiros. Suportar objetos também não significa que um objeto comum substitua o retângulo exigido por uma interface.

Execução sequencial sem esperar por operações manuaisCopy Anchor Link

As instruções JavaScript são executadas por ordem, mas uma chamada que abre a janela de captura apenas inicia a operação, sem esperar que conclua a seleção. Para «capturar e afixar», escreva diretamente pixpin.screenShot(ShotAction.Pin); não coloque simplesmente o início da captura e a afixação da área de transferência em duas linhas sucessivas.

O motor de scripts é reutilizado. Coloque as variáveis temporárias dentro de funções para evitar interferências entre execuções. Os exemplos de várias linhas deste artigo usam uma função executada imediatamente:

(function () {
  var width = 640;
  var height = 480;
  var rect = pixpin.genRectUnderCursor(width, height);
  pixpin.directScreenShot(rect, ShotAction.Copy);
})();

O () no fim da função executa-a imediatamente. Não utilize um ciclo infinito para esperar pelo fim da captura, pois bloqueia a execução da interface. Pode usar console.log(...) para registos, mas a janela de edição não tem uma consola interativa.

Objetos globais, parâmetros e valores devolvidosCopy Anchor Link

Introduza diretamente números, booleanos e cadeias; utilize matrizes de cadeias para listas de ficheiros. Prefira caminhos absolutos. Em JavaScript, pode escrever D:/Images/example.png ou, com barras invertidas, D:\\Images\\example.png.

Gere os retângulos com uma das três interfaces seguintes e passe-os sem alterações às interfaces posteriores:

As coordenadas e dimensões são coordenadas lógicas do ecrã; a largura e a altura devem ser positivas e as coordenadas podem ser negativas em vários ecrãs. Se faltar espaço junto ao rato, genRectUnderCursor reduz a área proporcionalmente para caber no ecrã. A escala do ecrã e as definições de gravação também afetam as dimensões em píxeis da imagem exportada. Não passe {x: 100, y: 100, width: 640, height: 480} diretamente a uma interface que exige um retângulo: esses campos não geram uma área de captura.

O valor true significa normalmente que o pedido foi aceite, não que o utilizador concluiu a interação; consulte as tabelas seguintes para o significado de cada valor devolvido. Interfaces sem valor devolvido não permitem determinar se a gravação teve êxito.

Exemplos prontos a adaptarCopy Anchor Link

Capturar e copiar a janela ativaCopy Anchor Link

Coloque primeiro o programa pretendido em primeiro plano e acione esta ação com um atalho global. A captura é imediata, sem seleção manual.

pixpin.directScreenShotSpRect(
  PixConst.SpRectActiveWindow,
  ShotAction.Copy
);

Ao clicar em Testar Script no editor, a janela ativa poderá ser a das definições; para avaliar o resultado, aplique a ação e acione-a a partir do programa pretendido.

Fixar a seleção e ajustá-la manualmenteCopy Anchor Link

Inicie uma captura normal e defina a seleção na posição (100, 100), com tamanho 640 × 480. Pode continuar a anotar na barra de ferramentas ou ajustar a seleção.

(function () {
  if (pixpin.screenShotAndEdit()) {
    pixpin.setScreenShotRect(100, 100, 640, 480);
    pixpin.setScreenShotRectRadius(4 / 3);
  }
})();

O nome setScreenShotRectRadius pode induzir em erro: define a proporção, não o raio dos cantos. Elimine a última linha se não pretender uma proporção fixa.

Capturar diretamente e guardar com a hora no nomeCopy Anchor Link

Este exemplo captura diretamente o ecrã sob o rato. Substitua o caminho pela sua pasta antes de executar; no macOS, pode utilizar um caminho como /Users/yourname/Pictures/....

(function () {
  var rect = pixpin.getSpRect(PixConst.SpRectScreenUnderMouse);
  pixpin.directScreenShotAndSaveTo(
    rect,
    "D:/Captures/PixPin_$yyyy-MM-dd_HH-mm-ss$.png"
  );
})();

A função de gravação expande as variáveis de tempo; consulte Variáveis de caminhos e nomes de ficheiros. Se já existir um ficheiro com o mesmo nome, a interface acrescenta um sufixo numérico e não mostra uma notificação. Não devolve o caminho guardado nem um indicador de êxito.

Afixar vários ficheiros de referência de uma vezCopy Anchor Link

Substitua os caminhos da matriz por ficheiros existentes. Pode continuar a adicionar entradas no mesmo formato.

(function () {
  var files = [
    "D:/Reference/layout.png",
    "D:/Reference/colors.png"
  ];
  if (!pixpin.pinFromFiles(files)) {
    throw new Error("没有找到可贴出的文件，请检查路径。");
  }
})();

A interface ignora ficheiros inexistentes e devolve false se a matriz estiver vazia ou nenhum caminho existir. true indica que os ficheiros existentes foram entregues à função de afixação, sem garantir que todos os formatos possam ser apresentados como imagens.

Esperar três segundos e iniciar uma capturaCopy Anchor Link

A forma mais simples mostra uma contagem decrescente que pode cancelar:

pixpin.delayScreenShotWithTips(3);

Para definir a posição e as dimensões, use a interface seguinte. Os parâmetros são, por ordem: segundos, especificar posição, coordenada horizontal, coordenada vertical, especificar dimensões, largura, altura, parâmetro reservado e proporção.

pixpin.delayScreenShot(3, true, 100, 100, true, 640, 480, 0, 4 / 3);

Alternar o estado com a mesma açãoCopy Anchor Link

O exemplo seguinte inverte o estado de desativação atual: suspende os restantes atalhos globais quando estão ativos e recupera-os na execução seguinte.

pixpin.disableShortcuts(!pixpin.isDisableShortcuts());

A tecla desta ação permite sair desta desativação manual; continua, porém, sujeita à lista de programas ignorados e ao estado de jogo em ecrã inteiro do Windows.

Referência rápida das interfaces personalizadasCopy Anchor Link

Seguem-se as interfaces de operações do utilizador disponíveis nos scripts de ações comuns. rect deve vir das interfaces de geração de áreas e action utiliza ShotAction. Os parênteses retos indicam parâmetros opcionais e não se escrevem no código real.

Capturas e áreasCopy Anchor Link

A tabela omite o prefixo repetido pixpin.; a chamada real é, por exemplo, pixpin.screenShotAndCopy(). A captura direta não abre os editores ou gravadores correspondentes se passar Edit, ImageEdit, LongShot ou GifShot; para esses processos interativos, use screenShot(action) ou as interfaces específicas seguintes.

Atraso, captura longa e gravação do ecrãCopy Anchor Link

Em delayScreenShot, se hasPos e hasSize forem true, é usado o retângulo indicado; se apenas hasSize for true, a área com as dimensões indicadas é gerada junto ao rato. Sem dimensões, mantém-se a seleção manual. radius não é utilizado atualmente: indique 0. Um ratio positivo define a proporção; use -1 se não for necessária.

Estas interfaces abrem ou controlam janelas; não significam que o deslocamento automático terminou ou que o vídeo foi exportado. As operações seguintes de captura longa e gravação continuam nas respetivas interfaces.

Pins e gestão em loteCopy Anchor Link

Comandos do sistema e outras operaçõesCopy Anchor Link

runSystem e runSystemSync iniciam programas diretamente, sem passar automaticamente por um interpretador de terminal. Encadeamentos, redirecionamentos e comandos internos da shell não funcionam automaticamente; indique explicitamente o interpretador da plataforma se forem necessários. A cadeia do comando não pode estar vazia.

Por exemplo, pode abrir a calculadora com pixpin.runSystem("calc") no Windows ou pixpin.runSystem("/usr/bin/open -a Calculator") no macOS. O exemplo seguinte lê o resultado de um comando síncrono; substitua-o por um programa existente no sistema atual:

(function () {
  var result = pixpin.runSystemSync("cmd /c ver"); // Windows 示例
  console.log(result.code, result.output, result.error);
})();

A espera síncrona ocupa temporariamente a interface do PixPin. A implementação atual tem um limite de espera predefinido de cerca de 30 segundos, sem um campo separado de «tempo esgotado»; code, por si só, também não permite saber se o processo arrancou corretamente. Use runSystem para regressar imediatamente.

Constantes de áreas e açõesCopy Anchor Link

PixConst: o que capturarCopy Anchor Link

A área depende das janelas, do rato e do histórico no momento da execução. Não assuma que existe uma área utilizável sem janela ou histórico válidos.

ShotAction: o que fazer após selecionarCopy Anchor Link

Todas as formas seguintes usam o prefixo ShotAction., por exemplo ShotAction.QuickSave.

As constantes apenas escolhem funcionalidades existentes e não alteram as suas condições. Copiar, guardar e reconhecer podem continuar a depender das definições atuais ou de janelas interativas.

O que verificar em caso de erroCopy Anchor Link

Pode capturar erros de script com try / catch, mas devolver false ou não devolver valor não lança automaticamente uma exceção. Ao depurar, execute uma operação e acrescente gradualmente parâmetros e passos; a ausência de erros não prova que todos os resultados estejam concluídos.

Artigos relacionadosCopy Anchor Link