Scripts

Los scripts de PixPin usan JavaScript para capturar, anclar y operar ventanas. Guarda pasos repetidos como acción y ejecútala con atajo, menú o línea de comandos. Scripts es un capítulo del manual; el editor está en Configuración → Atajos/Acciones.

Cuándo usar scriptsCopy Anchor Link

Para cambiar teclas, menú o exclusiones basta Atajos/acciones. Los scripts sirven para combinar operaciones o especificar parámetros.

Crear y ejecutar el primer scriptCopy Anchor Link

pixpin.screenShot(ShotAction.Pin);

La prueba ejecuta realmente. Otro preajuste sobrescribe el contenido y cancelar no revierte lo probado. Los scripts integrados no se editan; crea una acción personalizada para una variante.

Ejecutar desde comandosCopy Anchor Link

Pon el texto tras -r y la ruta tras -f. Si PixPin está abierto, recibe la instancia existente; al arrancar espera a la inicialización.

Windows PowerShell: sustituye la ruta por tu instalación:

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

Terminal macOS: se supone instalado en Aplicaciones:

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

El archivo solo contiene JavaScript, sin delimitadores Markdown. Con chino se recomienda UTF-8 con BOM. Para scripts largos, -f reduce problemas con comillas, barras inversas y $. Mantén comillas alrededor de rutas con espacios.

El retorno del comando no implica fin de captura, reconocimiento o guardado. Tampoco devuelve la última expresión como resultado estructurado. La automatización de macOS no abre por sí sola la guía de permisos para captura interactiva; concede antes grabación de pantalla y accesibilidad dentro de la aplicación.

Sintaxis y ejecuciónCopy Anchor Link

El campo acepta JavaScript. API y constantes distinguen mayúsculas: usa pixpin.screenShot, no pixpin.screenshot.

El entorno actual no admite ?. ni async/await, ni import / export en scripts normales. Usa if para comprobar valores nulos y las API PixPin para operaciones por etapas.

No incluye window, document, fetch del navegador, require, process, fs de Node.js ni setTimeout. No pegues ejemplos dependientes de web, Node.js o paquetes externos. Admitir objetos no permite sustituir el rectángulo de una API por un objeto corriente.

Ejecución secuencial sin esperar la selecciónCopy Anchor Link

Las instrucciones se ejecutan en orden, pero abrir captura solo la inicia y no espera tu selección. Para capturar y anclar usa pixpin.screenShot(ShotAction.Pin), no dos líneas de captura y anclado del portapapeles.

El motor se reutiliza. Usa variables temporales dentro de funciones para evitar interferencias entre ejecuciones. Los ejemplos multilínea usan una función autoejecutable:

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

El () final la ejecuta. Un bucle infinito de espera bloquea el hilo de interfaz. console.log(...) genera registros, pero el editor no tiene consola interactiva.

Objetos globales, parámetros y retornosCopy Anchor Link

Introduce números, booleanos y cadenas directamente y listas de archivos como arrays de cadenas. Se recomiendan rutas absolutas: D:/Images/example.png o, escapando barras, D:\\Images\\example.png.

Genera los rectángulos con estas tres API y pásalos sin modificar:

Son coordenadas lógicas, con ancho y alto positivos. Puede haber valores negativos en varias pantallas. Si falta espacio, genRectUnderCursor reduce proporcionalmente. La escala de pantalla y los ajustes de guardado también afectan a los píxeles exportados. No pases {x: 100, y: 100, width: 640, height: 480}: esos campos no crean el rectángulo requerido.

true suele indicar aceptación, no fin de la interacción. Consulta los retornos en las tablas. Una API sin retorno no permite comprobar el éxito del guardado.

Ejemplos adaptablesCopy Anchor Link

Capturar y copiar la ventana activaCopy Anchor Link

Pon la aplicación objetivo delante y activa el atajo global. Captura al instante sin selección manual.

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

Con Probar script, la ventana activa puede ser la de configuración. Aplica la acción y pruébala desde la aplicación objetivo.

Fijar la selección y ajustarlaCopy Anchor Link

Inicia una captura normal y fija (100, 100) y 640 × 480. Puedes seguir anotando o ajustando en la barra.

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

setScreenShotRectRadius configura la relación de aspecto, no las esquinas. Borra la última línea si no quieres fijarla.

Captura directa con nombre temporalCopy Anchor Link

Captura la pantalla del puntero. Cambia antes la carpeta; en macOS usa, por ejemplo, /Users/yourname/Pictures/....

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

El guardado expande las variables de fecha; consulta Variables de ruta y nombre. Añade números a nombres duplicados sin notificación. No devuelve ruta final ni indicador de éxito.

Anclar varias referenciasCopy Anchor Link

Sustituye las rutas del array por archivos existentes y añade entradas con el mismo formato.

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

Ignora archivos ausentes; un array vacío o sin rutas existentes devuelve false. true indica entrega al sistema de pins, no que todo formato se vea como imagen.

Esperar tres segundos y capturarCopy Anchor Link

La forma más sencilla con cuenta atrás cancelable:

pixpin.delayScreenShotWithTips(3);

Para posición y tamaño usa esta API. Orden: segundos, especificar posición, x, y, especificar tamaño, ancho, alto, parámetro reservado y proporción.

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

Alternar el estado con la misma acciónCopy Anchor Link

Invierte el estado de desactivación: suspende los otros atajos activos y púlsalo de nuevo para restaurarlos.

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

La tecla de esta acción puede revertir esa suspensión explícita, pero sigue sujeta a exclusiones y juegos a pantalla completa de Windows.

Referencia de API personalizadasCopy Anchor Link

Operaciones para scripts normales. rect procede de una API de rectángulos y action usa ShotAction. Los corchetes indican parámetros opcionales y no se escriben en el código.

Captura y zonasCopy Anchor Link

La tabla omite pixpin.; escribe, por ejemplo, pixpin.screenShotAndCopy(). La captura directa con Edit, ImageEdit, LongShot o GifShot no abre el editor o grabador correspondiente. Usa screenShot(action) o API específicas.

Retardo, captura larga y grabaciónCopy Anchor Link

delayScreenShot usa el rectángulo si hasPos y hasSize son true; si solo hasSize es true, crea el tamaño alrededor del puntero, y sin tamaño se selecciona a mano. radius no se usa: pon 0. Un ratio positivo fija la proporción; si no, -1.

Estas API abren o controlan ventanas; no indican fin del desplazamiento ni exportación de vídeo. Continúa en cada interfaz.

Pins y gestión por lotesCopy Anchor Link

Comandos y otras operacionesCopy Anchor Link

runSystem y runSystemSync ejecutan directamente sin intérprete automático. Las tuberías, redirecciones y órdenes internas no funcionan solas; especifica el intérprete del sistema si lo necesitas. La cadena no puede estar vacía.

La calculadora puede abrirse con pixpin.runSystem("calc") en Windows o pixpin.runSystem("/usr/bin/open -a Calculator") en macOS. El ejemplo consulta el resultado síncrono; usa un programa existente.

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

La espera síncrona bloquea temporalmente la interfaz. El límite actual ronda 30 segundos, sin campo de tiempo agotado, y code no prueba un inicio correcto. Usa runSystem para volver al instante.

Constantes de área y acciónCopy Anchor Link

PixConst: dónde capturarCopy Anchor Link

Depende de ventanas, puntero e historial al ejecutar. Sin ventana o historial válido no supongas que habrá una zona utilizable.

ShotAction: después de seleccionarCopy Anchor Link

Añade ShotAction., como ShotAction.QuickSave.

Las constantes eligen funciones sin cambiar sus condiciones. Copiar, guardar y reconocer siguen sujetos a ajustes y ventanas interactivas.

DiagnósticoCopy Anchor Link

try / catch captura errores, pero false y ausencia de retorno no generan excepciones automáticamente. Prueba una operación y añade después parámetros y combinaciones. La ausencia de errores no prueba que todo haya terminado.

Artículos relacionadosCopy Anchor Link