스크립트

PixPin 스크립트는 JavaScript로 스크린샷, 핀, 창 작업을 호출합니다. 반복 단계를 동작으로 저장해 단축키, 트레이 메뉴, 명령줄로 실행할 수 있습니다. 스크립트는 설명서의 장이며 앱의 편집 위치는 설정 → 단축키/작업입니다.

스크립트가 유용한 경우Copy Anchor Link

키 변경, 트레이 조정, 프로그램 제외만 필요하면 단축키/동작 설정을 쓰세요. 스크립트는 작업 조합이나 매개변수 지정에 적합합니다.

첫 스크립트 만들고 실행하기Copy Anchor Link

pixpin.screenShot(ShotAction.Pin);

테스트는 실제 실행입니다. 다른 프리셋은 편집 내용을 덮어쓰며 창을 취소해도 테스트한 작업은 되돌리지 않습니다. 기본 동작 스크립트는 수정할 수 없으므로 변형은 사용자 동작으로 만드세요.

명령줄로 실행Copy Anchor Link

-r 뒤에는 스크립트, -f 뒤에는 파일 경로를 둡니다. 실행 중이면 기존 인스턴스로 전달하고 처음 시작할 때는 초기화 후 실행합니다.

Windows PowerShell: 실제 설치 경로로 바꾸세요.

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

macOS 터미널: 응용 프로그램 폴더에 설치한 예입니다.

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

파일에는 코드 블록 표시 없이 JavaScript만 작성하세요. 중국어가 있다면 BOM 포함 UTF-8을 권장합니다. 긴 스크립트는 -f로 따옴표, 역슬래시, $ 이스케이프를 줄이세요. 공백 경로의 바깥 따옴표는 유지합니다.

명령줄이 반환되어도 캡처, 인식, 저장의 완료를 뜻하지 않습니다. 마지막 식의 값을 구조화된 결과로 반환하지도 않습니다. macOS 자동화 호출은 대화형 캡처 권한 안내를 먼저 띄우지 않으므로 앱에서 화면 기록과 손쉬운 사용 권한을 먼저 허용하세요.

지원 문법과 실행Copy Anchor Link

JavaScript를 사용하며 API와 상수는 대소문자를 구분합니다. pixpin.screenShot을 pixpin.screenshot으로 바꾸면 안 됩니다.

현재 환경은 선택적 연결 ?.과 async/await를 지원하지 않으며 일반 스크립트에서 import / export도 쓸 수 없습니다. 빈 값은 if로 검사하고 단계 작업은 PixPin API를 사용하세요.

브라우저의 window, document, fetch나 Node.js의 require, process, fs가 없고 setTimeout도 없습니다. 웹, Node.js, 외부 패키지에 의존하는 예제를 그대로 붙이지 마세요. 객체 지원이 일반 객체로 API의 사각형을 대체할 수 있다는 뜻은 아닙니다.

순차 실행은 수동 작업을 기다리지 않음Copy Anchor Link

문장은 순서대로 실행되지만 캡처 창 호출은 시작만 하고 선택 완료를 기다리지 않습니다. 캡처 후 고정하려면 pixpin.screenShot(ShotAction.Pin)을 쓰세요. 캡처 시작과 클립보드 고정을 단순히 두 줄로 나열하지 마세요.

엔진은 재사용됩니다. 여러 실행의 간섭을 줄이도록 임시 변수는 함수에 두세요. 여러 줄 예제는 즉시 실행 함수를 사용합니다.

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

마지막 ()는 즉시 실행을 뜻합니다. 무한 루프로 캡처를 기다리면 UI 실행 스레드를 막습니다. console.log(...)로 로그를 남길 수 있지만 편집기에 대화형 콘솔은 없습니다.

전역 객체, 인수, 반환값Copy Anchor Link

숫자, 불리언, 문자열은 직접 넣고 파일 목록은 문자열 배열로 만드세요. 절대 경로를 권장합니다. JavaScript에서는 D:/Images/example.png 또는 역슬래시를 이스케이프한 D:\\Images\\example.png를 쓰세요.

사각형은 다음 세 API로 만들고 그대로 후속 API에 전달하세요.

화면 논리 좌표를 쓰며 너비와 높이는 양수여야 합니다. 다중 화면 좌표는 음수일 수 있습니다. 공간이 부족하면 genRectUnderCursor가 비율을 유지해 줄입니다. 출력 픽셀 크기는 화면 배율과 저장 설정도 영향을 줍니다. 사각형 API에 {x: 100, y: 100, width: 640, height: 480}를 직접 넘겨도 이 필드로 캡처 영역을 만들지 않습니다.

true는 보통 요청 수락이며 사용자 조작 완료가 아닙니다. 반환 의미는 아래 API 표를 보세요. 반환값이 없으면 저장 성공 여부를 판단할 수 없습니다.

수정해 쓸 수 있는 예제Copy Anchor Link

활성 창 캡처 후 복사Copy Anchor Link

대상 앱을 앞에 두고 전역 단축키로 실행하세요. 수동 영역 선택 없이 바로 캡처합니다.

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

편집기의 스크립트 테스트 때는 설정 창이 활성 창일 수 있습니다. 적용 후 대상 앱에서 실행해 확인하세요.

영역 지정 후 수동 미세 조정Copy Anchor Link

일반 캡처를 시작하고 (100, 100) 위치에 640 × 480 크기를 설정합니다. 도구 모음으로 주석이나 영역을 조정할 수 있습니다.

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

setScreenShotRectRadius는 이름과 달리 모서리 반경이 아닌 종횡비를 설정합니다. 고정 비율이 필요 없으면 마지막 줄을 지우세요.

직접 캡처해 시간 이름으로 저장Copy Anchor Link

포인터가 있는 화면을 직접 캡처합니다. 실행 전에 경로를 바꾸세요. macOS는 /Users/yourname/Pictures/... 같은 경로를 사용합니다.

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

시간 변수는 저장 기능이 확장합니다. 경로와 파일명 변수를 보세요. 중복 이름에는 숫자를 붙이고 저장 알림은 표시하지 않습니다. 저장 경로나 성공 표시는 반환하지 않습니다.

참고 파일 여러 개 한 번에 고정Copy Anchor Link

배열의 경로를 실제 파일로 바꾸세요. 같은 형식으로 항목을 늘릴 수 있습니다.

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

없는 파일은 건너뛰고 빈 배열이나 모든 경로가 없으면 false입니다. true는 기존 파일을 핀 기능에 전달했다는 뜻이며 모든 형식의 이미지 표시를 보장하지 않습니다.

3초 후 캡처Copy Anchor Link

취소 가능한 카운트다운을 쓰는 가장 간단한 형식입니다.

pixpin.delayScreenShotWithTips(3);

위치와 크기가 필요하면 아래 API를 씁니다. 왼쪽부터 초, 위치 지정 여부, x, y, 크기 지정 여부, 너비, 높이, 예약 인수, 종횡비입니다.

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

같은 동작으로 상태 전환Copy Anchor Link

현재 비활성 상태를 반전합니다. 활성 상태에서 다른 전역 키를 멈추고 다시 누르면 복구합니다.

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

이 동작의 키는 명시적 중지를 해제할 수 있지만 제외 목록과 Windows 전체 화면 게임 제한은 따릅니다.

사용자 API 참조Copy Anchor Link

일반 동작 스크립트에서 쓸 수 있는 사용자 작업 API입니다. rect는 사각형 생성 API의 결과, action은 ShotAction입니다. 대괄호는 생략 가능한 인수이며 실제 코드에는 쓰지 않습니다.

캡처와 영역Copy Anchor Link

표는 pixpin.을 생략합니다. 실제로는 pixpin.screenShotAndCopy()처럼 씁니다. 직접 캡처에 Edit, ImageEdit, LongShot, GifShot를 넣어도 편집/녹화 창을 열지 않습니다. 해당 작업은 screenShot(action)이나 전용 API를 쓰세요.

지연, 긴 스크린샷, 화면 녹화Copy Anchor Link

delayScreenShot은 hasPos와 hasSize 모두 true면 지정 사각형을 씁니다. hasSize만 true이면 포인터 기준 크기를 만들고 크기를 지정하지 않으면 수동 선택합니다. radius는 미사용이므로 0, 양수 ratio는 종횡비이며 불필요하면 -1입니다.

이 API들은 창을 열거나 제어하며 자동 스크롤이나 영상 내보내기 완료를 뜻하지 않습니다. 후속 작업은 각 화면에서 수행하세요.

핀과 일괄 관리Copy Anchor Link

시스템 명령과 기타 작업Copy Anchor Link

runSystem과 runSystemSync는 셸을 자동으로 거치지 않고 직접 실행합니다. 파이프, 리디렉션, 셸 내장 명령은 자동 적용되지 않으므로 필요하면 플랫폼의 해석기를 명시하세요. 명령은 비울 수 없습니다.

계산기는 Windows에서 pixpin.runSystem("calc"), macOS에서 pixpin.runSystem("/usr/bin/open -a Calculator")로 열 수 있습니다. 아래는 동기 결과 예이며 실제 있는 프로그램으로 바꾸세요.

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

동기 대기는 PixPin UI를 잠시 막습니다. 기본 대기 상한은 약 30초이고 별도 시간 초과 필드가 없으며 code만으로 정상 시작을 판단할 수 없습니다. 즉시 돌아오려면 runSystem을 쓰세요.

영역과 동작 상수Copy Anchor Link

PixConst: 캡처할 위치Copy Anchor Link

영역은 실행 시점의 창, 포인터, 기록에 달립니다. 유효한 창이나 기록이 없으면 쓸 수 있는 영역을 얻는다고 가정하지 마세요.

ShotAction: 선택 후 작업Copy Anchor Link

ShotAction.QuickSave처럼 ShotAction. 접두사를 붙입니다.

상수는 기존 기능을 선택하며 실행 조건을 바꾸지 않습니다. 복사, 저장, 인식은 기존 설정이나 대화형 창의 영향을 받습니다.

오류 확인Copy Anchor Link

오류는 try / catch로 잡을 수 있지만 false나 반환값 없음은 자동 예외가 아닙니다. 하나의 작업부터 확인하고 인수와 조합을 늘리세요. 오류가 없다고 모든 작업이 완료된 것은 아닙니다.

관련 문서Copy Anchor Link