Scripts

Les scripts PixPin appellent les fonctions de capture, d'épinglage et de fenêtre en JavaScript. Enregistrez des étapes répétées comme action, puis utilisez raccourci, menu ou ligne de commande. Scripts est un chapitre du manuel ; l'éditeur se trouve dans Configuration → Raccourcis/Actions.

Quand utiliser un scriptCopy Anchor Link

Pour changer une touche, régler le menu ou exclure un programme, utilisez Raccourcis/actions. Les scripts servent à combiner des opérations ou fixer des paramètres.

Créer et lancer un premier scriptCopy Anchor Link

pixpin.screenShot(ShotAction.Pin);

Le test exécute réellement le script. Un autre préréglage remplace le contenu, et Annuler ne défait pas les opérations testées. Les scripts intégrés ne se modifient pas ; créez une action personnalisée pour une variante.

Exécution en ligne de commandeCopy Anchor Link

Placez le texte après -r ou le chemin après -f. Si PixPin fonctionne déjà, la requête va à l'instance existante ; sinon elle attend l'initialisation.

Windows PowerShell : remplacez le chemin par votre installation :

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

Terminal macOS : ces exemples supposent une installation dans Applications :

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

Le fichier contient uniquement du JavaScript, sans délimiteurs Markdown. Avec du chinois, préférez UTF-8 avec BOM. Pour un script long, -f réduit les problèmes de guillemets, antislashs et échappement de $. Gardez les guillemets autour des chemins contenant des espaces.

Le retour de la commande ne signifie pas que capture, reconnaissance ou enregistrement sont terminés. La dernière expression n'est pas renvoyée comme résultat structuré. Sur macOS, l'automatisation n'affiche pas spontanément les instructions d'autorisation pour la capture interactive : accordez d'abord les permissions d'enregistrement d'écran et d'accessibilité dans l'application.

Syntaxe et exécutionCopy Anchor Link

Le champ accepte JavaScript. Les API et constantes distinguent la casse : écrivez pixpin.screenShot, pas pixpin.screenshot.

L'environnement actuel ne prend pas en charge ?. ou async/await, ni import / export dans les scripts ordinaires. Utilisez if pour les valeurs nulles et les API PixPin pour les opérations par étapes.

Aucun window, document, fetch du navigateur, ni require, process, fs de Node.js ou setTimeout. Ne collez pas d'exemples dépendant du Web, de Node.js ou de paquets tiers. La prise en charge des objets ne permet pas de substituer un objet ordinaire au rectangle d'une API.

Exécution séquentielle sans attendre la sélectionCopy Anchor Link

Les instructions s'exécutent dans l'ordre, mais ouvrir la capture ne fait que la démarrer, sans attendre votre sélection. Pour capturer puis épingler, utilisez pixpin.screenShot(ShotAction.Pin) ; n'enchaînez pas simplement capture et épinglage du presse-papiers sur deux lignes.

Le moteur est réutilisé. Placez les variables temporaires dans des fonctions pour limiter les interactions entre exécutions. Les exemples multilignes utilisent une fonction immédiatement invoquée :

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

Le () final exécute la fonction. Une boucle infinie attendant la capture bloque le fil de l'interface. console.log(...) écrit des journaux, mais l'éditeur n'a pas de console interactive.

Objets globaux, paramètres et retoursCopy Anchor Link

Donnez directement nombres, booléens et chaînes ; les fichiers utilisent un tableau de chaînes. Préférez des chemins absolus. En JavaScript, écrivez D:/Images/example.png ou échappez les antislashs : D:\\Images\\example.png.

Créez les rectangles avec ces trois API et transmettez-les sans modification :

Les coordonnées sont logiques ; largeur et hauteur sont positives. Les coordonnées peuvent être négatives sur plusieurs écrans. Faute de place, genRectUnderCursor réduit proportionnellement la zone. La mise à l'échelle et les réglages d'enregistrement influencent aussi les pixels exportés. Ne transmettez pas {x: 100, y: 100, width: 640, height: 480} : ces champs ne créent pas le rectangle attendu.

true signifie généralement que la requête est acceptée, pas que l'interaction est terminée. Les tableaux précisent chaque retour. Une API sans retour ne permet pas de savoir si l'enregistrement a réussi.

Exemples à adapterCopy Anchor Link

Capturer et copier la fenêtre activeCopy Anchor Link

Placez l'application cible au premier plan, puis déclenchez le raccourci global. La capture est immédiate, sans sélection manuelle.

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

Avec Tester le script, la fenêtre active peut être celle des paramètres. Appliquez l'action et déclenchez-la depuis l'application cible pour vérifier.

Définir une zone puis l'ajusterCopy Anchor Link

Démarrez une capture normale, puis fixez (100, 100) et 640 × 480. La barre d'outils reste disponible pour annoter ou ajuster.

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

Malgré son nom, setScreenShotRectRadius règle le rapport largeur/hauteur, pas les coins arrondis. Retirez la dernière ligne si aucun rapport fixe n'est nécessaire.

Capturer directement avec un nom horodatéCopy Anchor Link

Cet exemple capture l'écran sous le pointeur. Remplacez le dossier avant exécution ; macOS accepte un chemin comme /Users/yourname/Pictures/....

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

L'enregistrement développe les variables temporelles ; voir Variables de chemin et de nom. Un suffixe numérique évite les doublons, sans notification. L'API ne renvoie ni chemin final ni indicateur de réussite.

Épingler plusieurs référencesCopy Anchor Link

Remplacez les chemins du tableau par des fichiers existants. Ajoutez d'autres entrées au même format.

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

Les fichiers absents sont ignorés ; un tableau vide ou sans fichier existant renvoie false. true indique la transmission des fichiers à l'épinglage, sans garantir que tous les formats s'affichent comme images.

Attendre trois secondes puis capturerCopy Anchor Link

Voici la forme la plus simple avec compte à rebours annulable :

pixpin.delayScreenShotWithTips(3);

Pour position et taille, utilisez l'API suivante. Dans l'ordre : secondes, position spécifiée, x, y, taille spécifiée, largeur, hauteur, paramètre réservé, rapport.

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

Basculer un état avec la même actionCopy Anchor Link

Inversez l'état de désactivation : suspendez les autres raccourcis lorsqu'ils sont actifs, puis appuyez encore pour les restaurer.

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

La touche de cette action lève cette suspension explicite, mais reste soumise aux exclusions et aux jeux en plein écran sous Windows.

Référence des API personnaliséesCopy Anchor Link

API d'opérations accessibles aux scripts ordinaires. rect provient d'une API de rectangle, action utilise ShotAction. Les crochets indiquent les paramètres facultatifs et ne se saisissent pas dans le code.

Capture et zonesCopy Anchor Link

Le préfixe pixpin. est omis ; écrivez par exemple pixpin.screenShotAndCopy(). La capture directe avec Edit, ImageEdit, LongShot ou GifShot n'ouvre pas l'éditeur ou l'enregistreur correspondant. Utilisez screenShot(action) ou une API dédiée pour ces interactions.

Délai, capture longue et enregistrementCopy Anchor Link

delayScreenShot utilise le rectangle si hasPos et hasSize sont true. Avec seulement hasSize défini sur true, la taille se place autour du pointeur ; sans taille, la sélection reste manuelle. radius est inutilisé : donnez 0. Un ratio positif fixe le rapport, sinon utilisez -1.

Ces API ouvrent ou contrôlent les fenêtres ; elles n'indiquent pas la fin du défilement ou de l'export vidéo. Poursuivez dans chaque interface.

Épingles et gestion par lotCopy Anchor Link

Commandes système et autres opérationsCopy Anchor Link

runSystem et runSystemSync démarrent directement les programmes sans interpréteur automatique. Tubes, redirections et commandes internes du shell ne s'appliquent pas seuls ; indiquez explicitement l'interpréteur de la plateforme. La commande ne peut être vide.

Pour la calculatrice, Windows peut utiliser pixpin.runSystem("calc") et macOS pixpin.runSystem("/usr/bin/open -a Calculator"). Exemple de lecture synchrone ci-dessous ; utilisez un programme existant sur votre système.

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

L'attente synchrone bloque temporairement l'interface. La limite actuelle est d'environ 30 secondes, sans champ distinct de dépassement ; code seul ne prouve pas un démarrage correct. Utilisez runSystem pour revenir aussitôt.

Constantes de zone et d'actionCopy Anchor Link

PixConst : où capturerCopy Anchor Link

La zone dépend des fenêtres, du pointeur et de l'historique au moment de l'exécution. Sans fenêtre ou historique valide, ne supposez pas obtenir une zone utilisable.

ShotAction : après la sélectionCopy Anchor Link

Ajoutez ShotAction., par exemple ShotAction.QuickSave.

Les constantes choisissent une fonction sans changer ses conditions. Copie, enregistrement et reconnaissance restent soumis aux réglages et aux fenêtres interactives.

DépannageCopy Anchor Link

try / catch intercepte les erreurs, mais false ou l'absence de retour ne déclenchent pas automatiquement une exception. Testez une opération puis ajoutez paramètres et combinaisons. Aucune erreur ne signifie pas que tous les résultats sont terminés.

Articles associésCopy Anchor Link