Skripte

PixPin-Skripte rufen mit JavaScript Aufnahme-, Pin- und Fensterfunktionen auf. Speichern Sie wiederholte Schritte als Aktion und starten Sie diese per Taste, Tray-Menü oder Befehlszeile. Skripte ist ein Handbuchkapitel; der Editor liegt unter Konfiguration → Tastenkombinationen/Aktionen.

Geeignete AufgabenCopy Anchor Link

Für Tasten, Tray-Einträge oder Ausnahmen genügt Tastenkombinationen/Aktionen. Skripte eignen sich für kombinierte Abläufe und bestimmte Parameter.

Erstes Skript erstellen und ausführenCopy Anchor Link

pixpin.screenShot(ShotAction.Pin);

Tests führen wirklich aus. Eine andere Vorlage überschreibt den Editor; Abbrechen macht getestete Vorgänge nicht rückgängig. Integrierte Skripte sind gesperrt; erstellen Sie für Varianten eine eigene Aktion.

Per Befehlszeile ausführenCopy Anchor Link

Nach -r folgt Text, nach -f ein Skriptpfad. Eine laufende Instanz erhält die Anfrage; beim ersten Start wartet die Ausführung auf die Initialisierung.

Windows PowerShell: Ersetzen Sie den Programmpfad durch Ihren Installationsort:

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

macOS-Terminal: Die Beispiele gehen von einer Installation im Programme-Ordner aus:

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

Die Datei enthält nur JavaScript ohne Markdown-Begrenzer. Bei chinesischen Zeichen wird UTF-8 mit BOM empfohlen. Für lange Skripte reduziert -f Probleme mit Anführungszeichen, Backslashes und $. Pfade mit Leerzeichen bleiben in Anführungszeichen.

Die Rückkehr des Befehls bedeutet nicht, dass Aufnahme, Erkennung oder Speichern abgeschlossen sind. Der Wert des letzten Ausdrucks wird nicht strukturiert zurückgegeben. Automatisierte macOS-Aufrufe zeigen für interaktive Aufnahmen keine Berechtigungsanleitung; erlauben Sie Bildschirmaufnahme und Bedienungshilfen vorher in der App.

Syntax und AusführungCopy Anchor Link

Das Feld akzeptiert JavaScript. API- und Konstantennamen unterscheiden Groß-/Kleinschreibung: pixpin.screenShot, nicht pixpin.screenshot.

Die aktuelle Umgebung unterstützt weder ?. noch async/await und in normalen Skripten kein import / export. Verwenden Sie if für Nullprüfungen und PixPin-APIs für mehrstufige Abläufe.

Browserobjekte window, document, fetch, Node.js-Objekte require, process, fs und setTimeout fehlen. Übernehmen Sie keine Beispiele mit Web-, Node.js- oder Paketabhängigkeiten. Ein normales Objekt ersetzt auch nicht das von einer API verlangte Rechteck.

Reihenfolge wartet nicht auf HandbedienungCopy Anchor Link

Anweisungen laufen nacheinander, das Öffnen der Aufnahme startet sie aber nur und wartet nicht auf Ihre Auswahl. Für Aufnahme mit Anheften verwenden Sie pixpin.screenShot(ShotAction.Pin) statt zweier aufeinanderfolgender Aufrufe für Aufnahme und Zwischenablage-Pin.

Die Engine wird wiederverwendet. Halten Sie temporäre Variablen in Funktionen, um Einflüsse zwischen Läufen zu vermeiden. Mehrzeilige Beispiele verwenden sofort ausgeführte Funktionen:

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

Das abschließende () führt sofort aus. Eine Endlosschleife zum Warten blockiert den UI-Thread. console.log(...) schreibt Protokolle, der Editor hat aber keine interaktive Konsole.

Globale Objekte, Parameter und RückgabenCopy Anchor Link

Zahlen, boolesche Werte und Strings direkt angeben, Dateilisten als String-Array. Absolute Pfade werden empfohlen: D:/Images/example.png oder mit maskierten Backslashes D:\\Images\\example.png.

Erzeugen Sie Rechtecke mit diesen drei APIs und reichen Sie sie unverändert weiter:

Es gelten logische Bildschirmkoordinaten mit positiver Breite und Höhe. Bei mehreren Bildschirmen sind negative Koordinaten möglich. Bei Platzmangel verkleinert genRectUnderCursor proportional. Anzeigeskalierung und Speicheroptionen beeinflussen die ausgegebenen Pixel. Übergeben Sie nicht {x: 100, y: 100, width: 640, height: 480}; daraus entsteht kein gültiger Aufnahmebereich.

true bedeutet meist Annahme der Anfrage, nicht abgeschlossene Bedienung. Die Tabellen erläutern die Rückgaben. APIs ohne Rückgabe erlauben keine Erfolgskontrolle des Speicherns.

Anpassbare BeispieleCopy Anchor Link

Aktives Fenster aufnehmen und kopierenCopy Anchor Link

Bringen Sie das Zielprogramm nach vorn und starten Sie per globaler Kombination. Die Aufnahme erfolgt sofort ohne Auswahl.

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

Bei Skript testen kann das Einstellungsfenster aktiv sein. Wenden Sie die Aktion an und testen Sie aus dem Zielprogramm.

Bereich vorgeben und manuell anpassenCopy Anchor Link

Starten Sie die normale Aufnahme und setzen Sie (100, 100) mit 640 × 480. Markierungen und Bereichsanpassung bleiben möglich.

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

setScreenShotRectRadius setzt trotz des Namens das Seitenverhältnis, nicht den Eckenradius. Entfernen Sie die letzte Zeile ohne festes Verhältnis.

Direkt aufnehmen und mit Zeitstempel speichernCopy Anchor Link

Das Beispiel erfasst den Bildschirm am Zeiger. Ändern Sie vorher den Speicherpfad; macOS erlaubt etwa /Users/yourname/Pictures/....

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

Die Speicherfunktion ersetzt Zeitvariablen; siehe Pfad- und Dateinamenvariablen. Doppelte Namen erhalten Nummern, ohne Speicherbenachrichtigung. Weder Pfad noch Erfolgskennzeichen werden zurückgegeben.

Mehrere Referenzdateien anheftenCopy Anchor Link

Ersetzen Sie die Array-Pfade durch vorhandene Dateien und ergänzen Sie bei Bedarf weitere Einträge.

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

Fehlende Dateien werden übersprungen; ein leeres Array oder keine vorhandenen Pfade ergibt false. true bedeutet Übergabe an die Pin-Funktion, nicht Bilddarstellung jedes Formats.

Drei Sekunden warten und aufnehmenCopy Anchor Link

Die einfachste Form mit abbrechbarem Countdown:

pixpin.delayScreenShotWithTips(3);

Für Position und Größe folgt diese API. Reihenfolge: Sekunden, Position vorgegeben, x, y, Größe vorgegeben, Breite, Höhe, reservierter Parameter, Seitenverhältnis.

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

Zustand mit derselben Aktion umschaltenCopy Anchor Link

Kehren Sie den Deaktivierungszustand um: laufende globale Tasten pausieren und beim nächsten Drücken wieder aktivieren.

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

Diese Aktion kann die ausdrückliche Pause aufheben; Ausnahmen und Windows-Vollbildspiele gelten weiterhin.

API-ÜbersichtCopy Anchor Link

Nutzeroperationen für normale Aktionsskripte. rect stammt aus einer Rechteck-API, action aus ShotAction. Eckige Klammern markieren optionale Parameter und gehören nicht in den Code.

Aufnahme und BereicheCopy Anchor Link

Die Tabelle lässt pixpin. weg; schreiben Sie etwa pixpin.screenShotAndCopy(). Direktaufnahme mit Edit, ImageEdit, LongShot oder GifShot öffnet nicht den jeweiligen Editor oder Recorder. Nutzen Sie screenShot(action) oder passende Spezial-APIs.

Verzögerung, lange Screenshots und AufnahmeCopy Anchor Link

Bei delayScreenShot wird das feste Rechteck verwendet, wenn hasPos und hasSize beide true sind. Ist nur hasSize auf true gesetzt, entsteht die angegebene Größe am Zeiger; ohne Größe bleibt die Auswahl manuell. radius ist ungenutzt: 0. Ein positiver ratio fixiert das Verhältnis, sonst -1.

Diese APIs öffnen oder steuern Fenster und bestätigen weder beendetes Scrollen noch Videoexport. Die weiteren Schritte erfolgen in der jeweiligen Oberfläche.

Pins und StapelverwaltungCopy Anchor Link

Systembefehle und weitere FunktionenCopy Anchor Link

runSystem und runSystemSync starten direkt ohne automatischen Interpreter. Pipes, Umleitung und Shell-Befehle wirken nicht von selbst; geben Sie nötigenfalls den Systeminterpreter an. Der String darf nicht leer sein.

Für den Rechner kann Windows pixpin.runSystem("calc"), macOS pixpin.runSystem("/usr/bin/open -a Calculator") verwenden. Unten folgt die synchrone Auswertung; wählen Sie ein vorhandenes Programm.

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

Synchrones Warten blockiert vorübergehend die Oberfläche. Die aktuelle Grenze liegt bei etwa 30 Sekunden, ohne eigenes Timeout-Feld. code allein beweist keinen korrekten Prozessstart. Für sofortige Rückkehr nutzen Sie runSystem.

Bereichs- und AktionskonstantenCopy Anchor Link

PixConst: AufnahmeortCopy Anchor Link

Bereiche hängen von Fenstern, Zeiger und Verlauf bei Ausführung ab. Ohne gültige Fenster oder Historie ist kein verwendbarer Bereich garantiert.

ShotAction: nach der AuswahlCopy Anchor Link

Verwenden Sie ShotAction., etwa ShotAction.QuickSave.

Konstanten wählen vorhandene Funktionen, ohne Bedingungen zu ändern. Kopieren, Speichern und Erkennung bleiben von Einstellungen und Dialogen abhängig.

FehlersucheCopy Anchor Link

try / catch fängt Fehler, aber false und fehlende Rückgaben sind keine automatischen Ausnahmen. Testen Sie erst eine Operation, ergänzen Sie dann Parameter und Kombinationen. Fehlerfreiheit beweist keine abgeschlossenen Ergebnisse.

Verwandte ArtikelCopy Anchor Link